pict-section-form 1.0.121 → 1.0.123

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.
  *
@@ -172,11 +176,12 @@ class PictViewDynamicForm extends libPictViewClass
 				let tmpValue = this.sectionManifest.getValueByHash(tmpMarshalDestinationObject, tmpHashAddress);
 
 				let tmpInputProviderList = this.getInputProviderList(tmpInput);
+				const tmpTransactionGUID = this.fable.getUUID();
 				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 +238,12 @@ 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();
 				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 +269,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 +286,19 @@ 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();
 			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 +311,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 +365,19 @@ 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();
 				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)
 			{
@@ -773,6 +787,7 @@ class PictViewDynamicForm extends libPictViewClass
 				}
 			}
 		}
+		this.finalizeTransaction(tmpTransactionGUID);
 	}
 
 	/**
@@ -982,30 +997,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 +1032,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 +1062,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 +1213,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 +1242,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 +1255,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-InputExtension.d.ts

@@ -38,9 +38,10 @@ declare class PictInputExtensionProvider extends libPictProvider {
      * @param {Object} pRow - The Row index.
      * @param {Object} pInput - The input object.
      * @param {any} pValue - The value of the input object
+     * @param {string} pTransactionGUID - The transaction GUID for the event dispatch.
      * @param {string} pHTMLSelector - The HTML selector for the input object
      */
-    onInputInitialize(pView: any, pGroup: any, pRow: any, pInput: any, pValue: any, pHTMLSelector: string): boolean;
+    onInputInitialize(pView: any, pGroup: any, pRow: any, pInput: any, pValue: any, pHTMLSelector: string, pTransactionGUID: string): boolean;
     /**
      * A tabular input has been initialized (rendered into the DOM)
      *
@@ -51,9 +52,10 @@ declare class PictInputExtensionProvider extends libPictProvider {
      * @param {Object} pInput - The input object.
      * @param {any} pValue - The value of the input object
      * @param {string} pHTMLSelector - The HTML selector for the input object (it will return an array).
+     * @param {string} pTransactionGUID - The transaction GUID for the event dispatch.
      * @param {number} pRowIndex - The row index of the tabular data
      */
-    onInputInitializeTabular(pView: any, pGroup: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number): boolean;
+    onInputInitializeTabular(pView: any, pGroup: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number, pTransactionGUID: string): boolean;
     /**
      * Called when the data change function is called
      *
@@ -63,8 +65,9 @@ declare class PictInputExtensionProvider extends libPictProvider {
      * @param {Object} pInput - The input object.
      * @param {any} pValue - The new value of the input object
      * @param {string} pHTMLSelector - The HTML selector for the input object
+     * @param {string} pTransactionGUID - The transaction GUID for the event dispatch.
      */
-    onDataChange(pView: any, pInput: any, pValue: any, pHTMLSelector: string): boolean;
+    onDataChange(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pTransactionGUID: string): boolean;
     /**
      * Called when an input has this Provider hash in its 'Providers' array.
      *
@@ -73,8 +76,9 @@ declare class PictInputExtensionProvider extends libPictProvider {
      * @param {any} pValue - The new value of the input object
      * @param {string} pHTMLSelector - The HTML selector for the input object
      * @param {number} pRowIndex - The row index of the tabular data
+     * @param {string} pTransactionGUID - The transaction GUID for the event dispatch.
      */
-    onDataChangeTabular(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number): boolean;
+    onDataChangeTabular(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number, pTransactionGUID: string): boolean;
     /**
      * Fires when data is marshaled to the form for this input.
      *
@@ -84,9 +88,10 @@ declare class PictInputExtensionProvider extends libPictProvider {
      * @param {Object} pInput - The input object.
      * @param {any} pValue - The value to marshal.
      * @param {string} pHTMLSelector - The HTML selector.
+     * @param {string} pTransactionGUID - The transaction GUID for the event dispatch.
      * @returns {boolean} - Returns true if the data was successfully marshaled to the form.
      */
