pict-section-recordset 1.0.15 → 1.0.18

package/example_applications/simple_entity/Simple-RecordSet-Application.js

@@ -12,6 +12,169 @@ module.exports.default_configuration.pict_configuration = (
 				"AutoRenderMainViewportViewAfterInitialize": false
 			},
 
+		"Manifests": // Manifest'Ohs: Breakfast of Champions
+		{
+			"Bestsellers":
+			{
+				"Scope": "Bestsellers",
+				"CoreEntity": "Book",
+				"TitleTemplate": "Bestsellers ({~D:Record.RecordSet~} LoL)",
+				"GlobalSolvers":
+				[
+					{
+						"Ordinal": 0,
+						"Expression": "AppData.AuthorsFavoriteNumber = AVG(RecordSubset[].IDBook)",
+					},
+					{
+						"Ordinal": 1,
+						"Expression": "AppData.AuthorsLeastFavoriteNumber = SUM(RecordSubset[].IDBook)",
+					},
+					{
+						"Ordinal": 1,
+						"Expression": "AppData.BookCount = COUNT(RecordSet[])",
+					},
+					{
+						"Ordinal": 1,
+						"Expression": "AppData.TotalLibraryValue = SUM(RecordSet[].Price)",
+					},
+				],
+				"Descriptors":
+				{
+					"IDBook":
+					{
+						"Name": "Book Identifier",
+						"Hash": "BookIdentifire",
+					},
+					"PublicationYear":
+					{
+						"Name": "PublicationYear",
+						"Hash": "PublicationYear",
+						"PictDashboard":
+						{
+							"Equation": "ROUND(SQRT(PublicationYear), 3)",
+							"ValueTemplate": "{~D:Record.Payload.PublicationYear~} ({~SBR:Record.Data.PictDashboard.Equation:Record.Payload:Pict.PictSectionRecordSet.getManifest(Record.Data.ManifestHash)~})",
+						}
+					},
+					"Title":
+					{
+						"Name": "Title",
+						"Hash": "Title",
+						"PictDashboard":
+						{
+							"ValueTemplate": "{~D:Record.Payload.Title~} ({~D:AppData.RSP-Provider-BookstoreInventory.Authors.length~} authors in cohort)"
+						}
+					},
+					"AuthorBookCount":
+					{
+						"Name": "Author Book Count",
+						"Hash": "AuthorBookCount",
+					},
+					"Authors":
+					{
+						"Name": "Authors",
+						"Hash": "BookAuthors",
+						"DataType": "Array",
+						"PictDashboard":
+						{
+							"ValueTemplate": "{~PJU:, ^Name^Record.Payload.Authors~}"
+						}
+					},
+					"AuthorCount":
+					{
+						"Name": "Number of Authors",
+						"Hash": "AuthorCount",
+						"DataType": "Number",
+						"PictDashboard":
+						{
+							"EquationNamespaceScope": "Full",
+							"Equation": "Payload.Authors.length + 0", //FIXME: having to + 0 here seems sketchy
+							"Solvers":
+							[
+								{
+									"Ordinal": 0,
+									"Expression": "Price = ROUND(RANDOMFLOATBETWEEN(0.5, 40), 2)",
+								},
+								"AuthorCount = COS(Authors.length)",
+							],
+						}
+					},
+					"AuthorSineWave":
+					{
+						"Name": "Number of Authors in Orbit",
+						"Hash": "AuthorSineWave",
+						"DataType": "Number",
+						"PictDashboard":
+						{
+							"Equation": "AuthorSineWave = ROUND(SIN(BookIdentifire / 100)^3,5)", //FIXME: having to + 0 here seems sketchy
+							//"ValueTemplate": "{~D:Record.Payload.AuthorsInOrbit~}",
+							"Solvers": [ "AuthorsInOrbit = SIN(Authors.length)" ],
+						}
+					}
+				},
+			},
+			"Underdogs":
+			{
+				"Scope": "Underdogs",
+				"CoreEntity": "Book",
+				"Descriptors":
+				{
+					"Title":
+					{
+						"Name": "Title",
+						"Hash": "Title",
+						"DataType": "String"
+					},
+					"Authors":
+					{
+						"Name": "Authors",
+						"Hash": "Authors",
+						"PictDashboard":
+						{
+						}
+					},
+					"AuthorCount":
+					{
+						"Name": "Number of Authors",
+						"Hash": "AuthorCount",
+						"DataType": "Number",
+						"PictDashboard":
+						{
+						}
+					}
+				},
+			},
+			"NewReleases":
+			{
+				"Scope": "NewReleases",
+				"CoreEntity": "Book",
+				"Descriptors":
+				{
+					"Title":
+					{
+						"Name": "Title",
+						"Hash": "Title",
+						"DataType": "String"
+					},
+					"Authors":
+					{
+						"Name": "Authors",
+						"Hash": "Authors",
+						"PictDashboard":
+						{
+						}
+					},
+					"AuthorCount":
+					{
+						"Name": "Number of Authors",
+						"Hash": "AuthorCount",
+						"DataType": "Number",
+						"PictDashboard":
+						{
+						}
+					}
+				},
+			}
+		},
 		"DefaultRecordSetConfigurations":
 			[
 				{
@@ -35,11 +198,94 @@ module.exports.default_configuration.pict_configuration = (
 						}
 					],
 
+					"RecordSetListManifestOnly": false,
+
+					"RecordSetListManifests": [ "Bestsellers", "Underdogs", "NewReleases" ],
+					"RecordSetDashboardManifests": [ "Bestsellers" ],
+
+					"RecordSetListHasExtraColumns": true,
+					"RecordSetListExtraColumnsHeaderTemplate": "<th style=\"border-bottom: 1px solid #ccc; padding: 5px; background-color: #f2f2f2; color: #333;\">Cover</th>",
+					"RecordSetListExtraColumnRowTemplate": "<td><img src=\"{~D:Record.Data.ImageURL~}\"></td>",
+
+					"SearchFields": [ "Title" ],
+
+					"RecordSetFilterURLTemplate-Default": "/PSRS/{~D:Record.RecordSet~}/ListFilteredTo/{~D:Record.FilterString~}",
+					"RecordSetFilterURLTemplate-List": "/PSRS/{~D:Record.RecordSet~}/ListFilteredTo/{~D:Record.FilterString~}",
+					"RecordSetFilterURLTemplate-Dashboard": "/PSRS/{~D:Record.RecordSet~}/Dashboard/FilteredTo/{~D:Record.FilterString~}",
+
+					"RecordSetURLPrefix": "/1.0/"
+				},
+				{
+					"RecordSet": "BookstoreInventory",
+					"Title": "Bookstore Inventory",
+
+					"RecordSetType": "MeadowEndpoint", // Could be "Custom" which would require a provider to already be created for the record set.
+					"RecordSetMeadowEntity": "Book",   // This leverages the /Schema endpoint to get the record set columns.
+
+					"RecordSetDashboardManifests": [ "Bestsellers", "Underdogs", "NewReleases" ],
+
+					"RecordDecorationConfiguration":
+					[
+						{
+							"Entity": "BookAuthorJoin",
+							"Filter": "FBL~IDBook~INN~{~PJU:,^IDBook^Record.State.CoreEntityRecordSubset~}",
+							"Destination": "State.BookAuthorJoins"
+						},
+						{
+							"Entity": "Author",
+							"Filter": "FBL~IDAuthor~INN~{~PJU:,^IDAuthor^Record.State.BookAuthorJoins~}",
+							"Destination": "State.Authors"
+						},
+						{
+							"Type": "MapJoin",
+							"DestinationRecordSetAddress": "State.CoreEntityRecordSubset",
+							"DestinationJoinValue": "IDBook",
+							"JoinJoinValueLHS": "IDBook",
+							"Joins": "State.BookAuthorJoins",
+							"JoinJoinValueRHS": "IDAuthor",
+							"JoinRecordSetAddress": "State.Authors",
+							"JoinValue": "IDAuthor",
+							"RecordDestinationAddress": "Authors"
+						},
+						{
+							"Entity": "BookAuthorJoin",
+							"Filter": "FBL~IDAuthor~INN~{~PJU:,^IDAuthor^Record.State.Authors~}",
+							"Destination": "State.BookAuthorJoinsRev"
+						},
+						{
+							"Entity": "Book",
+							"Filter": "FBL~IDBook~INN~{~PJU:,^IDBook^Record.State.BookAuthorJoinsRev~}",
+							"Destination": "State.BooksForAuthors"
+						},
+						{
+							"Type": "MapJoin",
+							"DestinationRecordSetAddress": "State.Authors",
+							"DestinationJoinValue": "IDAuthor",
+							"JoinJoinValueLHS": "IDAuthor",
+							"Joins": "State.BookAuthorJoinsRev",
+							"JoinJoinValueRHS": "IDBook",
+							"JoinRecordSetAddress": "State.BooksForAuthors",
+							"JoinValue": "IDBook",
+							"RecordDestinationAddress": "Books"
+						}
+					],
+					"AvailableVerbs": [ "Dashboard" ],
+
 					"RecordSetListHasExtraColumns": true,
 					"RecordSetListExtraColumnsHeaderTemplate": "<th style=\"border-bottom: 1px solid #ccc; padding: 5px; background-color: #f2f2f2; color: #333;\">Cover</th>",
 					"RecordSetListExtraColumnRowTemplate": "<td><img src=\"{~D:Record.Data.ImageURL~}\"></td>",
+
 					"SearchFields": [ "Title" ],
 
+					"RecordSetFilterURLTemplate-Default": "/PSRS/{~D:Record.RecordSet~}/ListFilteredTo/{~D:Record.FilterString~}",
+					"RecordSetFilterURLTemplate-List": "/PSRS/{~D:Record.RecordSet~}/ListFilteredTo/{~D:Record.FilterString~}",
+					"RecordSetFilterURLTemplate-Dashboard": "/PSRS/{~D:Record.RecordSet~}/Dashboard/FilteredTo/{~D:Record.FilterString~}",
+					//TODO: something like this to reduce boilerplate
+					"RecordSetFilterURLTemplate-Dashboard-Specific": "/PSRS/{~D:Record.RecordSet~}/SpecificDashboard/$$DASHBOARD_HASH$$/FilteredTo/{~D:Record.FilterString~}",
+					"RecordSetFilterURLTemplate-Dashboard-Bestsellers": "/PSRS/{~D:Record.RecordSet~}/SpecificDashboard/Bestsellers/FilteredTo/{~D:Record.FilterString~}",
+					"RecordSetFilterURLTemplate-Dashboard-Underdogs": "/PSRS/{~D:Record.RecordSet~}/SpecificDashboard/Underdogs/FilteredTo/{~D:Record.FilterString~}",
+					"RecordSetFilterURLTemplate-Dashboard-NewReleases": "/PSRS/{~D:Record.RecordSet~}/SpecificDashboard/NewReleases/FilteredTo/{~D:Record.FilterString~}",
+
 					"RecordSetURLPrefix": "/1.0/"
 				},
 				{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pict-section-recordset",
-  "version": "1.0.15",
+  "version": "1.0.18",
   "description": "Pict dynamic record set management views",
   "main": "source/Pict-Section-RecordSet.js",
   "directories": {
@@ -33,7 +33,7 @@
     "browser-env": "^3.3.0",
     "eslint": "^9.27.0",
     "jquery": "^3.7.1",
-    "pict": "^1.0.257",
+    "pict": "^1.0.267",
     "pict-application": "^1.0.25",
     "pict-service-commandlineutility": "^1.0.15",
     "quackage": "^1.0.41",
@@ -42,8 +42,8 @@
   "dependencies": {
     "fable-serviceproviderbase": "^3.0.15",
     "pict-provider": "^1.0.3",
-    "pict-router": "^1.0.3",
-    "pict-section-form": "^1.0.95",
+    "pict-router": "^1.0.4",
+    "pict-section-form": "^1.0.97",
     "pict-template": "^1.0.10",
     "pict-view": "^1.0.60"
   },

package/source/application/Pict-Application-RecordSet.js

@@ -1,6 +1,7 @@
 const libPictApplication = require('pict-application');
 
 const libPictSectionRecordSet = require('../Pict-Section-RecordSet.js');
+const libDynamicSolver = require('../providers/RecordSet-DynamicSolver.js');
 
 /**
  * Represents a PictSectionRecordSetApplication.
@@ -20,6 +21,7 @@ class PictSectionRecordSetApplication extends libPictApplication
 		this.pict;
 		// Add the pict recordset meta controller service
 		this.pict.addServiceType('PictSectionRecordSet', libPictSectionRecordSet);
+		this.fable.addProviderSingleton('DynamicSolver', libDynamicSolver.default_configuration, libDynamicSolver);
 	}
 
 	onInitialize()

package/source/providers/RecordSet-DynamicSolver.js

@@ -0,0 +1,305 @@
+const libPictProvider = require('pict-provider');
+
+/** @type {Record<string, any>} */
+const _DefaultProviderConfiguration = (
+{
+	"ProviderIdentifier": "Pict-DynamicForms-Solver",
+
+	"AutoInitialize": true,
+	"AutoInitializeOrdinal": 0,
+
+	"AutoSolveWithApp": false
+});
+
+/**
+ * The PictDynamicSolver class is a provider that solves configuration-generated dynamic views.
+ */
+class RecordSetDynamicSolver extends libPictProvider
+{
+	/**
+	 * Creates an instance of the PictDynamicSolver class.
+	 *
+	 * @param {object} pFable - The fable object.
+	 * @param {object} pOptions - The options object.
+	 * @param {object} pServiceHash - The service hash object.
+	 */
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		let tmpOptions = Object.assign({}, JSON.parse(JSON.stringify(_DefaultProviderConfiguration)), pOptions);
+		super(pFable, tmpOptions, pServiceHash);
+
+		/** @type {import('pict') & {
+		 *		instantiateServiceProviderIfNotExists: (hash: string) => any,
+		 *		ExpressionParser: any,
+		 *		PictSectionRecordSet: InstanceType<import('../Pict-Section-RecordSet.js')>
+		 *	}} */
+		this.pict;
+		/** @type {import('pict') & { instantiateServiceProviderIfNotExists: (hash: string) => any, ExpressionParser: any }} */
+		this.fable;
+		/** @type {any} */
+		this.log;
+		/** @type {string} */
+		this.UUID;
+		/** @type {string} */
+		this.Hash;
+
+		// Initialize the solver service if it isn't up
+		this.fable.instantiateServiceProviderIfNotExists('ExpressionParser');
+	}
+
+	/**
+	 * Checks the solver and returns the solver object if it passes the checks.
+	 *
+	 * Automatically converts string solvers to have an Ordinal of 1.
+	 *
+	 * @param {string|object} pSolver - The solver to be checked. It can be either a string or an object.
+	 * @param {boolean} [pFiltered=false] - Indicates whether the solvers should be filtered.
+	 * @param {number} [pOrdinal] - The ordinal value to compare with the solver's ordinal value when filtered.
+	 * @returns {object|undefined} - The solver object if it passes the checks, otherwise undefined.
+	 */
+	checkSolver(pSolver, pFiltered, pOrdinal)
+	{
+		let tmpSolver = pSolver;
+		if (tmpSolver === undefined)
+		{
+			return;
+		}
+		if (typeof(tmpSolver) === 'string')
+		{
+			tmpSolver = {Expression:tmpSolver, Ordinal:1};
+		}
+		if (!('Expression' in tmpSolver))
+		{
+			this.log.error(`Dashboard solver ${pOrdinal} is missing the Expression property.`, { Solver: pSolver });
+			return;
+		}
+		if (!(`Ordinal` in tmpSolver))
+		{
+			tmpSolver.Ordinal = 1;
+		}
+
+		// This filters the solvers
+		if (pFiltered && (tmpSolver.Ordinal != pOrdinal))
+		{
+			return;
+		}
+
+		return tmpSolver;
+	}
+
+	/**
+	 * Runs each RecordSet solver formulae for a dynamic view group at a given ordinal.
+	 *
+	 * Or for all ordinals if no ordinal is passed.
+	 *
+	 * @param {import('manyfest')} pManifest - The manifest for the RecordSet.
+	 * @param {array} pCellSolverArray - An array of Solvers from the groups to solve.
+	 * @param {number} pOrdinal - The ordinal value to filter to.  Optional.
+	 * @param {Array<Record<string, any>>} pRecords - The records to solve against.
+	 */
+	executeCellSolvers(pManifest, pCellSolverArray, pOrdinal, pRecords)
+	{
+		// This is purely for readability of the code below ... uglify optimizes it out.
+		let tmpFiltered = (typeof(pOrdinal) === 'undefined') ? false : true;
+
+			// Solve the group RecordSet solvers first
+		for (let j = 0; j < pCellSolverArray.length; j++)
+		{
+			let tmpSolver = this.checkSolver(pCellSolverArray[j].Solver, tmpFiltered, pOrdinal);
+			if (typeof(tmpSolver) === 'undefined')
+			{
+				continue;
+			}
+
+			tmpSolver.StartTimeStamp = Date.now();
+			tmpSolver.Hash = `CellSolver-${j}`;
+
+			if (this.pict.LogNoisiness > 1)
+			{
+				this.log.trace(`Cell solving RecordSet ordinal ${tmpSolver.Ordinal} [${tmpSolver.Expression}]`);
+			}
+
+			const tmpRecords = Array.isArray(pRecords) ? pRecords : pRecords ? Object.values(pRecords) : [];
+			for (let l = 0; l < tmpRecords.length; l++)
+			{
+				let tmpRecord = tmpRecords[l];
+				tmpSolver.ResultsObject = {};
+				const tmpSolverRecord = this.buildCellContextRecord(tmpRecord, pRecords, pManifest);
+				let tmpSolutionValue = this.pict.ExpressionParser.solve(tmpSolver.Expression, tmpSolverRecord, tmpSolver.ResultsObject,
+					pManifest, tmpRecord);
+				if (this.pict.LogNoisiness > 1)
+				{
+					this.log.trace(`Cell solver [${tmpSolver.Expression}] record ${l} result was ${tmpSolutionValue}`);
+				}
+			}
+			tmpSolver.EndTimeStamp = Date.now();
+		}
+	}
+
+	/**
+	 * @param {Record<string, any>} pRecord - The record to build the context for.
+	 * @param {Array<Record<string, any>>} pRecords - The records to build the context from.
+	 * @param {import('manyfest')} pManifest - The manifest for the RecordSet.
+	 */
+	buildCellContextRecord(pRecord, pRecords, pManifest)
+	{
+		return Object.assign({}, pRecord, this.buildGlobalContextRecord(pRecords, pManifest));
+	}
+
+	/**
+	 * @param {Array<Record<string, any>>} pRecords - The records to build the context from.
+	 * @param {import('manyfest')} pManifest - The manifest for the RecordSet.
+	 */
+	buildGlobalContextRecord(pRecords, pManifest)
+	{
+		return {
+			Pict: this.pict,
+			AppData: this.pict.AppData,
+			RecordSubset: pRecords,
+			Manifest: pManifest,
+		};
+	}
+
+	/**
+	 * Executes the section solvers at a given ordinal (or all if no ordinal is passed).
+	 *
+	 * @param {import('manyfest')} pManifest - The manifest for the RecordSet.
+	 * @param {Array} pGlobalSolverArray - The array of view section solvers.
+	 * @param {number} pOrdinal - The ordinal value.
+	 * @param {Array<Record<string, any>>} pRecords - The records to solve against.
+	 */
+	executeDashboardSolvers(pManifest, pGlobalSolverArray, pOrdinal, pRecords)
+	{
+		let tmpFiltered = (typeof(pOrdinal) === 'undefined') ? false : true;
+
+		for (let i = 0; i < pGlobalSolverArray.length; i++)
+		{
+			let tmpSolver = this.checkSolver(pGlobalSolverArray[i].Solver, tmpFiltered, pOrdinal);
+			if (typeof(tmpSolver) === 'undefined')
+			{
+				continue;
+			}
+
+			tmpSolver.StartTimeStamp = Date.now();
+			tmpSolver.Hash = `DashboardSolver-${i}`;
+
+			// TODO: Precompile the solvers (it's super easy)
+			if (this.pict.LogNoisiness > 1)
+			{
+				this.log.trace(`Dashboard solving equation ${i} ordinal ${tmpSolver.Ordinal}`);
+			}
+			tmpSolver.ResultsObject = {};
+			const tmpRecord = this.buildGlobalContextRecord(pRecords, pManifest);
+			let tmpSolutionValue = this.pict.ExpressionParser.solve(tmpSolver.Expression, tmpRecord, tmpSolver.ResultsObject, pManifest, tmpRecord);
+			if (this.pict.LogNoisiness > 1)
+			{
+				this.log.trace(`[${tmpSolver.Expression}] result was ${tmpSolutionValue}`);
+			}
+			tmpSolver.EndTimeStamp = Date.now();
+		}
+	}
+
+	/**
+	 * Checks if the given ordinal exists in the provided ordinal set.
+	 *
+	 * If not, it adds the ordinal to the set.
+	 *
+	 * @param {number} pOrdinal - The ordinal to check.
+	 * @param {Object} pOrdinalSet - The ordinal set to check against.
+	 * @returns {Object} - The ordinal object from the ordinal set.
+	 */
+	checkAutoSolveOrdinal(pOrdinal, pOrdinalSet)
+	{
+		if (!(pOrdinal.toString() in pOrdinalSet))
+		{
+			pOrdinalSet[pOrdinal.toString()] = { DashboardSolvers:[], CellSolvers:[] };
+		}
+		return pOrdinalSet[pOrdinal];
+	}
+
+	/**
+	 * Solves the views based on the provided view hashes or all views in pict.
+	 *
+	 * If non-dynamic views are also passed in, they are solved as well.
+	 *
+	 * This algorithm is particularly complex because it solves views in
+	 * order across two dimensions:
+	 *
+	 * 1. The order of the views in the view hash array.
+	 * 2. Precedence order (based on Ordinal)
+	 *
+	 * The way it manages the precedence order solving is by enumerating the
+	 * view hash array multiple times until it exhausts the solution set.
+	 *
+	 * In dynamic views, when there are collisions in precedence order between
+	 * Section Solvers and Group RecordSet Solvers, it prefers the RecordSet
+	 * solvers first.  The thinking behind this is that a RecordSet solver is
+	 * a "tier down" from the core Section it resides within.  These are
+	 * leaves on the tree.
+	 *
+	 * @param {Record<string, any>} pManifestDefinition
+	 * @param {Array<Record<string, any>>} pRecords - The records to solve against.
+	 */
+	solveDashboard(pManifestDefinition, pRecords)
+	{
+		let tmpSolveOutcome = {};
+		tmpSolveOutcome.StartTimeStamp = Date.now();
+
+		let tmpOrdinalsToSolve = {};
+		tmpSolveOutcome.SolveOrdinals = tmpOrdinalsToSolve;
+		const tmpCellDefinitions = Object.values(pManifestDefinition.Descriptors);
+		for (const tmpCell of tmpCellDefinitions)
+		{
+			if (!Array.isArray(tmpCell?.PictDashboard?.Solvers))
+			{
+				continue;
+			}
+			for (const tmpRawSolver of tmpCell.PictDashboard.Solvers)
+			{
+				if (tmpRawSolver)
+				{
+					const tmpSolver = this.checkSolver(tmpRawSolver, false);
+					const tmpOrdinalContainer = this.checkAutoSolveOrdinal(tmpSolver.Ordinal, tmpOrdinalsToSolve);
+					tmpOrdinalContainer.CellSolvers.push({ CellHash: tmpCell.Hash, Solver:tmpSolver });
+				}
+			}
+		}
+		if (Array.isArray(pManifestDefinition.GlobalSolvers))
+		{
+			// Add the section solver(s)
+			for (const tmpRawSolver of pManifestDefinition.GlobalSolvers)
+			{
+				if (tmpRawSolver)
+				{
+					const tmpSolver = this.checkSolver(tmpRawSolver, false);
+					let tmpOrdinalContainer = this.checkAutoSolveOrdinal(tmpSolver.Ordinal, tmpOrdinalsToSolve);
+					tmpOrdinalContainer.DashboardSolvers.push({ Solver: tmpSolver });
+				}
+			}
+		}
+
+		// Now sort the ordinal container keys
+		let tmpOrdinalKeys = Object.keys(tmpOrdinalsToSolve);
+		tmpOrdinalKeys.sort();
+		const tmpManifest = this.pict.PictSectionRecordSet.getManifest(pManifestDefinition.Scope);
+		// Now enumerate the keys and solve each layer of the solution set
+		for (let i = 0; i < tmpOrdinalKeys.length; i++)
+		{
+			if (this.pict.LogNoisiness > 1)
+			{
+				this.log.trace(`DynamicSolver [${this.UUID}]::[${this.Hash}] Solving ordinal ${tmpOrdinalKeys[i]}`);
+			}
+			let tmpOrdinalContainer = tmpOrdinalsToSolve[tmpOrdinalKeys[i]];
+			this.executeCellSolvers(tmpManifest, tmpOrdinalContainer.CellSolvers, Number(tmpOrdinalKeys[i]), pRecords);
+			this.executeDashboardSolvers(tmpManifest, tmpOrdinalContainer.DashboardSolvers, Number(tmpOrdinalKeys[i]), pRecords);
+		}
+
+		tmpSolveOutcome.EndTimeStamp = Date.now();
+
+		// It's up to the developer to decide if they want to use this information somewhere.
+		this.lastSolveOutcome = tmpSolveOutcome;
+	}
+}
+
+module.exports = RecordSetDynamicSolver;
+module.exports.default_configuration = _DefaultProviderConfiguration;

package/source/providers/RecordSet-RecordProvider-Base.js

@@ -104,6 +104,20 @@ class RecordSetProviderBase extends libPictProvider
 		return { Records: [], Facets: { } };
 	}
 
