pict-section-form 1.1.8 → 1.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pict-section-form",
-    "version": "1.1.8",
+    "version": "1.1.9",
     "description": "Pict dynamic form sections",
     "main": "source/Pict-Section-Form.js",
     "directories": {
@@ -34,9 +34,9 @@
         "browser-env": "^3.3.0",
         "eslint": "^9.39.2",
         "jquery": "^4.0.0",
-        "pict": "^1.0.372",
+        "pict": "^1.0.373",
         "pict-application": "^1.0.34",
-        "pict-docuserve": "^1.4.4",
+        "pict-docuserve": "^1.4.19",
         "pict-service-commandlineutility": "^1.0.19",
         "quackage": "^1.3.0",
         "tui-grid": "^4.21.22",
@@ -47,7 +47,7 @@
         "fable-serviceproviderbase": "^3.0.19",
         "marked": "^4.3.0",
         "pict-provider": "^1.0.13",
-        "pict-section-excalidraw": "^1.0.2",
+        "pict-section-excalidraw": "^1.0.3",
         "pict-section-markdowneditor": "^1.0.17",
         "pict-section-tuigrid": "^1.0.31",
         "pict-template": "^1.0.15",

package/source/global.d.ts

@@ -3,6 +3,7 @@ declare global {
 		Chart: typeof import('chart.js').Chart;
 	}
 	var Chart: typeof import('chart.js').Chart;
+	var PictSectionExcalidrawVendor: any; //TODO: add types for: import('pict-section-excalidraw');
 }
 
 export {}

package/source/providers/inputs/Pict-Provider-Input-AutofillTriggerGroup.js

@@ -140,6 +140,16 @@ class CustomInputHandler extends libPictSectionInputExtension
 						if (Array.isArray(tmpGroupConfig.PostSolvers))
 						{
 							this.pict.providers.DynamicSolver.executeSolvers(pView, tmpGroupConfig.PostSolvers, `AutofillTriggerGroup hash ${tmpGroupConfig.TriggerGroupHash} post-trigger`);
+							const tmpMarshalScope = tmpGroupConfig.MarshalOnComplete;
+							if (tmpMarshalScope === true)
+							{
+								this.pict.views.PictFormMetacontroller.marshalToView();
+							}
+							else if (tmpMarshalScope)
+							{
+								this.pict.views.PictFormMetacontroller.marshalSectionToView(tmpMarshalScope.Section);
+								this.pict.views.PictFormMetacontroller.marshalInputToView(tmpMarshalScope.Input);
+							}
 						}
 					});
 					this.pict.views.PictFormMetacontroller.triggerGlobalInputEvent(
@@ -181,6 +191,16 @@ class CustomInputHandler extends libPictSectionInputExtension
 						if (Array.isArray(tmpGroupConfig.PostSolvers))
 						{
 							this.pict.providers.DynamicSolver.executeSolvers(pView, tmpGroupConfig.PostSolvers, `AutofillTriggerGroup hash ${tmpGroupConfig.TriggerGroupHash} tabular post-trigger`);
+							const tmpMarshalScope = tmpGroupConfig.MarshalOnComplete;
+							if (tmpMarshalScope === true)
+							{
+								this.pict.views.PictFormMetacontroller.marshalToView();
+							}
+							else if (tmpMarshalScope)
+							{
+								this.pict.views.PictFormMetacontroller.marshalSectionToView(tmpMarshalScope.Section);
+								this.pict.views.PictFormMetacontroller.marshalInputToView(tmpMarshalScope.Input);
+							}
 						}
 					});
 					this.pict.views.PictFormMetacontroller.triggerGlobalInputEvent(
@@ -254,6 +274,16 @@ class CustomInputHandler extends libPictSectionInputExtension
 			if (Array.isArray(tmpAutoFillTriggerGroup.PostSolvers))
 			{
 				this.pict.providers.DynamicSolver.executeSolvers(pView, tmpAutoFillTriggerGroup.PostSolvers, `AutofillTriggerGroup hash ${tmpAutoFillTriggerGroup.TriggerGroupHash} post-autofill`);
+				const tmpMarshalScope = tmpAutoFillTriggerGroup.MarshalOnComplete;
+				if (tmpMarshalScope === true)
+				{
+					this.pict.views.PictFormMetacontroller.marshalToView();
+				}
+				else if (tmpMarshalScope)
+				{
+					this.pict.views.PictFormMetacontroller.marshalSectionToView(tmpMarshalScope.Section);
+					this.pict.views.PictFormMetacontroller.marshalInputToView(tmpMarshalScope.Input);
+				}
 			}
 		}
 

package/source/providers/inputs/Pict-Provider-Input-Diagram.js

@@ -54,8 +54,25 @@ const _DefaultProviderConfiguration =
 	AutoSolveWithApp: false
 };
 
