pict-section-form 1.0.122 → 1.0.124

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

@@ -6,6 +6,10 @@ const libPackage = require('../../package.json');
 /** @type {Record<string, any>} */
 const _DefaultConfiguration = require('./Pict-View-DynamicForm-DefaultConfiguration.json');
 
+const PENDING_ASYNC_OPERATION_TYPE = 'PendingAsyncOperation';
+const TRANSACTION_COMPLETE_CALLBACK_TYPE = 'onTransactionComplete';
+const READY_TO_FINALIZE_TYPE = 'ReadyToFinalize';
+
 /**
  * Represents a dynamic form view for the Pict application.
  *
@@ -64,7 +68,8 @@ class PictViewDynamicForm extends libPictViewClass
 		}
 
 		// Use this to manage transactions
-		this.transactionTracking = this.pict.newTransactionTracker();
+		//FIXME: should we have these sioled??
+		//this.transactionTracking = this.pict.newTransactionTracker();
 
 		/** @type {Record<string, any>} */
 		this._PackagePictView = this._Package;
@@ -172,11 +177,13 @@ class PictViewDynamicForm extends libPictViewClass
 				let tmpValue = this.sectionManifest.getValueByHash(tmpMarshalDestinationObject, tmpHashAddress);
 
 				let tmpInputProviderList = this.getInputProviderList(tmpInput);
