pict-section-recordset 1.6.0 → 1.7.0

package/README.md

@@ -41,6 +41,8 @@ A curated, one-interaction filter bar at the top of the filter drawer — the ha
 
 The control type is inferred from the field's clause (text for a string match, a from/to pair for a date range, a [pict-section-picker](https://github.com/fable-retold/pict-section-picker) for an entity reference). A quick clause lives in the same filter state as every other clause (tagged so the full clause list doesn't show it twice), and is removed when its value is cleared.
 
+**Turning it off.** A single record set opts out with `QuickFilters: false`. To make quick filters **opt-in** across a whole app — only record sets with an explicit `QuickFilters` array show the bar — set the filter view's flag once: `pict.views['PRSP-Filters'].quickFiltersAutoDefault = false`.
+
 ## Related Packages
 
 - [pict](https://github.com/fable-retold/pict) - MVC application framework

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pict-section-recordset",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Pict dynamic record set management views",
   "main": "source/Pict-Section-RecordSet.js",
   "files": [

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

@@ -376,16 +376,23 @@ class RecordSetProviderBase extends libPictProvider
 	// so it serializes / applies / clears like any other clause — the drawer's clause list just skips it.
 
 	/**
-	 * Resolve the quick-filter definitions for this record set: the host's `QuickFilters` config if
-	 * present, else clever defaults derived from the schema. Each definition is resolved to a concrete
-	 * clause descriptor (selected from the field's `AvailableClauses`) so quick filters never invent a
-	 * parallel clause path.
+	 * Resolve the quick-filter definitions for this record set. Precedence: a `QuickFilters` array config
+	 * (curated) → those; `QuickFilters: false` → none (explicit per-record-set opt-out); otherwise clever
+	 * defaults derived from the schema — UNLESS `pAllowCleverDefaults` is false (the host put quick filters
+	 * in opt-in-only mode, so a record set shows the bar only when it sets an explicit `QuickFilters`
+	 * array). Each definition resolves to a concrete clause descriptor from the field's `AvailableClauses`.
 	 *
+	 * @param {boolean} [pAllowCleverDefaults] - false → no clever defaults (opt-in only). Default true.
 	 * @return {Array<{Field:string, Label:string, Control:string, ClauseKey:string}>}
 	 */
-	getQuickFilterDefinitions()
+	getQuickFilterDefinitions(pAllowCleverDefaults)
 	{
-		const tmpEntries = Array.isArray(this.options.QuickFilters) ? this.options.QuickFilters : this._deriveDefaultQuickFilters();
+		const tmpConfig = this.options.QuickFilters;
+		if (tmpConfig === false) { return []; }
+		let tmpEntries;
+		if (Array.isArray(tmpConfig)) { tmpEntries = tmpConfig; }
+		else if (pAllowCleverDefaults === false) { tmpEntries = []; }
+		else { tmpEntries = this._deriveDefaultQuickFilters(); }
 		const tmpDefinitions = [];
 		for (let i = 0; i < tmpEntries.length; i++)
 		{

package/source/views/RecordSet-Filters.js

@@ -619,8 +619,10 @@ class ViewRecordSetSUBSETFilters extends libPictView
 			return;
 		}
 		// Build one item per definition, populating exactly one control slot (text / date / entity).
+		// `quickFiltersAutoDefault` (host-settable, default on) gates the clever schema defaults: a host
+		// can set it false to make quick filters opt-in (only record sets with an explicit config show).
 		const tmpEntityMounts = [];
-		const tmpItems = tmpProvider.getQuickFilterDefinitions().map((pDefinition) =>
+		const tmpItems = tmpProvider.getQuickFilterDefinitions(this.quickFiltersAutoDefault).map((pDefinition) =>
 		{
 			const tmpBase = { Field: pDefinition.Field, ClauseKey: pDefinition.ClauseKey, Label: pDefinition.Label, RecordSet: pRecordSet, ViewContext: pViewContext };
 			const tmpItem = { Label: pDefinition.Label, TextSlot: [], DateSlot: [], EntitySlot: [] };