pict-section-recordset 1.1.0 → 1.3.0

package/source/views/read/RecordSet-Read.js

@@ -1,5 +1,11 @@
 const libPictRecordSetRecordView = require('../RecordSet-RecordBaseView.js');
 
+// Identity + audit field names stamped on (virtually) every Meadow entity. These are
+// surfaced through the record audit header (the first-class activity line + the Details
+// modal), not inline in the record body. The entity's own ID/GUID field names are added
+// at suppression time via the provider's getIDField()/getGUIDField().
+const _AUDIT_FIELD_NAMES = ['CreatingIDUser', 'UpdatingIDUser', 'DeletingIDUser', 'Deleted', 'CreateDate', 'UpdateDate', 'DeleteDate'];
+
 /** @type {Record<string, any>} */
 const _DEFAULT_CONFIGURATION__Read = (
 	{
@@ -22,7 +28,32 @@ const _DEFAULT_CONFIGURATION__Read = (
 		AutoSolveWithApp: false,
 		AutoSolveOrdinal: 0,
 
-		CSS: false,
+		CSS: /*css*/`
+			.prsp-audit-header { display: flex; align-items: center; justify-content: space-between; gap: 1rem; flex-wrap: wrap; margin: 0 0 1rem; }
+			.prsp-audit-line { display: inline-flex; align-items: center; gap: 0.4rem; color: var(--theme-color-text-muted, #6b7686); font-size: 0.85rem; }
+			.prsp-audit-line .pict-icon { font-size: 0.8rem; }
+			.prsp-audit-line strong { color: var(--theme-color-text-secondary, #45505f); font-weight: 600; }
+			.prsp-audit-button { display: inline-flex; align-items: center; gap: 0.4rem; border: 1px solid var(--theme-color-border-default, #d7dce3); background: var(--theme-color-background-primary, #fff); color: var(--theme-color-text-muted, #6b7686); border-radius: 8px; padding: 0.35rem 0.65rem; font: inherit; font-size: 0.82rem; cursor: pointer; transition: all 0.15s ease; }
+			.prsp-audit-button:hover { border-color: var(--theme-color-brand-primary, #156dd1); color: var(--theme-color-brand-primary, #156dd1); }
+			.prsp-record-related:empty { display: none; }
+			.prsp-audit-anchor { position: relative; }
+			.prsp-audit-popover { position: absolute; top: calc(100% + 8px); right: 0; min-width: 320px; max-width: 90vw; background: var(--theme-color-background-panel, #fff); border: 1px solid var(--theme-color-border-default, #d7dce3); border-radius: 10px; box-shadow: 0 14px 36px rgba(15, 23, 42, 0.18); padding: 1rem 1.1rem; z-index: 40; display: none; }
+			.prsp-audit-popover.is-open { display: block; }
+			.prsp-audit-dl { display: grid; grid-template-columns: auto 1fr; gap: 0.6rem 1rem; align-items: baseline; margin: 0; }
+			.prsp-audit-dl dt { color: var(--theme-color-text-muted, #6b7686); font-size: 0.74rem; text-transform: uppercase; letter-spacing: 0.03em; white-space: nowrap; }
+			.prsp-audit-dl dd { margin: 0; color: var(--theme-color-text-primary, #1f2733); font-size: 0.9rem; }
+			.prsp-audit-dl dd small { color: var(--theme-color-text-muted, #6b7686); }
+			.prsp-audit-dl dd.is-deleted { color: var(--theme-color-status-error, #b62828); }
+			.prsp-audit-guid { display: inline-flex; align-items: center; gap: 0.4rem; }
+			.prsp-audit-guid code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0.8rem; color: var(--theme-color-text-secondary, #45505f); background: var(--theme-color-background-secondary, #f5f6f8); padding: 0.1rem 0.4rem; border-radius: 5px; }
+			.prsp-audit-copy { border: 0; background: transparent; color: var(--theme-color-text-muted, #6b7686); cursor: pointer; padding: 0.1rem 0.3rem; border-radius: 4px; font-size: 0.85rem; }
+			.prsp-audit-copy:hover { color: var(--theme-color-brand-primary, #156dd1); }
+			/* Tufte: in view mode the record VALUES are the foreground. Read-only fields render as
+			   text (not boxed inputs), so the data outweighs its labels and section chrome. */
+			.prsp-record-read input.input[readonly], .prsp-record-read input.input[disabled], .prsp-record-read textarea[readonly], .prsp-record-read textarea[disabled], .prsp-record-read select[disabled] { background: transparent !important; border-color: transparent !important; box-shadow: none !important; padding-left: 0 !important; padding-right: 0 !important; height: auto !important; min-height: 0 !important; opacity: 1 !important; cursor: default !important; color: var(--theme-color-text-primary, #1f2733) !important; -webkit-text-fill-color: var(--theme-color-text-primary, #1f2733) !important; font-weight: 600 !important; font-size: 1.1rem !important; }
+			.prsp-record-read .label { font-size: 0.68rem !important; font-weight: 600 !important; text-transform: uppercase !important; letter-spacing: 0.05em !important; color: var(--theme-color-text-muted, #6b7686) !important; margin-bottom: 0.05rem !important; }
+			.prsp-record-read .section-header { background: var(--theme-color-background-selected, #e3edfb) !important; color: var(--theme-color-brand-primary, #156dd1) !important; font-size: 0.74rem !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.06em !important; padding: 0.4rem 0.8rem !important; border-radius: 6px !important; border-bottom: 0 !important; margin: 1.1rem 0 0.7rem !important; }
+		`,
 		CSSPriority: 500,
 
 		Templates:
@@ -227,6 +258,47 @@ const _DEFAULT_CONFIGURATION__Read = (
 					// TODO: Double payload pattern...
 					Template: `#/PSRS/{~D:Record.Payload.Payload.RecordSet~}/View/{~DVBK:Record.Payload.Data:Record.Payload.Payload.GUIDAddress~}`
 				},
+				// --- Record audit header (themeable; apps brand via --theme-color-* tokens) ---
+				{
+					Hash: 'PRSP-Read-RecordAuditHeader-Template',
+					Template: /*html*/`
+						<div class="prsp-audit-header">
+							<div class="prsp-audit-activity">{~TS:PRSP-Read-RecordAudit-Line-Template:AppData.PRSP_RecordAudit.ActivitySlot~}</div>
+							<div class="prsp-audit-anchor">
+								<button type="button" class="prsp-audit-button" title="Identity and audit detail" onclick="_Pict.views['RSP-RecordSet-Read'].toggleRecordAudit()">{~I:Info~}<span>Details</span></button>
+								<div class="prsp-audit-popover" id="PRSP-Read-AuditPopover">
+									<dl class="prsp-audit-dl">
+										<dt>{~D:AppData.PRSP_RecordAudit.IDFieldName~}</dt><dd><span class="prsp-audit-guid"><code>{~D:AppData.PRSP_RecordAudit.IDValue~}</code><button type="button" class="prsp-audit-copy" title="Copy" onclick="_Pict.views['RSP-RecordSet-Read'].copyValue('{~D:AppData.PRSP_RecordAudit.IDValue~}')">{~I:Copy~}</button></span></dd>
+										<dt>{~D:AppData.PRSP_RecordAudit.GUIDFieldName~}</dt><dd><span class="prsp-audit-guid"><code>{~D:AppData.PRSP_RecordAudit.GUIDValue~}</code><button type="button" class="prsp-audit-copy" title="Copy" onclick="_Pict.views['RSP-RecordSet-Read'].copyValue('{~D:AppData.PRSP_RecordAudit.GUIDValue~}')">{~I:Copy~}</button></span></dd>
+										{~TS:PRSP-Read-RecordAudit-Created-Template:AppData.PRSP_RecordAudit.CreatedSlot~}
+										{~TS:PRSP-Read-RecordAudit-Updated-Template:AppData.PRSP_RecordAudit.UpdatedSlot~}
+										{~TS:PRSP-Read-RecordAudit-Deleted-Template:AppData.PRSP_RecordAudit.DeletedSlot~}
+									</dl>
+								</div>
+							</div>
+						</div>
+					`
+				},
+				{
+					Hash: 'PRSP-Read-RecordAudit-Line-Template',
+					Template: /*html*/`<span class="prsp-audit-line">{~I:Refresh~} {~D:Record.Label~} by <strong>{~E:User^Record.UserID^PRSP-Read-RecordAudit-UserName-Template~}</strong> &middot; {~DateFormat:Record.Date^MMM D, YYYY - h:mm A~}</span>`
+				},
+				{
+					Hash: 'PRSP-Read-RecordAudit-UserName-Template',
+					Template: /*html*/`{~D:Record.NameFirst~} {~D:Record.NameLast~}`
+				},
+				{
+					Hash: 'PRSP-Read-RecordAudit-Created-Template',
+					Template: /*html*/`<dt>Created</dt><dd>{~DateFormat:Record.Date^MMM D, YYYY - h:mm A~} <small>by {~E:User^Record.UserID^PRSP-Read-RecordAudit-UserName-Template~}</small></dd>`
+				},
+				{
+					Hash: 'PRSP-Read-RecordAudit-Updated-Template',
+					Template: /*html*/`<dt>Last updated</dt><dd>{~DateFormat:Record.Date^MMM D, YYYY - h:mm A~} <small>by {~E:User^Record.UserID^PRSP-Read-RecordAudit-UserName-Template~}</small></dd>`
+				},
+				{
+					Hash: 'PRSP-Read-RecordAudit-Deleted-Template',
+					Template: /*html*/`<dt>Deleted</dt><dd class="is-deleted">{~DateFormat:Record.Date^MMM D, YYYY - h:mm A~} <small>by {~E:User^Record.UserID^PRSP-Read-RecordAudit-UserName-Template~}</small></dd>`
+				},
 			],
 
 		Renderables:
@@ -319,6 +391,8 @@ class viewRecordSetRead extends libPictRecordSetRecordView
 			this.initializeDragListener();
 		}
 		
+		this.pict.CSSMap.injectCSS();
+		this._bindAuditDismiss();
 		return super.onAfterRender(pRenderable);
 	}
 