+				const tmpTransactionGUID = this.fable.getUUID();
+				this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 				for (let i = 0; i < tmpInputProviderList.length; i++)
 				{
 					if (this.pict.providers[tmpInputProviderList[i]])
 					{
-						this.pict.providers[tmpInputProviderList[i]].onDataChange(this, tmpInput, tmpValue, tmpInput.Macro.HTMLSelector);
+						this.pict.providers[tmpInputProviderList[i]].onDataChange(this, tmpInput, tmpValue, tmpInput.Macro.HTMLSelector, tmpTransactionGUID);
 					}
 					else
 					{
@@ -233,11 +240,13 @@ class PictViewDynamicForm extends libPictViewClass
 				// Each row has a distinct address!
 				let tmpVirtualInformaryHTMLSelector = tmpInput.Macro.HTMLSelectorTabular + `[data-i-index="${pRowIndex}"]`;
 				let tmpInputProviderList = this.getInputProviderList(tmpInput);
+				const tmpTransactionGUID = this.fable.getUUID();
+				this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 				for (let i = 0; i < tmpInputProviderList.length; i++)
 				{
 					if (this.pict.providers[tmpInputProviderList[i]])
 					{
-						this.pict.providers[tmpInputProviderList[i]].onDataChangeTabular(this, tmpInput, tmpValue, tmpVirtualInformaryHTMLSelector, pRowIndex);
+						this.pict.providers[tmpInputProviderList[i]].onDataChangeTabular(this, tmpInput, tmpValue, tmpVirtualInformaryHTMLSelector, pRowIndex, tmpTransactionGUID);
 					}
 					else
 					{
@@ -263,6 +272,8 @@ class PictViewDynamicForm extends libPictViewClass
 	/**
 	 * Sets the data in a specific form input based on the provided input object
 	 *
+	 * FIXME: does this need to have a transaction GUID passed in?
+	 *
 	 * @param {object} pInput - The input object.
 	 * @param {any} pValue - The value to set.
 	 * @returns {boolean} Returns true if the data was set successfully, false otherwise.
@@ -278,17 +289,20 @@ class PictViewDynamicForm extends libPictViewClass
 			// Each row has a distinct address!
 			let tmpVirtualInformaryHTMLSelector = pInput.Macro.HTMLSelector;
 			let tmpInputProviderList = this.getInputProviderList(pInput);
+			const tmpTransactionGUID = this.fable.getUUID();
+			this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 			for (let i = 0; i < tmpInputProviderList.length; i++)
 			{
 				if (this.pict.providers[tmpInputProviderList[i]])
 				{
-					this.pict.providers[tmpInputProviderList[i]].onDataChange(this, pInput, tmpValue, tmpVirtualInformaryHTMLSelector);
+					this.pict.providers[tmpInputProviderList[i]].onDataChange(this, pInput, tmpValue, tmpVirtualInformaryHTMLSelector, tmpTransactionGUID);
 				}
 				else
 				{
 					this.log.error(`Dynamic form setDataByInput [${this.Hash}]::[${this.UUID}] cannot find provider [${tmpInputProviderList[i]}] for input [${pInput.Hash}].`);
 				}
 			}
+			this.finalizeTransaction(tmpTransactionGUID);
 		}
 		catch (pError)
 		{
@@ -301,6 +315,8 @@ class PictViewDynamicForm extends libPictViewClass
 	/**
 	 * Sets the data in a specific tabular form input based on the provided hash, group and row.
 	 *
+	 * FIXME: does this need to have a transaction GUID passed in?
+	 *
 	 * @param {number} pGroupIndex - The index of the group.
 	 * @param {string} pInputHash - The hash of the input.
 	 * @param {number} pRowIndex - The index of the row.
@@ -353,17 +369,20 @@ class PictViewDynamicForm extends libPictViewClass
 				// Each row has a distinct address!
 				let tmpVirtualInformaryHTMLSelector = tmpInput.Macro.HTMLSelectorTabular + `[data-i-index="${pRowIndex}"]`;
 				let tmpInputProviderList = this.getInputProviderList(tmpInput);
+				const tmpTransactionGUID = this.fable.getUUID();
+				this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 				for (let i = 0; i < tmpInputProviderList.length; i++)
 				{
 					if (this.pict.providers[tmpInputProviderList[i]])
 					{
-						this.pict.providers[tmpInputProviderList[i]].onDataChangeTabular(this, tmpInput, tmpValue, tmpVirtualInformaryHTMLSelector, pRowIndex);
+						this.pict.providers[tmpInputProviderList[i]].onDataChangeTabular(this, tmpInput, tmpValue, tmpVirtualInformaryHTMLSelector, pRowIndex, tmpTransactionGUID);
 					}
 					else
 					{
 						this.log.error(`Dynamic form setDataTabularByHash [${this.Hash}]::[${this.UUID}] cannot find provider [${tmpInputProviderList[i]}] for input [${tmpInput.Hash}] row ${pRowIndex}.`);
 					}
 				}
+				this.finalizeTransaction(tmpTransactionGUID);
 			}
 			catch (pError)
 			{
@@ -428,7 +447,7 @@ class PictViewDynamicForm extends libPictViewClass
 		try
 		{
 			let tmpTransactionGUID = this.fable.getUUID();
-			this.transactionTracking.registerTransaction(tmpTransactionGUID);
+			this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 			let tmpMarshalDestinationObject = this.getMarshalDestinationObject();
 			// TODO: Add optional transaction awareness to informary
 			this.pict.providers.Informary.marshalDataToForm(tmpMarshalDestinationObject, this.formID, this.sectionManifest);
@@ -447,7 +466,7 @@ class PictViewDynamicForm extends libPictViewClass
 		try
 		{
 			let tmpTransactionGUID = (typeof(pTransactionGUID) == 'string') ? pTransactionGUID : this.fable.getUUID();
-			this.transactionTracking.registerTransaction(tmpTransactionGUID);
+			this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 			this.pict.providers.Informary.manualMarshalDataToFormByInput(pInput);
 			this.runLayoutProviderFunctions('onDataMarshalToForm', tmpTransactionGUID);
 			this.runInputProviderFunctions('onDataMarshalToForm', pInput.Hash, null, tmpTransactionGUID);
@@ -463,7 +482,7 @@ class PictViewDynamicForm extends libPictViewClass
 		try
 		{
 			let tmpTransactionGUID = (typeof(pTransactionGUID) == 'string') ? pTransactionGUID : this.fable.getUUID();
-			this.transactionTracking.registerTransaction(tmpTransactionGUID);
+			this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 			this.pict.providers.Informary.manualMarshalTabularDataToFormByInput(pInput, pRowIndex);
 			this.runLayoutProviderFunctions('onDataMarshalToForm', tmpTransactionGUID);
 			this.runInputProviderFunctions('onDataMarshalToForm', pInput.Hash, pRowIndex, tmpTransactionGUID);
@@ -502,7 +521,7 @@ class PictViewDynamicForm extends libPictViewClass
 		try
 		{
 			let tmpTransactionGUID = this.fable.getUUID();
-			this.transactionTracking.registerTransaction(tmpTransactionGUID);
+			this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 			this.runInputProviderFunctions('onAfterMarshalToForm', null, null, tmpTransactionGUID);
 
 		}
@@ -588,7 +607,7 @@ class PictViewDynamicForm extends libPictViewClass
 	onAfterRender(pRenderable)
 	{
 		let tmpTransactionGUID = this.fable.getUUID();
-		this.transactionTracking.registerTransaction(tmpTransactionGUID);
+		this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 
 		this.runLayoutProviderFunctions('onGroupLayoutInitialize', tmpTransactionGUID);
 		this.runInputProviderFunctions('onInputInitialize', null, null, tmpTransactionGUID);
@@ -614,7 +633,7 @@ class PictViewDynamicForm extends libPictViewClass
 	runLayoutProviderFunctions(pFunctionName, pTransactionGUID)
 	{
 		const tmpTransactionGUID = (typeof(pTransactionGUID) === 'string') ? pTransactionGUID : this.fable.getUUID();
-		const tmpTransaction = this.transactionTracking.registerTransaction(tmpTransactionGUID);
+		const tmpTransaction = this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 
 		// Check to see if there are any hooks set from the input templates
 		let tmpLayoutProviders = this.pict.ContentAssignment.getElement(`${this.sectionDefinition.DefaultDestinationAddress} [data-i-pictdynamiclayout="true"]`);
@@ -646,7 +665,7 @@ class PictViewDynamicForm extends libPictViewClass
 			if (tmpLayoutProvider && (pFunctionName in tmpLayoutProvider))
 			{
 				let tmpFunction = tmpLayoutProvider[pFunctionName];
-				if (this.transactionTracking.checkEvent(tmpTransaction.TransactionKey, `G${tmpGroupIndex}-L${tmpLayout}`, pFunctionName))
+				if (this.pict.TransactionTracking.checkEvent(tmpTransaction.TransactionKey, `G${tmpGroupIndex}-L${tmpLayout}`, pFunctionName))
 				{
 					tmpFunction.call(tmpLayoutProvider, this, tmpGroup);
 				}
@@ -665,7 +684,7 @@ class PictViewDynamicForm extends libPictViewClass
 	runInputProviderFunctions(pFunctionName, pInputHash, pRowIndex, pTransactionGUID)
 	{
 		const tmpTransactionGUID = (typeof(pTransactionGUID) === 'string') ? pTransactionGUID : this.fable.getUUID();
-		const tmpTransaction = this.transactionTracking.registerTransaction(tmpTransactionGUID);
+		const tmpTransaction = this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
 
 		// Check to see if there are any hooks set from the input templates
 		for (let i = 0; i < this.sectionDefinition.Groups.length; i++)
@@ -699,8 +718,8 @@ class PictViewDynamicForm extends libPictViewClass
 											this.log.trace(`Dynamic form [${this.Hash}]::[${this.UUID}] running provider [${tmpInputProviderList[l]}] function [${pFunctionName}] for input [${tmpInput.Hash}].`);
 										}
 										// TODO: Right now the Option input requires this bug to work
-										//if (this.transactionTracking.checkEvent(tmpTransaction.TransactionKey, `I${tmpInput.Hash}-P${tmpInputProviderList[l]}`, pFunctionName))
-										if ((tmpInput.PictForm.InputType == 'Option') || this.transactionTracking.checkEvent(tmpTransaction.TransactionKey, `I${tmpInput.Hash}-P${tmpInputProviderList[l]}`, pFunctionName))
+										//if (this.pict.TransactionTracking.checkEvent(tmpTransaction.TransactionKey, `I${tmpInput.Hash}-P${tmpInputProviderList[l]}`, pFunctionName))
+										if ((tmpInput.PictForm.InputType == 'Option') || this.pict.TransactionTracking.checkEvent(tmpTransaction.TransactionKey, `I${tmpInput.Hash}-P${tmpInputProviderList[l]}`, pFunctionName))
 										{
 											this.pict.providers[tmpInputProviderList[l]][pFunctionName](this, tmpGroup, j, tmpInput, tmpValue, tmpInput.Macro.HTMLSelector);
 										}
@@ -752,7 +771,7 @@ class PictViewDynamicForm extends libPictViewClass
 										let tmpValue = this.sectionManifest.getValueByHash(this.getMarshalDestinationObject(), tmpValueAddress);
 										try
 										{
-											if (this.transactionTracking.checkEvent(tmpTransaction.TransactionKey, `TI${tmpInput.Hash}-P${tmpInputProviderList[l]}-R${r}`, pFunctionName))
+											if (this.pict.TransactionTracking.checkEvent(tmpTransaction.TransactionKey, `TI${tmpInput.Hash}-P${tmpInputProviderList[l]}-R${r}`, pFunctionName))
 											{
 												this.pict.providers[tmpInputProviderList[l]][pFunctionName + 'Tabular'](this, tmpGroup, tmpInput, tmpValue, tmpInput.Macro.HTMLSelectorTabular, r);
 											}
@@ -773,6 +792,7 @@ class PictViewDynamicForm extends libPictViewClass
 				}
 			}
 		}
+		this.finalizeTransaction(tmpTransactionGUID);
 	}
 
 	/**
@@ -982,30 +1002,34 @@ class PictViewDynamicForm extends libPictViewClass
 	 *
 	 * @param {String} pInputHash - The input hash object.
 	 * @param {string} pEvent - The input event string.
+	 * @param {string} [pTransactionGUID] - The transaction GUID.
 	 * @returns {any} - The result of the input event handling.
 	 */
-	inputEvent(pInputHash, pEvent)
+	inputEvent(pInputHash, pEvent, pTransactionGUID)
 	{
-		return this.pict.providers.DynamicInputEvents.inputEvent(this, pInputHash, pEvent);
+		return this.pict.providers.DynamicInputEvents.inputEvent(this, pInputHash, pEvent, pTransactionGUID);
 	}
 
 	/**
 	 * @deprecated
 	 * @param {string} pEvent - The input event string.
 	 * @param {Object} pCompletedHashes - the hashes that have already signaled the event
+	 * @param {string} [pTransactionGUID] - The transaction GUID.
 	 */
-	globalInputEvent(pEvent, pCompletedHashes)
+	globalInputEvent(pEvent, pCompletedHashes, pTransactionGUID)
 	{
-		this.manifestInputEvent(pEvent, pCompletedHashes);
+		this.manifestInputEvent(pEvent, pCompletedHashes, pTransactionGUID);
 	}
 
 	/**
 	 *
 	 * @param {string} pEvent - The input event string.
 	 * @param {Object} pCompletedHashes - the hashes that have already signaled the event
+	 * @param {string} [pTransactionGUID] - The transaction GUID.
 	 */
-	manifestInputEvent(pEvent, pCompletedHashes)
+	manifestInputEvent(pEvent, pCompletedHashes, pTransactionGUID)
 	{
+		const tmpTransactionGUID = (pTransactionGUID && typeof(pTransactionGUID) === 'string') ? pTransactionGUID : this.fable.getUUID();
 		const tmpInputHashes = Object.keys(this.sectionManifest.elementHashes);
 
 		for (let i = 0; i < tmpInputHashes.length; i++)
@@ -1013,9 +1037,14 @@ class PictViewDynamicForm extends libPictViewClass
 			if (!(tmpInputHashes[i] in pCompletedHashes))
 			{
 				pCompletedHashes[tmpInputHashes[i]] = true;
-				this.inputEvent(tmpInputHashes[i], pEvent);
+				this.inputEvent(tmpInputHashes[i], pEvent, pTransactionGUID);
 			}
 		}
+		if (pTransactionGUID !== tmpTransactionGUID)
+		{
+			// We created a transaction, so finalize it.
+			this.finalizeTransaction(tmpTransactionGUID);
+		}
 	}
 
 	/**
@@ -1038,11 +1067,150 @@ class PictViewDynamicForm extends libPictViewClass
 	 * @param {number} pInputIndex - The index of the input.
 	 * @param {number} pRowIndex - The index of the row.
 	 * @param {string} pEvent - The input event object.
+	 * @param {string} [pTransactionGUID] - The transaction GUID.
 	 * @returns {any} - The result of the input event handling.
 	 */
-	inputEventTabular(pGroupIndex, pInputIndex, pRowIndex, pEvent)
+	inputEventTabular(pGroupIndex, pInputIndex, pRowIndex, pEvent, pTransactionGUID)
+	{
+		return this.pict.providers.DynamicInputEvents.inputEventTabular(this, pGroupIndex, pInputIndex, pRowIndex, pEvent, pTransactionGUID);
+	}
+
+	/**
+	 * @param {string} pTransactionGUID - The transaction GUID.
+	 * @param {string} pAsyncOperationHash - The hash of the async operation.
+	 */
+	registerEventTransactionAsyncOperation(pTransactionGUID, pAsyncOperationHash)
+	{
+		this.pict.TransactionTracking.pushToTransactionQueue(pTransactionGUID, pAsyncOperationHash, PENDING_ASYNC_OPERATION_TYPE);
+	}
+
+	/**
+	 * @param {string} pTransactionGUID - The transaction GUID.
+	 * @param {string} pAsyncOperationHash - The hash of the async operation.
+	 *
+	 * @return {boolean} - Returns true if the async operation was found and marked as complete, otherwise false.
+	 */
+	eventTransactionAsyncOperationComplete(pTransactionGUID, pAsyncOperationHash)
+	{
+		const tmpQueue = this.pict.TransactionTracking.checkTransactionQueue(pTransactionGUID);
+		let tmpPendingAsyncOperationCount = 0;
+		let tmpMarkedOperationCount = 0;
+		let tmpFinalized = false;
+		for (let i = 0; i < tmpQueue.length; i++)
+		{
+			const tmpQueueItem = tmpQueue[i];
+			if (tmpQueueItem.Type === PENDING_ASYNC_OPERATION_TYPE)
+			{
+				if (tmpQueueItem.Data === pAsyncOperationHash)
+				{
+					tmpQueue.splice(i, 1);
+					++tmpMarkedOperationCount;
+					--i;
+				}
+				else
+				{
+					++tmpPendingAsyncOperationCount;
+				}
+			}
+			if (tmpQueueItem.Type === READY_TO_FINALIZE_TYPE)
+			{
+				tmpFinalized = true;
+			}
+		}
+		if (tmpPendingAsyncOperationCount === 0)
+		{
+			for (const tmpQueueItem of tmpQueue)
+			{
+				if (tmpQueueItem.Type === TRANSACTION_COMPLETE_CALLBACK_TYPE)
+				{
+					if (typeof tmpQueueItem.Data !== 'function')
+					{
+						this.log.error(`PICT View Metatemplate Helper eventTransactionAsyncOperationComplete transaction callback was not a function.`);
+						continue;
+					}
+					try
+					{
+						tmpQueueItem.Data();
+					}
+					catch (pError)
+					{
+						this.log.error(`PICT View Metatemplate Helper eventTransactionAsyncOperationComplete transaction callback error: ${pError}`, { Stack: pError.stack });
+					}
+				}
+			}
+		}
+		return tmpMarkedOperationCount > 0;
+	}
+
+	/**
+	 * @param {string} pTransactionGUID - The transaction GUID.
+	 *
+	 * @return {boolean} - Returns true if the transaction was found and able to be finalized, otherwise false.
+	 */
+	finalizeTransaction(pTransactionGUID)
 	{
-		return this.pict.providers.DynamicInputEvents.inputEventTabular(this, pGroupIndex, pInputIndex, pRowIndex, pEvent);
+		this.pict.TransactionTracking.pushToTransactionQueue(pTransactionGUID, null, READY_TO_FINALIZE_TYPE);
+
+		const tmpQueue = this.pict.TransactionTracking.checkTransactionQueue(pTransactionGUID);
+		let tmpPendingAsyncOperationCount = 0;
+		for (const tmpQueueItem of tmpQueue)
+		{
+			if (tmpQueueItem.Type === PENDING_ASYNC_OPERATION_TYPE)
+			{
+				++tmpPendingAsyncOperationCount;
+			}
+		}
+		if (tmpPendingAsyncOperationCount > 0)
+		{
+			this.pict.log.info(`PICT View Metatemplate Helper finalizeTransaction ${pTransactionGUID} is waiting on ${tmpPendingAsyncOperationCount} pending async operations.`);
+			return false;
+		}
+		for (const tmpQueueItem of tmpQueue)
+		{
+			if (tmpQueueItem.Type === TRANSACTION_COMPLETE_CALLBACK_TYPE)
+			{
+				if (typeof tmpQueueItem.Data !== 'function')
+				{
+					this.log.error(`PICT View Metatemplate Helper eventTransactionAsyncOperationComplete transaction callback was not a function.`);
+					continue;
+				}
+				try
+				{
+					tmpQueueItem.Data();
+				}
+				catch (pError)
+				{
+					this.log.error(`PICT View Metatemplate Helper eventTransactionAsyncOperationComplete transaction callback error: ${pError}`, { Stack: pError.stack });
+				}
+			}
+		}
+		return true;
+	}
+
+	/**
+	 * @param {string} pTransactionGUID - The transaction GUID.
+	 * @param {Function} fCallback - The callback to call when the transaction is complete.
+	 */
+	registerOnTransactionCompleteCallback(pTransactionGUID, fCallback)
+	{
+		const tmpQueue = this.pict.TransactionTracking.checkTransactionQueue(pTransactionGUID);
+		let tmpFinalized = false;
+		for (const tmpQueueItem of tmpQueue)
+		{
+			if (tmpQueueItem.Type === READY_TO_FINALIZE_TYPE)
+			{
+				tmpFinalized = true;
+				break;
+			}
+		}
+		if (tmpFinalized)
+		{
+			fCallback();
+		}
+		else
+		{
+			this.pict.TransactionTracking.pushToTransactionQueue(pTransactionGUID, fCallback, TRANSACTION_COMPLETE_CALLBACK_TYPE);
+		}
 	}
 
 	/**
@@ -1050,9 +1218,11 @@ class PictViewDynamicForm extends libPictViewClass
 	 * @param {number} pGroupIndex - The index of the group.
 	 * @param {string} pEvent - The input event string.
 	 * @param {Object} pCompletedHashes - the hashes that have already signaled the event
+	 * @param {string} [pTransactionGUID] - The transaction GUID.
 	 */
-	groupInputEvent(pGroupIndex, pEvent, pCompletedHashes)
+	groupInputEvent(pGroupIndex, pEvent, pCompletedHashes, pTransactionGUID)
 	{
+		const tmpTransactionGUID = (pTransactionGUID && typeof(pTransactionGUID) === 'string') ? pTransactionGUID : this.fable.getUUID();
 		const tmpGroup = this.getGroup(pGroupIndex);
 
 		if (!tmpGroup)
@@ -1077,7 +1247,7 @@ class PictViewDynamicForm extends libPictViewClass
 					if (!(tmpInputSignature in pCompletedHashes))
 					{
 						pCompletedHashes[tmpInputSignature] = true;
-						this.inputEventTabular(pGroupIndex, tmpInput.PictForm.InputIndex, i, pEvent);
+						this.inputEventTabular(pGroupIndex, tmpInput.PictForm.InputIndex, i, pEvent, tmpTransactionGUID);
 					}
 				}
 			}
@@ -1090,24 +1260,30 @@ class PictViewDynamicForm extends libPictViewClass
 				if (!(tmpInputSignature in pCompletedHashes))
 				{
 					pCompletedHashes[tmpInputSignature] = true;
-					this.inputEvent(tmpInput.Hash, pEvent);
+					this.inputEvent(tmpInput.Hash, pEvent, tmpTransactionGUID);
 				}
 			}
 		}