-    onDataMarshalToForm(pView: any, pGroup: any, pRow: number, pInput: any, pValue: any, pHTMLSelector: string): boolean;
+    onDataMarshalToForm(pView: any, pGroup: any, pRow: number, pInput: any, pValue: any, pHTMLSelector: string, pTransactionGUID: string): boolean;
     /**
      * Fires when data is marshaled to the form for this input.
      *
@@ -96,9 +101,10 @@ declare class PictInputExtensionProvider extends libPictProvider {
      * @param {any} pValue - The value to marshal.
      * @param {string} pHTMLSelector - The HTML selector.
      * @param {number} pRowIndex - The index of the input in the row columns.
+     * @param {string} pTransactionGUID - The transaction GUID for the event dispatch.
      * @returns {boolean} - Returns true if the data was successfully marshaled to the form.
      */
-    onDataMarshalToFormTabular(pView: any, pGroup: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number): boolean;
+    onDataMarshalToFormTabular(pView: any, pGroup: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number, pTransactionGUID: string): boolean;
     /**
      * Handles data requests for the Pict-Provider-InputExtension.
      *
@@ -128,9 +134,35 @@ declare class PictInputExtensionProvider extends libPictProvider {
      * @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: any, pInput: any, pValue: any, pHTMLSelector: string, pEvent: string): boolean;
+    onEvent(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pEvent: string, pTransactionGUID: string): boolean;
+    /**
+     * 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.
+     */
+    onAfterEventCompletion(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pEvent: string, pTransactionGUID: string): boolean;
+    /**
+     * 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 {number} pRowIndex - The row index of the tabular data.
+     * @param {string} pEvent - The event hash that is expected to be triggered.
+     * @param {string} pTransactionGUID - The transaction GUID, if any.
+     * @returns {boolean} - Returns true.
+     */
+    onEventTabular(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number, pEvent: string, pTransactionGUID: string): boolean;
     /**
      * Handles events for the Pict-Provider-InputExtension.
      *
@@ -140,9 +172,10 @@ declare class PictInputExtensionProvider extends libPictProvider {
      * @param {string} pHTMLSelector - The HTML selector.
      * @param {number} pRowIndex - The row index of the tabular data.
      * @param {string} pEvent - The event hash that is expected to be triggered.
+     * @param {string} pTransactionGUID - The transaction GUID, if any.
      * @returns {boolean} - Returns true.
      */
-    onEventTabular(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number, pEvent: string): boolean;
+    onAfterEventTabularCompletion(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number, pEvent: string, pTransactionGUID: string): boolean;
 }
 declare namespace PictInputExtensionProvider {
     export { _DefaultProviderConfiguration as default_configuration };

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

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-InputExtension.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-InputExtension.js"],"names":[],"mappings":";AAaA;;;;GAIG;AACH;IAEC;;;;;;OAMG;IACH,oBAJW,MAAM,YACN,MAAM,gBACN,MAAM,EAMhB;IAGD;;;;;OAKG;IACH,6BAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;OAMG;IACH,oCAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;;;;;OAWG;IACH,2EAHW,GAAG,iBACH,MAAM,WAKhB;IAED;;;;;;;;;;;OAWG;IACH,uEAJW,GAAG,iBACH,MAAM,aACN,MAAM,WAKhB;IAED;;;;;;;;;OASG;IACH,8CAHW,GAAG,iBACH,MAAM,WAKhB;IAED;;;;;;;;OAQG;IACH,qDAJW,GAAG,iBACH,MAAM,aACN,MAAM,WAKhB;IAED;;;;;;;;;;OAUG;IACH,mDANW,MAAM,uBAEN,GAAG,iBACH,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;;;OAUG;IACH,yEALW,GAAG,iBACH,MAAM,aACN,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;OAQG;IACH,+CAJW,GAAG,iBACH,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;;OASG;IACH,sDALW,GAAG,iBACH,MAAM,aACN,MAAM,GACJ,OAAO,CAKnB;IAGD;;;;;;;;;OASG;IACH,yCALW,GAAG,iBACH,MAAM,UACN,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;;;OAUG;IACH,gDANW,GAAG,iBACH,MAAM,aACN,MAAM,UACN,MAAM,GACJ,OAAO,CAKnB;CACD;;;;;AAlND,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}
+{"version":3,"file":"Pict-Provider-InputExtension.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-InputExtension.js"],"names":[],"mappings":";AAaA;;;;GAIG;AACH;IAEC;;;;;;OAMG;IACH,oBAJW,MAAM,YACN,MAAM,gBACN,MAAM,EAMhB;IAGD;;;;;OAKG;IACH,6BAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;OAMG;IACH,oCAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;;;;;;OAYG;IACH,2EAJW,GAAG,iBAEH,MAAM,oBADN,MAAM,WAMhB;IAED;;;;;;;;;;;;OAYG;IACH,uEALW,GAAG,iBACH,MAAM,aAEN,MAAM,oBADN,MAAM,WAMhB;IAED;;;;;;;;;;OAUG;IACH,8CAJW,GAAG,iBACH,MAAM,oBACN,MAAM,WAKhB;IAED;;;;;;;;;OASG;IACH,qDALW,GAAG,iBACH,MAAM,aACN,MAAM,oBACN,MAAM,WAKhB;IAED;;;;;;;;;;;OAWG;IACH,mDAPW,MAAM,uBAEN,GAAG,iBACH,MAAM,oBACN,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;;;;OAWG;IACH,yEANW,GAAG,iBACH,MAAM,aACN,MAAM,oBACN,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;OAQG;IACH,+CAJW,GAAG,iBACH,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;;OASG;IACH,sDALW,GAAG,iBACH,MAAM,aACN,MAAM,GACJ,OAAO,CAKnB;IAGD;;;;;;;;;;OAUG;IACH,yCANW,GAAG,iBACH,MAAM,UACN,MAAM,oBACN,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;;;OAUG;IACH,wDANW,GAAG,iBACH,MAAM,UACN,MAAM,oBACN,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;;;;OAWG;IACH,gDAPW,GAAG,iBACH,MAAM,aACN,MAAM,UACN,MAAM,oBACN,MAAM,GACJ,OAAO,CAKnB;IAED;;;;;;;;;;;OAWG;IACH,+DAPW,GAAG,iBACH,MAAM,aACN,MAAM,UACN,MAAM,oBACN,MAAM,GACJ,OAAO,CAKnB;CACD;;;;;AA3PD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}