@@ -387,6 +461,222 @@ class viewRecordSetRead extends libPictRecordSetRecordView
 		this.fable.providers.RecordSetRouter.pictRouter.navigate(`/PSRS/${ this.RecordSet }/Edit/${ this.GUID }`);
 	}
 
+	/**
+	 * Build the record audit header state — the first-class activity line plus the data the
+	 * Details modal renders. Identity (ID/GUID) and the create/update/delete stamps are read
+	 * straight off the fetched record; the acting-user names resolve lazily via {~E:User^…~}
+	 * in the templates (cachetrax-cached), so nothing is pre-resolved here. Stored at
+	 * AppData.PRSP_RecordAudit for the templates to consume.
+	 *
+	 * @param {Record<string, any>} pRecord - The fetched record.
+	 */
+	_prepareRecordAuditState(pRecord)
+	{
+		if (!pRecord || typeof pRecord !== 'object')
+		{
+			this.pict.AppData.PRSP_RecordAudit = false;
+			return;
+		}
+		const tmpProvider = this.pict.providers[this.providerHash];
+		const tmpIDField = tmpProvider ? tmpProvider.getIDField() : 'ID';
+		const tmpGUIDField = tmpProvider ? tmpProvider.getGUIDField() : 'GUID';
+
+		const tmpHasCreate = this._validAuditDate(pRecord.CreateDate);
+		const tmpHasUpdate = this._validAuditDate(pRecord.UpdateDate) && (pRecord.UpdateDate !== pRecord.CreateDate);
+		const tmpDeleted = !!pRecord.Deleted && this._validAuditDate(pRecord.DeleteDate);
+
+		let tmpActivitySlot = [];
+		if (tmpHasUpdate)
+		{
+			tmpActivitySlot = [{ Label: 'Updated', Date: pRecord.UpdateDate, UserID: pRecord.UpdatingIDUser }];
+		}
+		else if (tmpHasCreate)
+		{
+			tmpActivitySlot = [{ Label: 'Created', Date: pRecord.CreateDate, UserID: pRecord.CreatingIDUser }];
+		}
+
+		const tmpIDValue = (pRecord[tmpIDField] != null) ? pRecord[tmpIDField] : '';
+		this.pict.AppData.PRSP_RecordAudit =
+		{
+			RecordSet: this.RecordSet,
+			DisplayName: this._computeDisplayName(pRecord),
+			IDFieldName: tmpIDField,
+			GUIDFieldName: tmpGUIDField,
+			IDValue: tmpIDValue,
+			GUIDValue: (pRecord[tmpGUIDField] != null) ? pRecord[tmpGUIDField] : '',
+			ActivitySlot: tmpActivitySlot,
+			CreatedSlot: tmpHasCreate ? [{ Date: pRecord.CreateDate, UserID: pRecord.CreatingIDUser }] : [],
+			UpdatedSlot: tmpHasUpdate ? [{ Date: pRecord.UpdateDate, UserID: pRecord.UpdatingIDUser }] : [],
+			DeletedSlot: tmpDeleted ? [{ Date: pRecord.DeleteDate, UserID: pRecord.DeletingIDUser }] : []
+		};
+	}
+
+	/**
+	 * Compute a human-friendly display name for a record using an opinionated heuristic: first +
+	 * last name, then a single descriptive field (FullName, Name, Title, …), else ''. Callers fall
+	 * back to the GUID. Lets the page title read "Krishna Pavia Tester" instead of a raw GUID.
+	 * @param {Record<string, any>} pRecord
+	 * @return {string}
+	 */
+	_computeDisplayName(pRecord)
+	{
+		if (!pRecord || typeof pRecord !== 'object')
+		{
+			return '';
+		}
+		const tmpFirst = pRecord.NameFirst || pRecord.FirstName;
+		const tmpLast = pRecord.NameLast || pRecord.LastName;
+		if (tmpFirst || tmpLast)
+		{
+			return [tmpFirst, tmpLast].filter(Boolean).join(' ').trim();
+		}
+		const tmpCandidateFields = ['FullName', 'Name', 'Title', 'DisplayName', 'Label', 'Subject', 'Description', 'Code', 'Hash'];
+		for (const tmpField of tmpCandidateFields)
+		{
+			if (pRecord[tmpField] != null && String(pRecord[tmpField]).trim() !== '')
+			{
+				return String(pRecord[tmpField]).trim();
+			}
+		}
+		return '';
+	}
+
+	/**
+	 * Whether an audit date value is present and meaningful (guards null/empty and the Meadow
+	 * "0000-00-00" zero-date sentinel).
+	 * @param {any} pValue
+	 * @return {boolean}
+	 */
+	_validAuditDate(pValue)
+	{
+		if (!pValue)
+		{
+			return false;
+		}
+		return String(pValue).indexOf('0000-00-00') !== 0;
+	}
+
+	/**
+	 * Toggle the anchored identity + audit popover open or closed. The content is rendered inline
+	 * with the record (so the {~E:User^…~} names resolve during the read render); this just flips
+	 * its visibility — no overlay.
+	 */
+	toggleRecordAudit()
+	{
+		const tmpPopover = document.getElementById('PRSP-Read-AuditPopover');
+		if (tmpPopover)
+		{
+			tmpPopover.classList.toggle('is-open');
+		}
+	}
+
+	/**
+	 * Bind the one-time document handlers that dismiss the audit popover on an outside click or
+	 * Escape. Browser-level events with no inline-handler equivalent — bound once and guarded so
+	 * re-renders don't stack listeners.
+	 */
+	_bindAuditDismiss()
+	{
+		if (this._auditDismissBound || typeof document === 'undefined')
+		{
+			return;
+		}
+		this._auditDismissBound = true;
+		document.addEventListener('click', (pEvent) =>
+		{
+			const tmpPopover = document.getElementById('PRSP-Read-AuditPopover');
+			if (!tmpPopover || !tmpPopover.classList.contains('is-open'))
+			{
+				return;
+			}
+			if (tmpPopover.contains(pEvent.target) || (pEvent.target.closest && pEvent.target.closest('.prsp-audit-button')))
+			{
+				return;
+			}
+			tmpPopover.classList.remove('is-open');
+		});
+		document.addEventListener('keydown', (pEvent) =>
+		{
+			if (pEvent.key === 'Escape')
+			{
+				const tmpPopover = document.getElementById('PRSP-Read-AuditPopover');
+				if (tmpPopover)
+				{
+					tmpPopover.classList.remove('is-open');
+				}
+			}
+		});
+	}
+
+	/**
+	 * Copy a record value (ID or GUID) to the clipboard from the audit popover, with a toast.
+	 * @param {string} pValue
+	 */
+	copyValue(pValue)
+	{
+		const tmpModal = this.pict.views['Pict-Section-Modal'];
+		const fToast = (pMessage, pType) =>
+		{
+			if (tmpModal && typeof tmpModal.toast === 'function')
+			{
+				tmpModal.toast(pMessage, { type: pType || 'success' });
+			}
+		};
+		if (typeof navigator !== 'undefined' && navigator.clipboard && navigator.clipboard.writeText)
+		{
+			navigator.clipboard.writeText(pValue).then(() => fToast('GUID copied to clipboard')).catch(() => fToast('Could not copy GUID', 'error'));
+		}
+		else
+		{
+			fToast('Could not copy GUID', 'error');
+		}
+	}
+
+	/**
+	 * Remove identity + audit descriptors from a (cloned) manifest so they don't render inline
+	 * in the record body — they live behind the audit header's Details modal instead. Also
+	 * prunes any section left with no descriptors (e.g. an emptied "Audit Trail" section). The
+	 * entity's own ID/GUID field names are suppressed alongside the shared audit fields.
+	 * @param {Record<string, any>} pManifest - The cloned manifest to mutate.
+	 */
+	_suppressAuditDescriptors(pManifest)
+	{
+		if (!pManifest || !pManifest.Descriptors)
+		{
+			return;
+		}
+		const tmpProvider = this.pict.providers[this.providerHash];
+		const tmpSuppress = _AUDIT_FIELD_NAMES.slice();
+		if (tmpProvider)
+		{
+			tmpSuppress.push(tmpProvider.getIDField());
+			tmpSuppress.push(tmpProvider.getGUIDField());
+		}
+		for (const tmpKey of Object.keys(pManifest.Descriptors))
+		{
+			const tmpFieldName = tmpKey.split('.').pop();
+			if (tmpSuppress.indexOf(tmpFieldName) >= 0)
+			{
+				delete pManifest.Descriptors[tmpKey];
+			}
+		}
+		// Drop sections that no longer have any descriptors (so an emptied titled section like
+		// "Audit Trail" doesn't render as a bare heading).
+		if (Array.isArray(pManifest.Sections))
+		{
+			const tmpUsedSections = {};
+			for (const tmpKey of Object.keys(pManifest.Descriptors))
+			{
+				const tmpSectionHash = pManifest.Descriptors[tmpKey] && pManifest.Descriptors[tmpKey].PictForm && pManifest.Descriptors[tmpKey].PictForm.Section;
+				if (tmpSectionHash)
+				{
+					tmpUsedSections[tmpSectionHash] = true;
+				}
+			}
+			pManifest.Sections = pManifest.Sections.filter((pSection) => tmpUsedSections[pSection.Hash]);
+		}
+	}
+
 	onBeforeRenderRead(pRecordReadData)
 	{
 		this.formatDisplayData(pRecordReadData);
@@ -467,12 +757,19 @@ class viewRecordSetRead extends libPictRecordSetRecordView
 		tmpRecordReadData.RecordSchema = await this.pict.providers[pProviderHash].getRecordSchema();
 		this.pict.AppData[`${ tmpRecordReadData.RecordSet }Details`] = tmpRecordReadData.Record;
 
+		// Build the audit header state (first-class activity line + the Details modal) for this record.
+		this._prepareRecordAuditState(tmpRecordReadData.Record);
+
 		if (pRecordConfiguration.RecordSetReadManifestOnly)
 		{
 			this.pict.TemplateProvider.addTemplate(`PRSP-Read-RecordRead-Template`, /*html*/`
 				<!-- Manifest dynamic pict template: [PRSP-Read-RecordRead-Template] -->
+				<div class="prsp-record-read">
+				{~T:PRSP-Read-RecordAuditHeader-Template~}
 				<div>${ this._generateManifestTemplate(pRecordConfiguration, 'RecordRead', null, true) }</div>
 				{~T:PRSP-Read-RecordButtonBar-Template~}
+				<div class="prsp-record-related" id="PRSP-Read-Related"></div>
+				</div>
 				<!-- Manifest dynamic pict end template: [PRSP-Read-RecordRead-Template] -->
 			`);
 		}
@@ -482,8 +779,12 @@ class viewRecordSetRead extends libPictRecordSetRecordView
 			this.defaultManifest = await this._buildDefaultManifest(tmpRecordReadData.RecordSet);
 			this.pict.TemplateProvider.addTemplate(`PRSP-Read-RecordRead-Template`, /*html*/`
 				<!-- Manifest dynamic pict template: [PRSP-Read-RecordRead-Template] -->
+				<div class="prsp-record-read">
+				{~T:PRSP-Read-RecordAuditHeader-Template~}
 				<div>${ this._generateManifestTemplate(pRecordConfiguration, 'RecordRead', null, true, this.action, this.defaultManifest) }</div>
 				{~T:PRSP-Read-RecordButtonBar-Template~}
+				<div class="prsp-record-related" id="PRSP-Read-Related"></div>
+				</div>
 				<!-- Manifest dynamic pict end template: [PRSP-Read-RecordRead-Template] -->
 			`);
 		}