+		if (pTransactionGUID !== tmpTransactionGUID)
+		{
+			// We created a transaction, so finalize it.
+			this.finalizeTransaction(tmpTransactionGUID);
+		}
 	}
 
 	/**
 	 *
 	 * @param {string} pEvent - The input event string.
 	 * @param {Object} pCompletedHashes - the hashes that have already signaled the event
+	 * @param {string} [pTransactionGUID] - The transaction GUID.
 	 */
-	sectionInputEvent(pEvent, pCompletedHashes)
+	sectionInputEvent(pEvent, pCompletedHashes, pTransactionGUID)
 	{
 		const tmpGroupCount = this.sectionDefinition.Groups.length;
 
 		for (let i = 0; i < tmpGroupCount; i++)
 		{
-			this.groupInputEvent(i, pEvent, pCompletedHashes);
+			this.groupInputEvent(i, pEvent, pCompletedHashes, pTransactionGUID);
 		}
 	}
 

package/source/views/Pict-View-Form-Metacontroller.js

@@ -912,12 +912,16 @@ class PictFormMetacontroller extends libPictViewClass
 	/**
 	 * Trigger an event on all inputs on all views.
 	 * @param {string} pEvent - The event to trigger
+	 * @param {string} [pTransactionGUID] - (optional) The transaction GUID to use for the event.
 	 */