package/types/source/providers/inputs/Pict-Provider-Input-AutofillTriggerGroup.d.ts

@@ -14,7 +14,7 @@ export = CustomInputHandler;
     Providers: ["Pict-Input-AutofillTriggerGroup"],
     AutofillTriggerGroup:
         {
-            TriggerGroupName: "Author",
+            TriggerGroupHash: "Author",
             TriggerAddress: "AppData.CurrentAuthor.Name",
             MarshalEmptyValues: true
         }
@@ -40,9 +40,10 @@ declare class CustomInputHandler extends libPictSectionInputExtension {
      * @param {Object} pInput - The input object.
      * @param {any} pValue - The new value of the input.
      * @param {string} pHTMLSelector - The HTML selector of the input.
+     * @param {string} pTransactionGUID - The transaction GUID, if any.
      * @returns {any} - The result of the super.onDataChange method.
      */
-    onDataChange(pView: any, pInput: any, pValue: any, pHTMLSelector: string): any;
+    onDataChange(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pTransactionGUID: string): any;
     /**
      * Handles the change event for tabular data.
      *
@@ -51,11 +52,10 @@ declare class CustomInputHandler extends libPictSectionInputExtension {
      * @param {any} pValue - The new value.
      * @param {string} pHTMLSelector - The HTML selector.
      * @param {number} pRowIndex - The index of the row.
+     * @param {string} pTransactionGUID - The transaction GUID, if any.
      * @returns {any} - The result of the super method.
      */
-    onDataChangeTabular(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number): any;
-    onEvent(pView: any, pInput: any, pValue: any, pHTMLSelector: any, pEvent: any): boolean;
-    onEventTabular(pView: any, pInput: any, pValue: any, pHTMLSelector: any, pRowIndex: any, pEvent: any): boolean;
+    onDataChangeTabular(pView: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number, pTransactionGUID: string): any;
 }
 import libPictSectionInputExtension = require("../Pict-Provider-InputExtension.js");
 //# sourceMappingURL=Pict-Provider-Input-AutofillTriggerGroup.d.ts.map