@@ -616,7 +917,7 @@ class viewRecordSetRead extends libPictRecordSetRecordView
 		const schema = await this.pict.providers[providerHash].getRecordSchema();
 		for (const p of Object.keys(schema.properties))
 		{
-			const exclusionSet = [this.pict.providers[this.providerHash].getIDField(), this.pict.providers[this.providerHash].getGUIDField(), 'CreatingIDUser', 'UpdatingIDUser', 'DeletingIDUser', 'Deleted', 'CreateDate', 'UpdateDate', 'DeleteDate', 'Deleted'];
+			const exclusionSet = [this.pict.providers[this.providerHash].getIDField(), this.pict.providers[this.providerHash].getGUIDField()].concat(_AUDIT_FIELD_NAMES);
 			if (exclusionSet.includes(p))
 			{
 				continue;
@@ -695,6 +996,11 @@ class viewRecordSetRead extends libPictRecordSetRecordView
 				tmpManifest.Descriptors[x].PictForm.InputType = 'ReadOnly';
 			}
 		}
+		// Suppress identity + audit fields from the body; they surface via the audit header's Details modal.
+		if (config.RecordSetReadSuppressAuditFields !== false)
+		{
+			this._suppressAuditDescriptors(tmpManifest);
+		}
 		if (setBaseManifest)
 		{
 			this.manifest = tmpManifest;

package/types/providers/Filter-Data-Provider.d.ts

@@ -146,7 +146,7 @@ declare class FilterDataProvider extends libPictProvider {
      * @param {string} pViewContext - The current view context
      * @return {boolean} - Returns true when the settings have been saved.
      */
-    saveFilterMeta(pRecordSet: string, pViewContext: string): boolean;
+    saveFilterMeta(pRecordSet: string, pViewContext: string, pSilent: any, pDisplayNameOverride: any): boolean;
     /** ===== LAST USED Filter Experience ============= */
     /**
      * Save the application metadata as the last used filter experience (continually updated).

package/types/providers/Filter-Data-Provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Filter-Data-Provider.d.ts","sourceRoot":"","sources":["../../source/providers/Filter-Data-Provider.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Filter-Data-Provider.d.ts","sourceRoot":"","sources":["../../source/providers/Filter-Data-Provider.js"],"names":[],"mappings":"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"}

package/types/views/Filter-PersistenceView.d.ts

@@ -75,7 +75,28 @@ declare class viewFilterPersistenceView extends libPictView {
      * @param {function} [pCallback] - A callback function to be executed after saving the settings.
      * @returns {boolean} - Returns true when the settings have been saved.
      */
-    saveFilterPersistenceSettings(event: Event, pCallback?: Function): boolean;
+    /** HTML-escape a value for safe display in the modal. */
+    _escapeHTML(pValue: any): string;
+    /** Describe a single active filter clause in plain English (e.g. "Date Created between A and B"). */
+    _describeFilterClause(pClause: any): string;
+    /**
+     * @returns {{ summary: string, count: string }} A plain-English summary of the current
+     * search + filter clauses, and the matched record count (from the rendered list total).
+     */
+    _describeCurrentFilter(): {
+        summary: string;
+        count: string;
+    };
+    /**
+     * Prompt for a name (via pict-section-modal when available) and save the current search +
+     * filters as a named experience. The modal previews the filter in plain English and the
+     * number of records it matches. Falls back to the generated name with no prompt if the
+     * modal section is not registered in the host app.
+     *
+     * @param {Event} pEvent
+     */
+    promptSaveFilterExperience(pEvent: Event): boolean;
+    saveFilterPersistenceSettings(event: any, pCallback: any): boolean;
     /**
      * Sets the filter experience as the default for the current record set and view context.
      * @param {Event} event - The event object.
@@ -112,7 +133,7 @@ declare namespace _DEFAULT_CONFIGURATION_FilterPersistenceView {
     let AutoRenderOrdinal: number;
     let AutoSolveWithApp: boolean;
     let AutoSolveOrdinal: number;
-    let CSS: boolean;
+    let CSS: string;
     let CSSPriority: number;
     let Templates: {
         Hash: string;

package/types/views/Filter-PersistenceView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Filter-PersistenceView.d.ts","sourceRoot":"","sources":["../../source/views/Filter-PersistenceView.js"],"names":[],"mappings":";AAuFA;IAEC,2DASC;IAJA,yBAA4B;IAC5B,2BAA8B;IAC9B,+BAAqC;IACrC,qCAAwC;IAIzC;;;;;;OAMG;IACH,8CALW,MAAM,gBACN,MAAM,wBAEJ,OAAO,CAqCnB;IAED;;;;;OAKG;IACH,8DAJW,MAAM,gBACN,MAAM,qCACN,OAAO,QA0BjB;IAED;;;;;;OAMG;IACH,oCALW,MAAM,gBACN,MAAM,wBAEJ,OAAO,CAYnB;IAED;;;OAGG;IACH,mCA2BC;IAED;;;;;;OAMG;IACH,2CALW,MAAM,gBACN,MAAM,aACN,MAAM,GACJ,OAAO,CAenB;IAED;;;;OAIG;IACH,sCAHW,KAAK,GACH,OAAO,CA6BnB;IAED;;;OAGG;IACH,4BAFa,OAAO,CAmBnB;IAED;;;OAGG;IACH,mDAFa,OAAO,CA+CnB;IAED;;;;OAIG;IACH,8CAHW,KAAK,GACH,OAAO,CAcnB;IAED;;;;OAIG;IACH,qCAHW,KAAK,mBACH,OAAO,CAqBnB;IAED;;;;;OAKG;IACH,qCAJW,KAAK,yBAEH,OAAO,CA4BnB;IAED;;;;;;OAMG;IACH,0CALW,KAAK,aACL,OAAO,yBAEL,OAAO,CAyBnB;IAED;;;OAGG;IACH,uCAFW,OAAO,QA4BjB;IAED;;;;;OAKG;IACH,uCAJW,KAAK,yBAEH,OAAO,CAsBnB;CACD"}
+{"version":3,"file":"Filter-PersistenceView.d.ts","sourceRoot":"","sources":["../../source/views/Filter-PersistenceView.js"],"names":[],"mappings":";AA4EA;IAEC,2DASC;IAJA,yBAA4B;IAC5B,2BAA8B;IAC9B,+BAAqC;IACrC,qCAAwC;IAsBzC;;;;;;OAMG;IACH,8CALW,MAAM,gBACN,MAAM,wBAEJ,OAAO,CAqCnB;IAED;;;;;OAKG;IACH,8DAJW,MAAM,gBACN,MAAM,qCACN,OAAO,QA0BjB;IAED;;;;;;OAMG;IACH,oCALW,MAAM,gBACN,MAAM,wBAEJ,OAAO,CAYnB;IAED;;;OAGG;IACH,mCA2BC;IAED;;;;;;OAMG;IACH,2CALW,MAAM,gBACN,MAAM,aACN,MAAM,GACJ,OAAO,CAenB;IAED;;;;OAIG;IACH,sCAHW,KAAK,GACH,OAAO,CA6BnB;IAED;;;OAGG;IACH,4BAFa,OAAO,CAmBnB;IAED;;;OAGG;IACH,mDAFa,OAAO,CA+CnB;IAED;;;;OAIG;IACH,8CAHW,KAAK,GACH,OAAO,CAcnB;IAED;;;;OAIG;IACH,qCAHW,KAAK,mBACH,OAAO,CAqBnB;IAED;;;;;OAKG;IACH,yDAAyD;IACzD,iCAGC;IAED,qGAAqG;IACrG,4CAoBC;IAED;;;OAGG;IACH,0BAHa;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAqB9C;IAED;;;;;;;OAOG;IACH,mCAFW,KAAK,WA+Cf;IAED,mEA0BC;IAED;;;;;;OAMG;IACH,0CALW,KAAK,aACL,OAAO,yBAEL,OAAO,CAyBnB;IAED;;;OAGG;IACH,uCAFW,OAAO,QA4BjB;IAED;;;;;OAKG;IACH,uCAJW,KAAK,yBAEH,OAAO,CAsBnB;CACD"}

package/types/views/RecordSet-Filters.d.ts

@@ -18,7 +18,15 @@ declare class ViewRecordSetSUBSETFilters extends libPictView {
     newFilterSearchApplied: boolean;
     addFilterCallback: Function;
     removeFilterCallback: Function;
+    _drawerOpen: boolean;
+    _searchString: {};
     _renderEpoch: number;
+    _addFilterOpen: boolean;
+    _addFilterRecordSet: string;
+    _addFilterViewContext: string;
+    _addFilterSearch: string;
+    _addFilterExpandedKey: any;
+    filterFieldBlacklist: any[];
     /**
      * Bump the render epoch. Call this whenever the active filter clauses are
      * about to change in a way that would invalidate in-flight filter renders.
@@ -64,6 +72,27 @@ declare class ViewRecordSetSUBSETFilters extends libPictView {
      * @returns {any} The result of the super.onMarshalToView() method.
      */
     onMarshalToView(): any;
+    /** Toggle the slide-out filter drawer beneath the search bar. */
+    toggleFilterDrawer(): boolean;
+    /**
+     * The current search term, read back from the active route URL (the source of truth) so
+     * the search box stays populated across re-renders and reflects bookmarked/filtered URLs.
+     * performSearch builds `.../FilteredTo/FBVOR~<field>~LK~<encoded %term%>~...` from the
+     * SearchFields, so the term is the first LK value in the FilteredTo segment.
+     *
+     * @return {string}
+     */
+    _searchTermFromURL(): string;
+    /** The number of active (structured) filter clauses for a record set. */
+    getActiveFilterCount(pRecordSet: any): number;
+    /**
+     * Repaint the filter-bar chrome after a (re)render: the filters icon (outline vs filled
+     * + count badge), the active-filter highlight, the persisted drawer-open state, and the
+     * search input value (so applying a search no longer clears the search box).
+     *
+     * @param {string} pRecordSet
+     */
+    _paintFilterControls(pRecordSet: string): void;
     /**
      * @param {Event} pEvent - The DOM event that triggered the search
      * @param {string} pRecordSet - The record set being filtered
@@ -102,7 +131,28 @@ declare class ViewRecordSetSUBSETFilters extends libPictView {
      * @param {string} pRecordSet - The record set being filtered
      * @param {string} pViewContext - The view context for the filter (ex. List, Dashboard)
      */
-    selectFilterToAdd(pEvent: Event, pRecordSet: string, pViewContext: string): void;
+    toggleAddFilterPopover(pEvent: Event, pRecordSet: string, pViewContext: string): void;
+    /** Close the add-filter popover. */
+    closeAddFilterPopover(): void;
+    /**
+     * Filter the add-filter field list by a search term, re-rendering only the list so the
+     * search input keeps focus.
+     * @param {string} pValue - The search term.
+     */
+    searchAddFilter(pValue: string): void;
+    /**
+     * Expand or collapse a field's available clauses in the add-filter popover.
+     * @param {string} pFilterKey - The field whose clauses to toggle.
+     */
+    toggleAddFilterField(pFilterKey: string): void;
+    /**
+     * (Re)build the add-filter popover's field list into AppData from the record set's filter
+     * schema, honouring the current search term and the expanded field.
+     * @param {string} pRecordSet - The record set whose filter schema to read.
+     */
+    _buildAddFilterFields(pRecordSet: string): void;
+    /** Reflect the add-filter popover's open/closed state on its container element. */
+    _paintAddFilterOpenState(): void;
     /**
      * @param {Event} pEvent - The DOM event that triggered the search
      * @param {string} pRecordSet - The record set being filtered
@@ -159,9 +209,11 @@ declare class ViewRecordSetSUBSETFilters extends libPictView {
     decode(base64: string): ArrayBuffer;
 }
 declare namespace ViewRecordSetSUBSETFilters {
-    export { _DEFAULT_CONFIGURATION_SUBSET_Filter as default_configuration };
+    export { FilterIconOutline, FilterIconFilled, _DEFAULT_CONFIGURATION_SUBSET_Filter as default_configuration };
 }
 import libPictView = require("pict-view");
+declare var FilterIconOutline: string;
+declare var FilterIconFilled: string;
 /** @type {Record<string, any>} */
 declare const _DEFAULT_CONFIGURATION_SUBSET_Filter: Record<string, any>;
 //# sourceMappingURL=RecordSet-Filters.d.ts.map

package/types/views/RecordSet-Filters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecordSet-Filters.d.ts","sourceRoot":"","sources":["../../source/views/RecordSet-Filters.js"],"names":[],"mappings":";AA6MA;IAEC,2DAuCC;IAnCA,kHAAkH;IAClH,MADW,GAAe,GAAG,OAAO,MAAM,CAAC,GAAG;QAAE,oBAAoB,EAAE;;;;;;;;SAAsC,CAAA;KAAE,CACrG;IAeT,cAA+E;IAG/E,wCAA0E;IAK1E,gCAAmC;IACnC,4BAA6B;IAC7B,+BAAgC;IAQhC,qBAAqB;IAGtB;;;;;OAKG;IACH,mBAFY,MAAM,CAMjB;IAED;;;OAGG;IACH,gDAGC;IAED;;;OAGG;IACH,mDAGC;IAED;;OAEG;IACH,gCAGC;IAED;;OAEG;IACH,mCAGC;IAED;;OAEG;IACH,6BAFY,MAAM,CAKjB;IAED;;;;OAIG;IACH,kCAJW,MAAM,GAEL,GAAG,CAMd;IAKD;;;OAGG;IACH,qBAFa,GAAG,CAaf;IAED;;;OAGG;IACH,mBAFa,GAAG,CAaf;IAED;;;;OAIG;IACH,qBAJW,KAAK,cACL,MAAM,gBACN,MAAM,QAUhB;IAED;;;;OAIG;IACH,0BAJW,MAAM,gBACN,MAAM,kBACN,MAAM,QAsDhB;IAED;;;;;OAKG;IACH,oBAJW,KAAK,cACL,MAAM,gBACN,MAAM,QAUhB;IAGD;;;;;OAKG;IACH,oBAJW,KAAK,cACL,MAAM,gBACN,MAAM,QAoBhB;IAED;;;;;MAKE;IACF,qBALW,KAAK,cACL,MAAM,gBACN,MAAM,GACJ,OAAO,CAQnB;IAED;;;;OAIG;IACH,0BAJW,KAAK,cACL,MAAM,gBACN,MAAM,QAQhB;IAED;;;;;;OAMG;IACH,kBANW,KAAK,cACL,MAAM,gBACN,MAAM,cACN,MAAM,cACN,MAAM,QAWhB;IAED;;;;;OAKG;IACH,qBALW,KAAK,cACL,MAAM,gBACN,MAAM,sBACN,MAAM,QAWhB;IAED;;;;OAIG;IACH,4BAHW,MAAM,GACL,KAAK,CAAC,GAAG,CAAC,CAMrB;IAmDD;;;;OAIG;IACH,uCAHW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClB,OAAO,CAAC,MAAM,CAAC,CAiB1B;IAED;;;;OAIG;IACH,yCAHW,MAAM,GACL,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAUvC;IAED;;;;OAIG;IACH,iBAJW,MAAM,aACN,iBAAiB,GAChB,OAAO,CAAC,WAAW,CAAC,CAU/B;IAED;;;OAGG;IACH,sBAHW,UAAU,aACV,iBAAiB,mBAa3B;IAED;;;OAGG;IACH,oBAHW,WAAW,GACV,MAAM,CA2BjB;IAED;;;OAGG;IACH,eAHW,MAAM,GACL,WAAW,CAsCtB;CACD;;;;;AAxtBD,kCAAkC;AAClC,oDADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA6J5B"}
+{"version":3,"file":"RecordSet-Filters.d.ts","sourceRoot":"","sources":["../../source/views/RecordSet-Filters.js"],"names":[],"mappings":";AAgTA;IAEC,2DAoDC;IAhDA,kHAAkH;IAClH,MADW,GAAe,GAAG,OAAO,MAAM,CAAC,GAAG;QAAE,oBAAoB,EAAE;;;;;;;;SAAsC,CAAA;KAAE,CACrG;IAeT,cAA+E;IAG/E,wCAA0E;IAK1E,gCAAmC;IACnC,4BAA6B;IAC7B,+BAAgC;IAGhC,qBAAwB;IACxB,kBAAuB;IAQvB,qBAAqB;IAErB,wBAA2B;IAC3B,4BAA+B;IAC/B,8BAAiC;IACjC,yBAA0B;IAC1B,2BAAiC;IAGjC,4BAA8B;IAG/B;;;;;OAKG;IACH,mBAFY,MAAM,CAMjB;IAED;;;OAGG;IACH,gDAGC;IAED;;;OAGG;IACH,mDAGC;IAED;;OAEG;IACH,gCAGC;IAED;;OAEG;IACH,mCAGC;IAED;;OAEG;IACH,6BAFY,MAAM,CAKjB;IAED;;;;OAIG;IACH,kCAJW,MAAM,GAEL,GAAG,CAMd;IAKD;;;OAGG;IACH,qBAFa,GAAG,CAaf;IAED;;;OAGG;IACH,mBAFa,GAAG,CAaf;IAED,iEAAiE;IACjE,8BAMC;IAED;;;;;;;OAOG;IACH,sBAFY,MAAM,CAcjB;IAED,yEAAyE;IACzE,8CAKC;IAED;;;;;;OAMG;IACH,iCAFW,MAAM,QAehB;IAED;;;;OAIG;IACH,qBAJW,KAAK,cACL,MAAM,gBACN,MAAM,QAUhB;IAED;;;;OAIG;IACH,0BAJW,MAAM,gBACN,MAAM,kBACN,MAAM,QAsDhB;IAED;;;;;OAKG;IACH,oBAJW,KAAK,cACL,MAAM,gBACN,MAAM,QAWhB;IAGD;;;;;OAKG;IACH,oBAJW,KAAK,cACL,MAAM,gBACN,MAAM,QAoBhB;IAED;;;;;MAKE;IACF,qBALW,KAAK,cACL,MAAM,gBACN,MAAM,GACJ,OAAO,CAQnB;IAED;;;;OAIG;IACH,+BAJW,KAAK,cACL,MAAM,gBACN,MAAM,QAiBhB;IAED,oCAAoC;IACpC,8BAKC;IAED;;;;OAIG;IACH,wBAFW,MAAM,QAOhB;IAED;;;OAGG;IACH,iCAFW,MAAM,QAOhB;IAED;;;;OAIG;IACH,kCAFW,MAAM,QAgChB;IAED,mFAAmF;IACnF,iCAIC;IAED;;;;;;OAMG;IACH,kBANW,KAAK,cACL,MAAM,gBACN,MAAM,cACN,MAAM,cACN,MAAM,QAWhB;IAED;;;;;OAKG;IACH,qBALW,KAAK,cACL,MAAM,gBACN,MAAM,sBACN,MAAM,QAWhB;IAED;;;;OAIG;IACH,4BAHW,MAAM,GACL,KAAK,CAAC,GAAG,CAAC,CAMrB;IAgGD;;;;OAIG;IACH,uCAHW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClB,OAAO,CAAC,MAAM,CAAC,CAiB1B;IAED;;;;OAIG;IACH,yCAHW,MAAM,GACL,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAUvC;IAED;;;;OAIG;IACH,iBAJW,MAAM,aACN,iBAAiB,GAChB,OAAO,CAAC,WAAW,CAAC,CAU/B;IAED;;;OAGG;IACH,sBAHW,UAAU,aACV,iBAAiB,mBAa3B;IAED;;;OAGG;IACH,oBAHW,WAAW,GACV,MAAM,CA2BjB;IAED;;;OAGG;IACH,eAHW,MAAM,GACL,WAAW,CAsCtB;CACD;;;;;;;AAvgCD,kCAAkC;AAClC,oDADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgQ5B"}

package/types/views/filters/RecordSet-Filter-Base.d.ts

@@ -8,6 +8,20 @@ declare class ViewRecordSetSUBSETFilterBase extends libPictView {
      */
     prepareRecord(pRecord: Record<string, any>): void;
     getFilterFormTemplate(): string;
+    /**
+     * Remove this filter clause from its record set and re-render the filter control.
+     *
+     * Lives on the base view so every filter type inherits a single, themeable remove
+     * affordance and no host application has to re-implement one. Delegates to the
+     * consolidated control view (the canonical re-render path) and falls back to the
+     * record-set provider directly if that view is somehow unavailable.
+     *
+     * @param {Event} pEvent - The DOM event that triggered the removal.
+     * @param {string} pRecordSet - The record set being filtered.
+     * @param {string} pViewContext - The view context for the filter (e.g. List, Dashboard).
+     * @param {string} pHash - The hash of the specific filter clause to remove.
+     */
+    removeClause(pEvent: Event, pRecordSet: string, pViewContext: string, pHash: string): any;
     /**
      * @return {string} - The prefix for the informary address.
      */

package/types/views/filters/RecordSet-Filter-Base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecordSet-Filter-Base.d.ts","sourceRoot":"","sources":["../../../source/views/filters/RecordSet-Filter-Base.js"],"names":[],"mappings":";AAmEA;IAEC,2DAIC;IAED;;;;OAIG;IACH,uBAFW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAgB7B;IAED,gCAGC;IAED;;OAEG;IACH,6BAFY,MAAM,CAKjB;IAED;;;;OAIG;IACH,2CAJW,MAAM,GAEL,GAAG,CAKd;CACD;;;;;AApHD,kCAAkC;AAClC,oDADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA+D5B"}
+{"version":3,"file":"RecordSet-Filter-Base.d.ts","sourceRoot":"","sources":["../../../source/views/filters/RecordSet-Filter-Base.js"],"names":[],"mappings":";AAkHA;IAEC,2DAIC;IAED;;;;OAIG;IACH,uBAFW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAgB7B;IAED,gCAGC;IAED;;;;;;;;;;;;OAYG;IACH,qBALW,KAAK,cACL,MAAM,gBACN,MAAM,SACN,MAAM,OAmBhB;IAED;;OAEG;IACH,6BAFY,MAAM,CAKjB;IAED;;;;OAIG;IACH,2CAJW,MAAM,GAEL,GAAG,CAKd;CACD;;;;;AAnMD,kCAAkC;AAClC,oDADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA8G5B"}

package/types/views/list/RecordSet-List.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecordSet-List.d.ts","sourceRoot":"","sources":["../../../source/views/list/RecordSet-List.js"],"names":[],"mappings":";AA4EA;IAOE;;;;;;;;MAQC;IAGF,4DAwBC;IAiBD,8CAGC;IAED,sDAqCC;IAjCA,iCAUC;IAyBF;;;;;;;;;OASG;IACH,oCATW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,iBACnB,MAAM,iBACN,MAAM,+BACN,MAAM,WACN,MAAM,aACN,MAAM,GAEL,OAAO,CAAC,IAAI,CAAC,CAwPxB;IAED;;;;;;;;;;OAUG;IACH,kCAVW,MAAM,2BACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,iBACnB,MAAM,iBACN,MAAM,+BACN,MAAM,WACN,MAAM,aACN,MAAM,GAEL,OAAO,CAAC,IAAI,CAAC,CAoPxB;CAwBD;;;;;AA/rBD,kCAAkC;AAClC,4CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA+D1B"}
+{"version":3,"file":"RecordSet-List.d.ts","sourceRoot":"","sources":["../../../source/views/list/RecordSet-List.js"],"names":[],"mappings":";AA4EA;IAOE;;;;;;;;MAQC;IAGF,4DAwBC;IAiBD,8CAGC;IAED,sDAqCC;IAjCA,iCAUC;IAyBF;;;;;;;;;OASG;IACH,oCATW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,iBACnB,MAAM,iBACN,MAAM,+BACN,MAAM,WACN,MAAM,aACN,MAAM,GAEL,OAAO,CAAC,IAAI,CAAC,CAgQxB;IAED;;;;;;;;;;OAUG;IACH,kCAVW,MAAM,2BACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,iBACnB,MAAM,iBACN,MAAM,+BACN,MAAM,WACN,MAAM,aACN,MAAM,GAEL,OAAO,CAAC,IAAI,CAAC,CA4PxB;CAwBD;;;;;AA/sBD,kCAAkC;AAClC,4CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA+D1B"}

package/types/views/read/RecordSet-Read.d.ts

@@ -34,6 +34,57 @@ declare class viewRecordSetRead extends libPictRecordSetRecordView {
     cancel(): Promise<void>;
     save(): Promise<void>;
     edit(): Promise<void>;
+    /**
+     * Build the record audit header state — the first-class activity line plus the data the
+     * Details modal renders. Identity (ID/GUID) and the create/update/delete stamps are read
+     * straight off the fetched record; the acting-user names resolve lazily via {~E:User^…~}
+     * in the templates (cachetrax-cached), so nothing is pre-resolved here. Stored at
+     * AppData.PRSP_RecordAudit for the templates to consume.
+     *
+     * @param {Record<string, any>} pRecord - The fetched record.
+     */
+    _prepareRecordAuditState(pRecord: Record<string, any>): void;
+    /**
+     * Compute a human-friendly display name for a record using an opinionated heuristic: first +
+     * last name, then a single descriptive field (FullName, Name, Title, …), else ''. Callers fall
+     * back to the GUID. Lets the page title read "Krishna Pavia Tester" instead of a raw GUID.
+     * @param {Record<string, any>} pRecord
+     * @return {string}
+     */
+    _computeDisplayName(pRecord: Record<string, any>): string;
+    /**
+     * Whether an audit date value is present and meaningful (guards null/empty and the Meadow
+     * "0000-00-00" zero-date sentinel).
+     * @param {any} pValue
+     * @return {boolean}
+     */
+    _validAuditDate(pValue: any): boolean;
+    /**
+     * Toggle the anchored identity + audit popover open or closed. The content is rendered inline
+     * with the record (so the {~E:User^…~} names resolve during the read render); this just flips
+     * its visibility — no overlay.
+     */
+    toggleRecordAudit(): void;
+    /**
+     * Bind the one-time document handlers that dismiss the audit popover on an outside click or
+     * Escape. Browser-level events with no inline-handler equivalent — bound once and guarded so
+     * re-renders don't stack listeners.
+     */
+    _bindAuditDismiss(): void;
+    _auditDismissBound: boolean;
+    /**
+     * Copy a record value (ID or GUID) to the clipboard from the audit popover, with a toast.
+     * @param {string} pValue
+     */
+    copyValue(pValue: string): void;
+    /**
+     * Remove identity + audit descriptors from a (cloned) manifest so they don't render inline
+     * in the record body — they live behind the audit header's Details modal instead. Also
+     * prunes any section left with no descriptors (e.g. an emptied "Audit Trail" section). The
+     * entity's own ID/GUID field names are suppressed alongside the shared audit fields.
+     * @param {Record<string, any>} pManifest - The cloned manifest to mutate.
+     */
+    _suppressAuditDescriptors(pManifest: Record<string, any>): void;
     onBeforeRenderRead(pRecordReadData: any): any;
     formatDisplayData(pRecordListData: any): any;
     onBeforeEdit(): Promise<void>;

package/types/views/read/RecordSet-Read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecordSet-Read.d.ts","sourceRoot":"","sources":["../../../source/views/read/RecordSet-Read.js"],"names":[],"mappings":";AAgQA;IAOE,mBAAyB;IACzB,eAAoB;IACpB,YAAc;IACd,eAAqB;IACrB,kBAAwB;IACxB,eAAqB;IACrB,mCAAwB;IACxB,cAAoB;IACpB;;;;;;;;;;;;;;;;;MAA2B;IAC3B,UAAgB;IAGjB,+BAqCC;IAED,yCAQC;IAED,+DAiBC;IAED,+DAiBC;IASD,wBAIC;IAED,sBAMC;IAED,sBAIC;IAED,8CAIC;IAED,6CAcC;IAED,8BAGC;IAED,8BAGC;IAED,8BAGC;IAED,mCAGC;IAED,8FA8HC;IAED,8BAyBC;IAED;;;;;;;;;;;;;;;;;OAiFC;IAED,gJAsDC;IAED;;;;;;;;SAqLC;CAUD;;;;;AAl5BD,kCAAkC;AAClC,4CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA4P1B"}
+{"version":3,"file":"RecordSet-Read.d.ts","sourceRoot":"","sources":["../../../source/views/read/RecordSet-Read.js"],"names":[],"mappings":";AAwUA;IAOE,mBAAyB;IACzB,eAAoB;IACpB,YAAc;IACd,eAAqB;IACrB,kBAAwB;IACxB,eAAqB;IACrB,mCAAwB;IACxB,cAAoB;IACpB;;;;;;;;;;;;;;;;;MAA2B;IAC3B,UAAgB;IAGjB,+BAqCC;IAED,yCAUC;IAED,+DAiBC;IAED,+DAiBC;IASD,wBAIC;IAED,sBAMC;IAED,sBAIC;IAED;;;;;;;;OAQG;IACH,kCAFW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAyC7B;IAED;;;;;;OAMG;IACH,6BAHW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClB,MAAM,CAuBjB;IAED;;;;;OAKG;IACH,wBAHW,GAAG,GACF,OAAO,CASlB;IAED;;;;OAIG;IACH,0BAOC;IAED;;;;OAIG;IACH,0BA+BC;IAzBA,4BAA8B;IA2B/B;;;OAGG;IACH,kBAFW,MAAM,QAoBhB;IAED;;;;;;OAMG;IACH,qCAFW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAsC7B;IAED,8CAIC;IAED,6CAcC;IAED,8BAGC;IAED,8BAGC;IAED,8BAGC;IAED,mCAGC;IAED,8FAyIC;IAED,8BAyBC;IAED;;;;;;;;;;;;;;;;;OAiFC;IAED,gJA2DC;IAED;;;;;;;;SAqLC;CAUD;;;;;AA9rCD,kCAAkC;AAClC,4CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA8T1B"}