+/**
+ * @typedef {Object} Instance
+ * @property {string} mode - 'edit' or 'view'
+ * @property {string} slotID - The HTML ID of the content slot for this input
+ * @property {string} lastValue - The last known value (SVG string)
+ * @property {Object} viewInstance - The editor view instance (if in edit mode)
+ * @property {string} viewHash - The hash of the editor view (if in edit mode)
+ * @property {Object} input - The input definition object
+ */
+
 class PictInputDiagram extends libPictSectionInputExtension
 {
+	/**
+	 * Creates an instance of the PictInputExtensionProvider class.
+	 *
+	 * @param {import('pict')} pFable - The Pict instance.
+	 * @param {Record<string, any>} [pOptions] - The options for the provider.
+	 * @param {string} [pServiceHash] - The service hash for the provider.
+	 */
 	constructor(pFable, pOptions, pServiceHash)
 	{
 		let tmpOptions = Object.assign({}, JSON.parse(JSON.stringify(_DefaultProviderConfiguration)), pOptions);
@@ -65,6 +82,7 @@ class PictInputDiagram extends libPictSectionInputExtension
 		/** @type {any}            */ this.log;
 
 		// inputHash → { mode, slotID, lastValue (SVG string), viewInstance?, viewHash?, input }
+		/** @type {Record<String, Instance>} */
 		this._instances = {};
 
 		// Register the scoped CSS.
@@ -78,16 +96,36 @@ class PictInputDiagram extends libPictSectionInputExtension
 	// Helpers
 	// ----------------------------------------------------------------------------
 
+	/**
+	 * @param {string} pInputHTMLID - The RawHTMLID of the input.
+	 * @returns {string} The HTML ID selector for the content display slot corresponding to the input.
+	 */
 	getContentDisplayHTMLID(pInputHTMLID)
 	{
 		return `#DISPLAY-FOR-${pInputHTMLID}`;
 	}
 
+	/**
+	 * @param {string} pInputHTMLID - The RawHTMLID of the input.
+	 * @param {number} pRowIndex - The row index for tabular inputs.
+	 * @returns {string} The HTML ID selector for the content display slot corresponding to the tabular input.
+	 */
 	getTabularContentDisplayInputID(pInputHTMLID, pRowIndex)
 	{
 		return `#DISPLAY-FOR-TABULAR-${pInputHTMLID}-${pRowIndex}`;
 	}
 
+	/**
+	 * Resolve the value to use for display/editing, following this precedence:
+	 * 1. The provided pValue (if a non-empty string)
+	 * 2. The input's Content property (if a non-empty string)
+	 * 3. The input's Default property (if a non-empty string)
+	 * 4. An empty string if none of the above are valid
+	 *
+	 * @param {Object} pInput - The input definition object.
+	 * @param {any} pValue - The value provided for the input.
+	 * @returns {string} The resolved value to use for display/editing.
+	 */
 	_resolveValue(pInput, pValue)
 	{
 		if (typeof pValue === 'string' && pValue.length > 0) return pValue;
@@ -96,11 +134,20 @@ class PictInputDiagram extends libPictSectionInputExtension
 		return '';
 	}
 
+	/**
+	 * @param {any} pValue - The value to check.
+	 * @return {boolean} True if the value is a string that appears to contain an <svg> element, false otherwise.
+	 */
 	_isLikelySvg(pValue)
 	{
 		return (typeof pValue === 'string') && /<svg[\s>]/i.test(pValue);
 	}
 
+	/**
+	 * @param {string} pSlotID - The HTML ID of the content slot to assign.
+	 * @param {string} pHTML - The HTML string to assign to the slot.
+	 * @returns {boolean} True if the assignment was successful, false otherwise.
+	 */
 	_assignSlotContent(pSlotID, pHTML)
 	{
 		if (this.pict && this.pict.ContentAssignment &&
@@ -112,6 +159,11 @@ class PictInputDiagram extends libPictSectionInputExtension
 		return false;
 	}
 
+	/**
+	 * @param {string} pInputHTMLID - The RawHTMLID of the input whose hidden value field should be updated.
+	 * @param {string} pValue - The SVG string to set as the value of the hidden input field.
+	 * @returns {boolean} True if the value was successfully written and a change event dispatched, false otherwise.
+	 */
 	_writeHiddenInputValue(pInputHTMLID, pValue)
 	{
 		let tmpEl = (typeof document !== 'undefined') ? document.getElementById(pInputHTMLID) : null;
@@ -131,6 +183,9 @@ class PictInputDiagram extends libPictSectionInputExtension
 	/**
 	 * Wrap an SVG string in a thin <div> for the view-mode slot. If the value
 	 * is empty or not an SVG, show an "(empty)" placeholder.
+	 *
+	 * @param {string} pValue - The SVG string to wrap for display.
+	 * @returns {string} The HTML string to assign to the view slot.
 	 */
 	_buildViewHTML(pValue)
 	{
@@ -141,6 +196,10 @@ class PictInputDiagram extends libPictSectionInputExtension
 		return `<div class="pict-section-form-diagram-view is-empty">(empty diagram)</div>`;
 	}
 
+	/**
+	 * @param {Object} pInput - The input definition object.
+	 * @param {string} pMode - The mode to set ('edit' or 'view').
+	 */
 	_setSlotModeClass(pInput, pMode)
 	{
 		if (typeof document === 'undefined') return;
@@ -494,13 +553,41 @@ class PictInputDiagram extends libPictSectionInputExtension
 		return super.onInputInitialize(pView, pGroup, pRow, pInput, pValue, pHTMLSelector, pTransactionGUID);
 	}
 
+	/**
+	 * A tabular input has been initialized (rendered into the DOM)
+	 *
+	 * Called when an input has this Provider hash in its 'Providers' array.
+	 *
+	 * @param {Object} pView - The view object.
+	 * @param {Object} pGroup - The group definition object.
+	 * @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
+	 *
+	 * @return {boolean}
+	 */
 	onInputInitializeTabular(pView, pGroup, pInput, pValue, pHTMLSelector, pRowIndex, pTransactionGUID)
 	{
+		super.onInputInitializeTabular(pView, pGroup, pInput, pValue, pHTMLSelector, pRowIndex, pTransactionGUID);
 		let tmpErr = new Error('Diagram InputType is not supported inside Tabular rows in Phase 1.');
 		if (this.log) this.log.warn('[Pict-Input-Diagram] tabular not supported', { inputHash: pInput && pInput.Hash });
 		throw tmpErr;
 	}
 
+	/**
+	 * Fires when data is marshaled to the form for this input.
+	 *
+	 * @param {Object} pView - The view object.
+	 * @param {Object} pGroup - The group definition object.
+	 * @param {number} pRow - The Row index.
+	 * @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, pGroup, pRow, pInput, pValue, pHTMLSelector, pTransactionGUID)
 	{
 		let tmpInst = this._instances[pInput.Hash];

package/source/providers/inputs/Pict-Provider-Input-EntityBundleRequest.js

@@ -317,7 +317,17 @@ class CustomInputHandler extends libPictSectionInputExtension
 						{
 							if (Array.isArray(tmpGroupConfig.PostSolvers))
 							{
-								this.pict.providers.DynamicSolver.executeSolvers(pView, tmpGroupConfig.PostSolvers, `EntityBundleTriggerGroup hash ${tmpGroupConfig.TriggerGroupHash} tabular post-trigger`);
+								this.pict.providers.DynamicSolver.executeSolvers(pView, tmpGroupConfig.PostSolvers, `EntityBundleTriggerGroup hash ${tmpGroupConfig.TriggerGroupHash} post-trigger`);
+								const tmpMarshalScope = tmpGroupConfig.MarshalOnComplete;
+								if (tmpMarshalScope === true)
+								{
+									this.pict.views.PictFormMetacontroller.marshalToView();
+								}
+								else if (tmpMarshalScope)
+								{
+									this.pict.views.PictFormMetacontroller.marshalSectionToView(tmpMarshalScope.Section);
+									this.pict.views.PictFormMetacontroller.marshalInputToView(tmpMarshalScope.Input);
+								}
 							}
 						});
 					}

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

@@ -1193,6 +1193,65 @@ class PictFormMetacontroller extends libPictViewClass
 		return false;
 	}
 
+	/**
+	 * Marshal one or more section views' data to the DOM.
+	 *
+	 * For values written outside the normal solve -> marshal cycle (e.g. a trigger group's `PostSolvers`
+	 * running in an EntityBundleRequest transaction-complete callback). The global equivalent is
+	 * `marshalToView()`; this is the section-scoped, cheaper option.
+	 *
+	 * @param {string|string[]} pSectionHashes - a section hash, or an array of section hashes
+	 * @returns {void}
+	 */
+	marshalSectionToView(pSectionHashes)
+	{
+		const tmpSectionHashes = (Array.isArray(pSectionHashes) ? pSectionHashes : [ pSectionHashes ]).filter((pHash) => typeof pHash === 'string' && pHash.length > 0);
+		for (const tmpSectionHash of tmpSectionHashes)
+		{
+			const tmpSectionView = this.getSectionViewFromHash(tmpSectionHash);
+			if (tmpSectionView)
+			{
+				tmpSectionView.marshalToView();
+			}
+		}
+	}
+
+	/**
+	 * Marshal one or more inputs' data to the DOM, wherever they live (finds the owning section view).
+	 *
+	 * The single-input equivalent of {@link marshalSectionToView}; use it when only specific fields
+	 * changed (e.g. a trigger group that computed one read-only attribute).
+	 *
+	 * @param {string|string[]} pInputHashes - an input hash, or an array of input hashes
+	 * @returns {void}
+	 */
+	marshalInputToView(pInputHashes)
+	{
+		const tmpInputHashes = (Array.isArray(pInputHashes) ? pInputHashes : [ pInputHashes ]).filter((pHash) => typeof pHash === 'string' && pHash.length > 0);
+		if (tmpInputHashes.length < 1)
+		{
+			return;
+		}
+		const tmpSectionViews = this.filterViews();
+		for (const tmpInputHash of tmpInputHashes)
+		{
+			for (let i = 0; i < tmpSectionViews.length; i++)
+			{
+				const tmpSectionView = tmpSectionViews[i];
+				if (tmpSectionView === this || typeof tmpSectionView.getInputFromHash !== 'function')
+				{
+					continue;
+				}
+				const tmpInput = tmpSectionView.getInputFromHash(tmpInputHash);
+				if (tmpInput)
+				{
+					tmpSectionView.manualMarshalDataToViewByInput(tmpInput);
+					break;
+				}
+			}
+		}
+	}
+
 	/**
 	 * Clears out the manifest description set on the meta controller.
 	 */

package/test/Pict-View-Form-Metacontroller-Marshal_tests.js

@@ -0,0 +1,100 @@
+/*
+	Unit tests for PictFormMetacontroller.marshalSectionToView / marshalInputToView.
+
+	Both take a primitive (hash) or an array of hashes, look up the owning view, and marshal — the
+	scoped, solver-friendly alternatives to the global marshalToView(). Exercised against a stub `this`
+	so we don't need to mount a full form. Used by trigger-group `MarshalOnComplete` after PostSolvers
+	that ran outside the normal solve -> marshal cycle.
+*/
+
+const Chai   = require('chai');
+const Expect = Chai.expect;
+
+const libMetacontroller   = require('../source/views/Pict-View-Form-Metacontroller.js');
+const marshalSectionToView = libMetacontroller.prototype.marshalSectionToView;
+const marshalInputToView   = libMetacontroller.prototype.marshalInputToView;
+
+suite('PictFormMetacontroller marshal scoping', () =>
+{
+	suite('marshalSectionToView', () =>
+	{
+		function buildStub()
+		{
+			const tmpMarshaled = [];
+			const tmpStub =
+			{
+				getSectionViewFromHash: (pHash) => (pHash === 'missing' ? false : { marshalToView: () => { tmpMarshaled.push(pHash); } }),
+			};
+			return { stub: tmpStub, marshaled: tmpMarshaled };
+		}
+
+		test('a single hash marshals that section view', () =>
+		{
+			const { stub, marshaled } = buildStub();
+			marshalSectionToView.call(stub, 'H');
+			Expect(marshaled).to.deep.equal([ 'H' ]);
+		});
+
+		test('an array marshals each section view', () =>
+		{
+			const { stub, marshaled } = buildStub();
+			marshalSectionToView.call(stub, [ 'A', 'B' ]);
+			Expect(marshaled).to.deep.equal([ 'A', 'B' ]);
+		});
+
+		test('non-string / empty hashes are filtered; a missing view is skipped without throwing', () =>
+		{
+			const { stub, marshaled } = buildStub();
+			Expect(() => marshalSectionToView.call(stub, [ 'A', '', null, 7, 'missing' ])).to.not.throw();
+			Expect(marshaled).to.deep.equal([ 'A' ]);
+		});
+
+		test('undefined is a no-op', () =>
+		{
+			const { stub, marshaled } = buildStub();
+			marshalSectionToView.call(stub, undefined);
+			Expect(marshaled).to.have.length(0);
+		});
+	});
+
+	suite('marshalInputToView', () =>
+	{
+		function buildStub()
+		{
+			const tmpMarshaled = [];
+			const tmpStub =
+			{
+				_views:
+				[
+					{ getInputFromHash: () => null, manualMarshalDataToViewByInput: () => { throw new Error('non-owner view should not marshal'); } },
+					{ getInputFromHash: (pHash) => (pHash === 'X' ? { Hash: 'X' } : null), manualMarshalDataToViewByInput: (pInput) => { tmpMarshaled.push(pInput.Hash); } },
+				],
+				filterViews: () => tmpStub._views,
+			};
+			return { stub: tmpStub, marshaled: tmpMarshaled };
+		}
+
+		test('marshals the input on its owning section view only', () =>
+		{
+			const { stub, marshaled } = buildStub();
+			marshalInputToView.call(stub, 'X');
+			Expect(marshaled).to.deep.equal([ 'X' ]);
+		});
+
+		test('an input that lives nowhere is a no-op', () =>
+		{
+			const { stub, marshaled } = buildStub();
+			marshalInputToView.call(stub, 'Nope');
+			Expect(marshaled).to.have.length(0);
+		});
+
+		test('undefined / empty does not even enumerate views', () =>
+		{
+			let tmpEnumerated = false;
+			const tmpStub = { filterViews: () => { tmpEnumerated = true; return []; } };
+			marshalInputToView.call(tmpStub, undefined);
+			marshalInputToView.call(tmpStub, [ '', null ]);
+			Expect(tmpEnumerated).to.equal(false);
+		});
+	});
+});

package/types/source/Pict-Section-Form.d.ts

@@ -15,6 +15,9 @@ declare const _exports: {
         LifecycleVisualization: typeof import("./views/support/Pict-View-PSF-LifeCycle-Visualization.js");
         DebugViewer: typeof import("./views/support/Pict-View-PSF-DebugViewer.js");
     };
+    RichTextInput: typeof import("./providers/inputs/Pict-Provider-Input-RichText.js");
+    DiagramInput: typeof import("./providers/inputs/Pict-Provider-Input-Diagram.js");
+    themeifySVG: (pSVG: string, pPaletteOrProfile?: object) => string;
 };
 export = _exports;
 //# sourceMappingURL=Pict-Section-Form.d.ts.map

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

@@ -15,6 +15,10 @@ declare class PictDynamicFormsSolverBehaviors extends libPictProvider {
     /** @type {string} */
     cssHideSectionClass: string;
     cssHideGroupClass: string;
+    /** @type {string} */
+    cssTabularRowHighlightClass: string;
+    /** @type {string} */
+    cssTabularColumnHighlightClass: string;
     cssSnippet: string;
     solverOrdinalMap: {};
     setCSSSnippets(pCSSHideClass: any, pCSSSnippet: any): void;
@@ -150,6 +154,82 @@ declare class PictDynamicFormsSolverBehaviors extends libPictProvider {
      * @returns {boolean}
      */
     colorElementBackground(pElementSet: Array<HTMLElement>, pColor: string, pCSSSelector?: string): boolean;
+    /**
+     * Interprets a solver-supplied 1/0 (or true/false) flag.
+     *
+     * Solver numbers arrive as arbitrary-precision strings, so a plain truthiness
+     * check would treat the string "0" as true. This normalizes the common
+     * "off" representations to false and everything else to true.
+     *
+     * @param {any} pFlag
+     * @returns {boolean}
+     */
+    isSolverFlagEnabled(pFlag: any): boolean;
+    /**
+     * Resolves the DOM selector for a tabular group's container div.
+     *
+     * The tabular group div carries `id="GROUP-<formID>-<groupHash>"` (the same
+     * convention the non-tabular group layout uses), so highlight/color solvers
+     * can scope their cell queries to a single group.
+     *
+     * @param {string} pSectionHash - The hash of the section containing the group.
+     * @param {string} pGroupHash - The hash of the tabular group.
+     * @returns {string|null} A CSS selector for the group container, or null if unresolved.
+     */
+    getTabularGroupSelector(pSectionHash: string, pGroupHash: string): string | null;
+    /**
+     * Adds (pApplyFlag truthy) or removes (pApplyFlag falsy) a highlight class on
+     * every cell of a tabular row -- the row labels, editing controls and data
+     * cells all get the class because it lands on the row's `<tr>`.
+     *
+     * @param {string} pSectionHash - The hash of the section containing the tabular group.
+     * @param {string} pGroupHash - The hash of the tabular group.
+     * @param {number|string} pRowIndex - The zero-based row index.
+     * @param {number|string|boolean} pApplyFlag - 1/0 (or true/false) -- add or remove the class.
+     * @param {string} [pHighlightClass] - Optional override for the class name.
+     * @returns {boolean}
+     */
+    highlightTabularRow(pSectionHash: string, pGroupHash: string, pRowIndex: number | string, pApplyFlag: number | string | boolean, pHighlightClass?: string): boolean;
+    /**
+     * Adds (pApplyFlag truthy) or removes (pApplyFlag falsy) a highlight class on
+     * every cell of a tabular column -- both the `<th>` header cell and every
+     * `<td>` data cell that carries the matching `data-tabular-column-index`.
+     *
+     * @param {string} pSectionHash - The hash of the section containing the tabular group.
+     * @param {string} pGroupHash - The hash of the tabular group.
+     * @param {number|string} pColumnIndex - The column's input index (descriptor InputIndex).
+     * @param {number|string|boolean} pApplyFlag - 1/0 (or true/false) -- add or remove the class.
+     * @param {string} [pHighlightClass] - Optional override for the class name.
+     * @returns {boolean}
+     */
+    highlightTabularColumn(pSectionHash: string, pGroupHash: string, pColumnIndex: number | string, pApplyFlag: number | string | boolean, pHighlightClass?: string): boolean;
+    /**
+     * Sets (pApplyFlag truthy) or clears (pApplyFlag falsy) an inline background
+     * color on every data cell of a tabular row.
+     *
+     * The color is applied with `important` priority so it beats both host
+     * table-striping CSS and the highlight classes.
+     *
+     * @param {string} pSectionHash - The hash of the section containing the tabular group.
+     * @param {string} pGroupHash - The hash of the tabular group.
+     * @param {number|string} pRowIndex - The zero-based row index.
+     * @param {string} pColor - The HTML color to apply (e.g. #FF0000).
+     * @param {number|string|boolean} pApplyFlag - 1/0 (or true/false) -- apply or clear the color.
+     * @returns {boolean}
+     */
+    colorTabularRow(pSectionHash: string, pGroupHash: string, pRowIndex: number | string, pColor: string, pApplyFlag: number | string | boolean): boolean;
+    /**
+     * Sets (pApplyFlag truthy) or clears (pApplyFlag falsy) an inline background
+     * color on every cell of a tabular column -- header `<th>` plus all data `<td>`.
+     *
+     * @param {string} pSectionHash - The hash of the section containing the tabular group.
+     * @param {string} pGroupHash - The hash of the tabular group.
+     * @param {number|string} pColumnIndex - The column's input index (descriptor InputIndex).
+     * @param {string} pColor - The HTML color to apply (e.g. #FF0000).
+     * @param {number|string|boolean} pApplyFlag - 1/0 (or true/false) -- apply or clear the color.
+     * @returns {boolean}
+     */
+    colorTabularColumn(pSectionHash: string, pGroupHash: string, pColumnIndex: number | string, pColor: string, pApplyFlag: number | string | boolean): boolean;
     /**
      * Gets a value from the global form data by hash, falling back to address resolution
      * using the global manyfest from the metacontroller.
@@ -191,6 +271,41 @@ declare class PictDynamicFormsSolverBehaviors extends libPictProvider {
      */
     getSectionTabularFormData(pSectionHash: string, pGroupHash: string, pRowIndex: number | string, pHashOrAddress: string): any;
     logValues(...args: any[]): any;
+    /**
+     * Resolves the comprehension destination object, creating intermediate objects along the configured
+     * address if they don't exist.  The address is read from
+     * `PictFormMetacontroller.comprehensionDestinationAddress` (default `AppData.FormEntityComprehensions`)
+     * and resolved against the pict instance, so callers can target any subtree (`AppData.*`, `Bundle.*`, ...).
+     *
+     * @returns {Record<string, any>|null} The destination object (mutable), or null if the address resolves
+     * to a non-object value the function can't safely write into (e.g. a number).
+     */
+    resolveComprehensionDestination(): Record<string, any> | null;
+    /**
+     * Writes a single property/value into the configured comprehension destination, nested as
+     * `Context -> Entity -> GUID -> Property = Value`.
+     *
+     * `Context` is a manyfest address (dot-separated) so dotted contexts like
+     * `OnApprovalAction.Approve` produce nested context branches.  `Entity`, `GUID`, and `Property`
+     * are treated as opaque property names -- dots in them are NOT interpreted as nesting (so an
+     * entity GUID like `0x73278432987` lands as a single key).
+     *
+     * Successive calls to the same `(Context, Entity, GUID)` accumulate properties on the same
+     * record.  Successive calls to the same `(Context, Entity, GUID, Property)` overwrite.
+     *
+     * The destination address is configured on the metacontroller via
+     * `comprehensionDestinationAddress` (default `AppData.FormEntityComprehensions`) -- see
+     * `docs/Comprehensions.md`.
+     *
+     * @param {string} pContext - The comprehension context address (e.g. `"OnSave"`, `"OnApprovalAction.Approve"`).
+     * @param {string} pEntity - The entity name (e.g. `"Book"`).
+     * @param {string} pGUID - The external GUID for the record (e.g. `"0x73278432987"`).
+     * @param {string} pProperty - The property to set on the record (e.g. `"Title"`).
+     * @param {any} pValue - The value to write.
+     *
+     * @returns {any} `pValue` on success, `undefined` if the call was a no-op (invalid args / unwritable destination).
+     */
+    addComprehensionEntity(pContext: string, pEntity: string, pGUID: string, pProperty: string, pValue: any): any;
 }
 declare namespace PictDynamicFormsSolverBehaviors {
     export { _DefaultProviderConfiguration as default_configuration };

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;IAeE,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;IAE3H,qBAA0B;IAK3B,2DAMC;IAJA,kBAAsD;IAMvD,iJAkBC;IAED,mBAiBC;IAED,iDAsCC;IAGD;;;;;;OAMG;IACH,mDAqBC;IAED;;;;;;OAMG;IACH,wDAkCC;IAED;;;;;OAKG;IACH,kCAaC;IAED;;;;;;OAMG;IACH,gCAQC;IAED;;;OAGG;IACH,wCAHW,MAAM,GAAC,MAAM,YACb,OAAO,GAAC,MAAM,GAAC,MAAM,QAK/B;IAED;;OAEG;IACH,oCAFW,MAAM,GAAC,MAAM,QAKvB;IAED;;OAEG;IACH,qCAFW,MAAM,GAAC,MAAM,QAKvB;IAED;;;;OAIG;IACH,yCAJW,MAAM,GAAC,MAAM,GAEZ,OAAO,CAMlB;IAED,gDAGC;IAED,gEAUC;IAED;;;;;;;OAOG;IACH,gCAFW,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAShC;IAED;;;;;;;OAOG;IACH,gCAFW,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAShC;IAGD,wCAiBC;IAED,wCAiBC;IAED,+DAGC;IAED,+EAUC;IAED,uDAiBC;IAED,uDAiBC;IAED;;;;;;;OAOG;IACH,oCALW,MAAM,cACN,MAAM,GAEL,IAAI,CAoDf;IAED;;;;;;;OAOG;IACH,kCANW,MAAM,cACN,MAAM,WACN,MAAM,GAAC,MAAM,qBACb,OAAO,GAAC,MAAM,WAoDxB;IAGD,iEAqBC;IAED,mFA2BC;IAED,kGA0BC;IAED;;;;;;;;OAQG;IACH,mCAPW,MAAM,cACN,MAAM,UACN,MAAM,gBACN,MAAM,iBACN,MAAM,GACJ,OAAO,CAwCnB;IAED;;;;;;;;;;;OAWG;IACH,0CAVW,MAAM,cACN,MAAM,cAEN,MAAM,aADN,MAAM,UAEN,MAAM,gBACN,MAAM,iBACN,MAAM,qBACN,MAAM,GACJ,OAAO,CAiDnB;IAED;;;;;;OAMG;IACH,oCANW,KAAK,CAAC,WAAW,CAAC,UAClB,MAAM,iBACN,MAAM,GAEJ,OAAO,CA2BnB;IAED;;;;;;OAMG;IACH,yBAHW,MAAM,GACJ,GAAG,CAoBf;IAED;;;;;;OAMG;IACH,gCAHW,MAAM,GACJ,GAAG,CAoBf;IAED;;;;;;;;;OASG;IACH,iCAJW,MAAM,kBACN,MAAM,GACJ,GAAG,CAkBf;IAED;;;;;;;;;;;OAWG;IACH,wCANW,MAAM,cACN,MAAM,aACN,MAAM,GAAC,MAAM,kBACb,MAAM,GACJ,GAAG,CAwEf;IAED,+BAWC;CACD;;;;;AAt7BD,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":"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"}

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

@@ -97,6 +97,30 @@ declare class DynamicTabularData extends libPictProvider {
      * @returns {boolean} - Returns true if the row was successfully deleted, false otherwise.
      */
     deleteDynamicTableRow(pView: any, pGroupIndex: number, pRowIndex: number | string): boolean;
+    /**
+     * Rebuild every OTHER section-form view whose DynamicColumns are sourced from
+     * pSourceRecordSetAddress: re-resolve their generated columns and rebuild their
+     * template + DOM. Call this in the RENDER phase (after a source row was added or
+     * removed, before solving + marshaling) so dependent tables paint their column
+     * changes up front instead of mid-marshal. Idempotent and safe when there are no
+     * dependent views (it simply finds none).
+     *
+     * @param {string} pSourceRecordSetAddress - RecordSetAddress whose rows drive the columns.
+     */
+    _rebuildDependentDynamicColumnViews(pSourceRecordSetAddress: string): void;
+    /**
+     * For position-keyed DynamicColumns (KeyBy: "Position") sourced from
+     * pSourceRecordSetAddress, shift each dependent row's positional cells down past
+     * a just-removed source index so values stay aligned with their column. Cells are
+     * addressed by resolving the generator's InformaryDataAddressTemplate with the
+     * synthetic { __Index } record, the same way columns are generated. No-op for
+     * value-keyed generators (their data stays attached to the stable value).
+     *
+     * @param {string} pSourceRecordSetAddress - RecordSetAddress of the deleted-from source.
+     * @param {number} pDeletedIndex - Index of the source row that was removed.
+     * @param {number} pOriginalLength - Source row count BEFORE the removal.
+     */
+    _spliceDependentPositionalColumns(pSourceRecordSetAddress: string, pDeletedIndex: number, pOriginalLength: number): void;
 }
 declare namespace DynamicTabularData {
     export { _DefaultProviderConfiguration as default_configuration, ElementDescriptor };

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

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-DynamicTabularData.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicTabularData.js"],"names":[],"mappings":";AAaA;;;GAGG;AAEH;;GAEG;AACH;IAcE,kBAAkB;IAClB,SADW,GAAG,CACF;IACZ,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAKV;;;;;;OAMG;IACH,6CAHW,MAAM,GACJ,cAAa,OAAO,CAehC;IAED;;;;;;;OAOG;IACH,+CAJW,MAAM,eACN,MAAM,GACJ,iBAAiB,GAAC,OAAO,CAiBrC;IAED;;;;;;;OAOG;IACH,oDAJW,MAAM,cACN,MAAM,GACJ,iBAAiB,GAAC,OAAO,CA+BrC;IAED;;;;;;;OAOG;IACH,8CAJW,MAAM,kBACN,MAAM,GACJ,OAAO,MAAO,CAkD1B;IAED;;;;;OAKG;IACH,+CAFW,MAAM,QA4DhB;IAGD;;;;;OAKG;IACH,4DAFW,MAAM,QAyBhB;IAED;;;;;;;;OAQG;IACH,iDALW,MAAM,aACN,MAAM,GAAC,MAAM,gBACb,MAAM,GACJ,OAAO,CA4BnB;IAED;;;;;;;OAOG;IACH,iDAJW,MAAM,aACN,MAAM,GAAC,MAAM,GACX,OAAO,CA2BnB;IAED;;;;;;;OAOG;IACH,+CAJW,MAAM,aACN,MAAM,GAAC,MAAM,GACX,OAAO,CAgCnB;IAGD;;;;;;;OAOG;IACH,+CAJW,MAAM,aACN,MAAM,GAAC,MAAM,GACX,OAAO,CA2DnB;CACD;;;;;AA9cD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B;;;;;UAIW,MAAM"}
+{"version":3,"file":"Pict-Provider-DynamicTabularData.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicTabularData.js"],"names":[],"mappings":";AAaA;;;GAGG;AAEH;;GAEG;AACH;IAcE,kBAAkB;IAClB,SADW,GAAG,CACF;IACZ,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAKV;;;;;;OAMG;IACH,6CAHW,MAAM,GACJ,cAAa,OAAO,CAehC;IAED;;;;;;;OAOG;IACH,+CAJW,MAAM,eACN,MAAM,GACJ,iBAAiB,GAAC,OAAO,CAiBrC;IAED;;;;;;;OAOG;IACH,oDAJW,MAAM,cACN,MAAM,GACJ,iBAAiB,GAAC,OAAO,CA+BrC;IAED;;;;;;;OAOG;IACH,8CAJW,MAAM,kBACN,MAAM,GACJ,OAAO,MAAO,CAkD1B;IAED;;;;;OAKG;IACH,+CAFW,MAAM,QAqEhB;IAGD;;;;;OAKG;IACH,4DAFW,MAAM,QAyBhB;IAED;;;;;;;;OAQG;IACH,iDALW,MAAM,aACN,MAAM,GAAC,MAAM,gBACb,MAAM,GACJ,OAAO,CA4BnB;IAED;;;;;;;OAOG;IACH,iDAJW,MAAM,aACN,MAAM,GAAC,MAAM,GACX,OAAO,CA2BnB;IAED;;;;;;;OAOG;IACH,+CAJW,MAAM,aACN,MAAM,GAAC,MAAM,GACX,OAAO,CAgCnB;IAGD;;;;;;;OAOG;IACH,+CAJW,MAAM,aACN,MAAM,GAAC,MAAM,GACX,OAAO,CA6EnB;IAED;;;;;;;;;OASG;IACH,6DAFW,MAAM,QAqDhB;IAED;;;;;;;;;;;OAWG;IACH,2DAJW,MAAM,iBACN,MAAM,mBACN,MAAM,QAoFhB;CACD;;;;;AAxoBD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B;;;;;UAIW,MAAM"}

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

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-DynamicTemplates.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicTemplates.js"],"names":[],"mappings":";AAiCA;;;GAGG;AACH;IAeE,kBAAkB;IAClB,SADW,GAAG,CACF;IACZ,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IA6BV;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,2CA4DC;CACD;;;;;AAhJD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}
+{"version":3,"file":"Pict-Provider-DynamicTemplates.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-DynamicTemplates.js"],"names":[],"mappings":";AAmCA;;;GAGG;AACH;IAeE,kBAAkB;IAClB,SADW,GAAG,CACF;IACZ,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IA+BV;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,2CA4DC;CACD;;;;;AAlJD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}

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;IAWE,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAKV,oDAYC;IAED,sGAwBC;IAED,6HAwBC;IAGD;;;;;;;;;OASG;IACH,8CALW,GAAG,iBACH,MAAM,oBACN,MAAM,GACJ,GAAG,CA8Bf;IAED;;;;;;;;;;OAUG;IACH,qDANW,GAAG,iBACH,MAAM,aACN,MAAM,oBACN,MAAM,GACJ,GAAG,CA8Bf;CAkJD"}
+{"version":3,"file":"Pict-Provider-Input-AutofillTriggerGroup.d.ts","sourceRoot":"","sources":["../../../../source/providers/inputs/Pict-Provider-Input-AutofillTriggerGroup.js"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAWE,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAKV,oDAYC;IAED,sGAwBC;IAED,6HAwBC;IAGD;;;;;;;;;OASG;IACH,8CALW,GAAG,iBACH,MAAM,oBACN,MAAM,GACJ,GAAG,CAwCf;IAED;;;;;;;;;;OAUG;IACH,qDANW,GAAG,iBACH,MAAM,aACN,MAAM,oBACN,MAAM,GACJ,GAAG,CAwCf;CA4JD"}

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

@@ -0,0 +1,3 @@
+declare const _exports: string;
+export = _exports;
+//# sourceMappingURL=Pict-Provider-Input-Diagram-CSS.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Pict-Provider-Input-Diagram-CSS.d.ts","sourceRoot":"","sources":["../../../../source/providers/inputs/Pict-Provider-Input-Diagram-CSS.js"],"names":[],"mappings":""}