package/types/source/providers/inputs/Pict-Provider-Input-AutofillTriggerGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-Input-AutofillTriggerGroup.d.ts","sourceRoot":"","sources":["../../../../source/providers/inputs/Pict-Provider-Input-AutofillTriggerGroup.js"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAEC,2DAQC;IAJA,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAKV,oDAYC;IAED,sGAwBC;IAED,6HAwBC;IAGD;;;;;;;;OAQG;IACH,8CAJW,GAAG,iBACH,MAAM,GACJ,GAAG,CAgBf;IAED;;;;;;;;;OASG;IACH,qDALW,GAAG,iBACH,MAAM,aACN,MAAM,GACJ,GAAG,CAgBf;IAGD,wFAqCC;IAED,+GAuCC;CACD"}
+{"version":3,"file":"Pict-Provider-Input-AutofillTriggerGroup.d.ts","sourceRoot":"","sources":["../../../../source/providers/inputs/Pict-Provider-Input-AutofillTriggerGroup.js"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAEC,2DAQC;IAJA,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAKV,oDAYC;IAED,sGAwBC;IAED,6HAwBC;IAGD;;;;;;;;;OASG;IACH,8CALW,GAAG,iBACH,MAAM,oBACN,MAAM,GACJ,GAAG,CAmBf;IAED;;;;;;;;;;OAUG;IACH,qDANW,GAAG,iBACH,MAAM,aACN,MAAM,oBACN,MAAM,GACJ,GAAG,CAmBf;CAyHD"}

package/types/source/providers/inputs/Pict-Provider-Input-DateTime.d.ts

@@ -42,9 +42,10 @@ declare class CustomInputHandler extends libPictSectionInputExtension {
      * @param {Object} pInput - The input object.
      * @param {any} pValue - The value to be assigned.
      * @param {string} pHTMLSelector - The HTML selector.
+     * @param {string} pTransactionGUID - The transaction GUID for the event dispatch.
      * @returns {any} - The result of the super method call.
      */
-    onDataMarshalToForm(pView: any, pGroup: any, pRow: any, pInput: any, pValue: any, pHTMLSelector: string): any;
+    onDataMarshalToForm(pView: any, pGroup: any, pRow: any, pInput: any, pValue: any, pHTMLSelector: string, pTransactionGUID: string): any;
     /**
      * Marshals data to the form in a tabular format.
      *
@@ -54,9 +55,10 @@ declare class CustomInputHandler extends libPictSectionInputExtension {
      * @param {any} pValue - The value to be assigned.
      * @param {string} pHTMLSelector - The HTML selector.
      * @param {number} pRowIndex - The index of the row.
+     * @param {string} pTransactionGUID - The transaction GUID for the event dispatch.
      * @returns {any} - The result of the data marshaling.
      */
-    onDataMarshalToFormTabular(pView: any, pGroup: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number): any;
+    onDataMarshalToFormTabular(pView: any, pGroup: any, pInput: any, pValue: any, pHTMLSelector: string, pRowIndex: number, pTransactionGUID: string): any;
 }
 import libPictSectionInputExtension = require("../Pict-Provider-InputExtension.js");
 //# sourceMappingURL=Pict-Provider-Input-DateTime.d.ts.map

package/types/source/providers/inputs/Pict-Provider-Input-DateTime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-Input-DateTime.d.ts","sourceRoot":"","sources":["../../../../source/providers/inputs/Pict-Provider-Input-DateTime.js"],"names":[],"mappings":";AAEA;;;;GAIG;AACH;IAEC,2DAQC;IAJA,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAKV;;;;;OAKG;IACH,qCAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;OAMG;IACH,kDAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;OAMG;IACH,4CAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;;;;;;OAYG;IACH,6EAJW,GAAG,iBACH,MAAM,GACJ,GAAG,CAMf;IAED;;;;;;;;;;OAUG;IACH,yEALW,GAAG,iBACH,MAAM,aACN,MAAM,GACJ,GAAG,CAMf;CAmED"}
+{"version":3,"file":"Pict-Provider-Input-DateTime.d.ts","sourceRoot":"","sources":["../../../../source/providers/inputs/Pict-Provider-Input-DateTime.js"],"names":[],"mappings":";AAEA;;;;GAIG;AACH;IAEC,2DAQC;IAJA,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAKV;;;;;OAKG;IACH,qCAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;OAMG;IACH,kDAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;OAMG;IACH,4CAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;;;;;;;OAaG;IACH,6EALW,GAAG,iBACH,MAAM,oBACN,MAAM,GACJ,GAAG,CAMf;IAED;;;;;;;;;;;OAWG;IACH,yEANW,GAAG,iBACH,MAAM,aACN,MAAM,oBACN,MAAM,GACJ,GAAG,CAMf;CAmED"}