+	/**
+	 * Read records from the provider.
+	 *
+	 * @param {RecordSetFilter} pOptions - Options for the read operation.
+	 *
+	 * @return {Promise<RecordSetResult>} - The result of the read operation.
+	 */
+	async getDecoratedRecords(pOptions)
+	{
+		const tmpRecords = await this.getRecords(pOptions);
+		await this.decorateCoreRecords(tmpRecords.Records);
+		return tmpRecords;
+	}
+
 	/**
 	 * Read records from the provider.
 	 *
@@ -133,6 +147,7 @@ class RecordSetProviderBase extends libPictProvider
 	 * Create a new record.
 	 *
 	 * @param {Record<string, any>} pRecord - The record to create.
+	 * @return {Promise<Record<string, any>>} - The created record.
 	 */
 	async createRecord(pRecord)
 	{
@@ -144,6 +159,7 @@ class RecordSetProviderBase extends libPictProvider
 	 * Update a record.
 	 *
 	 * @param {Record<string, any>} pRecord - The record to update.
+	 * @return {Promise<Record<string, any>>} - The updated record.
 	 */
 	async updateRecord(pRecord)
 	{
@@ -155,6 +171,7 @@ class RecordSetProviderBase extends libPictProvider
 	 * Delete a record.
 	 *
 	 * @param {Record<string, any>} pRecord - The record to delete.
+	 * @return {Promise<void>}
 	 */
 	async deleteRecord(pRecord)
 	{
@@ -188,6 +205,7 @@ class RecordSetProviderBase extends libPictProvider
 	 * Clone a record.
 	 *
 	 * @param {Record<string, any>} pRecord - The record to clone.
+	 * @return {Promise<Record<string, any>>} - The cloned record.
 	 */
 	async cloneRecord(pRecord)
 	{
@@ -211,6 +229,16 @@ class RecordSetProviderBase extends libPictProvider
 	{
 		return { };
 	}
+
+	/**
+	 * Abstract decoration method for core records. Subclasses should implement this method to decorate records with additional information.
+	 *
+	 * @param {Array<Record<string, any>>} pRecords - The records to decorate.
+	 * @return {Promise<void>}
+	 */
+	async decorateCoreRecords(pRecords)
+	{
+	}
 }
 
 module.exports = RecordSetProviderBase;