-	triggerGlobalInputEvent(pEvent)
+	triggerGlobalInputEvent(pEvent, pTransactionGUID)
 	{
+		const tmpTransactionGUID = (pTransactionGUID && typeof(pTransactionGUID) === 'string') ? pTransactionGUID : this.fable.getUUID();
 		let tmpEvent = (typeof(pEvent) === 'string') ? pEvent : this.fable.getUUID();
 		let tmpViewHashes = Object.keys(this.pict.views);
 		let tmpCompletedHashes = {};
+		/** @type {import('./Pict-View-DynamicForm.js')} */
+		let tmpFinalizeView = null;
 		// Filter the views based on the filter function and type
 		for (let i = 0; i < tmpViewHashes.length; i++)
 		{
@@ -925,9 +929,15 @@ class PictFormMetacontroller extends libPictViewClass
 			let tmpView = this.pict.views[tmpViewHashes[i]];
 			if (tmpView.isPictSectionForm)
 			{
-				tmpView.sectionInputEvent(tmpEvent, tmpCompletedHashes);
+				tmpFinalizeView = tmpView;
+				tmpView.sectionInputEvent(tmpEvent, tmpCompletedHashes, tmpTransactionGUID);
 			}
 		}
+		if (pTransactionGUID !== tmpTransactionGUID && tmpFinalizeView)
+		{
+			// If we created the transaction GUID, we need to finalize it
+			tmpFinalizeView.finalizeTransaction(tmpTransactionGUID);
+		}
 	}
 
 	/**

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

@@ -38,7 +38,16 @@ declare class PictDynamicFormsSolverBehaviors extends libPictProvider {
     generateHTMLHexColor(pRed: any, pGreen: any, pBlue: any): string;
     colorSectionBackground(pSectionHash: any, pColor: any, pApplyChange: any): boolean;
     colorGroupBackground(pSectionHash: any, pGroupHash: any, pColor: any, pApplyChange: any): boolean;
-    colorInputBackground(pSectionHash: any, pInputHash: any, pColor: any, pApplyChange: any): boolean;
+    /**
+     * Colors an input background or its container with a HTML hex color (e.g. #FF0000 for red).
+     * @param {string} pSectionHash - The hash of the section containing the input.
+     * @param {string} pInputHash - The hash of the input to color.
+     * @param {string} pColor - The HTML hex color to apply (e.g. #FF0000 for red).
+     * @param {string} pApplyChange - If "0", the change will not be applied.
+     * @param {string} [pClassTarget] - Optional. If provided, the color will be applied to the closest element with this class instead of the input itself.
+     * @returns {boolean} - Returns true if the color was applied successfully or if the change was skipped for pApplyChange equal to "0", false otherwise.
+     */
+    colorInputBackground(pSectionHash: string, pInputHash: string, pColor: string, pApplyChange: string, pClassTarget?: string): boolean;
     logValues(...args: any[]): any;
 }
 declare namespace PictDynamicFormsSolverBehaviors {

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

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-DynamicFormSolverBehaviors.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicFormSolverBehaviors.js"],"names":[],"mappings":";AAaA;;;;;GAKG;AACH;IAEC;;;;;OAKG;IACH,oBAJW,MAAM,YACN,MAAM,gBACN,MAAM,EAqBhB;IAbA,kBAAkB;IAClB,SADW,GAAG,CACF;IACZ,qFAAqF;IACrF,MADW,OAAO,MAAM,CAAC,GAAG;QAAE,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,UAAU,CAAC,CAAA;KAAE,CACxE;IAIT,qBAAqB;IACrB,qBADW,MAAM,CAC4C;IAC7D,0BAAyD;IACzD,mBAA2H;IAK5H,2DAMC;IAJA,kBAAsD;IAMvD,kHAaC;IAED,iDAeC;IAED,gDAGC;IAED,gEAUC;IAGD,wCAiBC;IAED,wCAiBC;IAED,+DAGC;IAED,+EAUC;IAED,uDAiBC;IAED,uDAiBC;IAED,iEAqBC;IAED,mFA2BC;IAED,kGA0BC;IAED,kGAmCC;IAED,+BAWC;CACD;;;;;AArUD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAQ3B"}
+{"version":3,"file":"Pict-Provider-DynamicFormSolverBehaviors.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicFormSolverBehaviors.js"],"names":[],"mappings":";AAaA;;;;;GAKG;AACH;IAEC;;;;;OAKG;IACH,oBAJW,MAAM,YACN,MAAM,gBACN,MAAM,EAqBhB;IAbA,kBAAkB;IAClB,SADW,GAAG,CACF;IACZ,qFAAqF;IACrF,MADW,OAAO,MAAM,CAAC,GAAG;QAAE,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,UAAU,CAAC,CAAA;KAAE,CACxE;IAIT,qBAAqB;IACrB,qBADW,MAAM,CAC4C;IAC7D,0BAAyD;IACzD,mBAA2H;IAK5H,2DAMC;IAJA,kBAAsD;IAMvD,kHAaC;IAED,iDAeC;IAED,gDAGC;IAED,gEAUC;IAGD,wCAiBC;IAED,wCAiBC;IAED,+DAGC;IAED,+EAUC;IAED,uDAiBC;IAED,uDAiBC;IAED,iEAqBC;IAED,mFA2BC;IAED,kGA0BC;IAED;;;;;;;;OAQG;IACH,mCAPW,MAAM,cACN,MAAM,UACN,MAAM,gBACN,MAAM,iBACN,MAAM,GACJ,OAAO,CAuDnB;IAED,+BAWC;CACD;;;;;AAhWD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAQ3B"}

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

@@ -24,8 +24,9 @@ declare class PictDynamicInputEvents extends libPictProvider {
      * @param {Object} pView - The view object.
      * @param {string} pInputHash - The input hash.
      * @param {string} pEvent - The input event.
+     * @param {string} [pTransactionGUID] - (optional) The active transaction GUID.
      */
-    inputEvent(pView: any, pInputHash: string, pEvent: string): void;
+    inputEvent(pView: any, pInputHash: string, pEvent: string, pTransactionGUID?: string): void;
     /**
      * Requests input data for a tabular record.
      *
@@ -43,8 +44,9 @@ declare class PictDynamicInputEvents extends libPictProvider {
      * @param {number} pInputIndex - The index of the input.
      * @param {number} pRowIndex - The index of the row.
      * @param {string} pEvent - The input event.
+     * @param {string} [pTransactionGUID] - (optional) The active transaction GUID.
      */
-    inputEventTabular(pView: any, pGroupIndex: number, pInputIndex: number, pRowIndex: number, pEvent: string): void;
+    inputEventTabular(pView: any, pGroupIndex: number, pInputIndex: number, pRowIndex: number, pEvent: string, pTransactionGUID?: string): void;
 }
 declare namespace PictDynamicInputEvents {
     export { _DefaultProviderConfiguration as default_configuration };

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

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-DynamicInputEvents.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicInputEvents.js"],"names":[],"mappings":";AAaA;;GAEG;AACH;IAEC;;;;;;OAMG;IACH,oBAJW,MAAM,YACN,MAAM,gBACN,MAAM,EAMhB;IAED;;;;;OAKG;IACH,yCAFW,MAAM,QAkChB;IAED;;;;;;OAMG;IACH,mCAHW,MAAM,UACN,MAAM,QAsChB;IAED;;;;;;;OAOG;IACH,+BALW,OAAO,gCAAgC,CAAC,eACxC,MAAM,eACN,MAAM,aACN,MAAM,QAyChB;IAED;;;;;;;;OAQG;IACH,2CALW,MAAM,eACN,MAAM,aACN,MAAM,UACN,MAAM,QAkChB;CACD;;;;;AA7MD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}
+{"version":3,"file":"Pict-Provider-DynamicInputEvents.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicInputEvents.js"],"names":[],"mappings":";AAaA;;GAEG;AACH;IAEC;;;;;;OAMG;IACH,oBAJW,MAAM,YACN,MAAM,gBACN,MAAM,EAMhB;IAED;;;;;OAKG;IACH,yCAFW,MAAM,QAkChB;IAED;;;;;;;OAOG;IACH,mCAJW,MAAM,UACN,MAAM,qBACN,MAAM,QAgDhB;IAED;;;;;;;OAOG;IACH,+BALW,OAAO,gCAAgC,CAAC,eACxC,MAAM,eACN,MAAM,aACN,MAAM,QAyChB;IAED;;;;;;;;;OASG;IACH,2CANW,MAAM,eACN,MAAM,aACN,MAAM,UACN,MAAM,qBACN,MAAM,QA4ChB;CACD;;;;;AAnOD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}

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

@@ -13,9 +13,10 @@ declare class PictDynamicSolver extends libPictProvider {
     constructor(pFable: object, pOptions: object, pServiceHash: object);
     /** @type {import('pict')} */
     pict: import("pict");
-    /** @type {import('pict') & { instantiateServiceProviderIfNotExists: (hash: string) => any }} */
+    /** @type {import('pict') & { instantiateServiceProviderIfNotExists: (hash: string) => any, ExpressionParser: any }} */
     fable: import("pict") & {
         instantiateServiceProviderIfNotExists: (hash: string) => any;
+        ExpressionParser: any;
     };
     /**
      * Checks the solver and returns the solver object if it passes the checks.

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

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-DynamicSolver.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicSolver.js"],"names":[],"mappings":";AA8BA;;GAEG;AACH;IAEC;;;;;;OAMG;IACH,oBAJW,MAAM,YACN,MAAM,gBACN,MAAM,EAqChB;IA9BA,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IACT,gGAAgG;IAChG,OADW,OAAO,MAAM,CAAC,GAAG;QAAE,qCAAqC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAA;KAAE,CAClF;IA6BX;;;;;;;;;OASG;IACH,qBALW,MAAM,GAAC,MAAM,cACb,OAAO,aACP,MAAM,GACJ,MAAM,GAAC,SAAS,CA8B5B;IAED;;;;;;;OAOG;IACH,wDAFW,MAAM,QAyDhB;IAED;;;;;OAKG;IACH,gEAFW,MAAM,QA+BhB;IAED;;;;;OAKG;IACH,sDAFW,MAAM,QAwBhB;IAED;;;;;;;;OAQG;IACH,gCAJW,MAAM,yBAWhB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,yBAFW,QAAM,MAAM,EAAE,QAiFxB;IADA;;;;;MAAuC;CAExC;;;;;AAhWD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}
+{"version":3,"file":"Pict-Provider-DynamicSolver.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicSolver.js"],"names":[],"mappings":";AA8BA;;GAEG;AACH;IAEC;;;;;;OAMG;IACH,oBAJW,MAAM,YACN,MAAM,gBACN,MAAM,EAqChB;IA9BA,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IACT,uHAAuH;IACvH,OADW,OAAO,MAAM,CAAC,GAAG;QAAE,qCAAqC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;QAAC,gBAAgB,EAAE,GAAG,CAAA;KAAE,CACzG;IA6BX;;;;;;;;;OASG;IACH,qBALW,MAAM,GAAC,MAAM,cACb,OAAO,aACP,MAAM,GACJ,MAAM,GAAC,SAAS,CA8B5B;IAED;;;;;;;OAOG;IACH,wDAFW,MAAM,QAyDhB;IAED;;;;;OAKG;IACH,gEAFW,MAAM,QA+BhB;IAED;;;;;OAKG;IACH,sDAFW,MAAM,QAwBhB;IAED;;;;;;;;OAQG;IACH,gCAJW,MAAM,yBAWhB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,yBAFW,QAAM,MAAM,EAAE,QAiFxB;IADA;;;;;MAAuC;CAExC;;;;;AAhWD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}