meadow 2.0.39 → 2.0.40

package/docs/_brand.json

@@ -0,0 +1,18 @@
+{
+	"Hash": "meadow",
+	"Name": "Meadow",
+	"Tagline": "Provider-agnostic data broker with CRUD operations, audit tracking, and soft deletes across 8 database engines",
+	"Palette": "mix",
+	"Icon": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 96 96\" width=\"96\" height=\"96\">\n\t\t<defs>\n\t\t\t<clipPath id=\"frame-meadow-filled-light\">\n\t\t\t\t<path d=\"M 24 2\n\t\tH 72\n\t\tQ 94 2 94 24\n\t\tV 72\n\t\tQ 94 94 72 94\n\t\tH 24\n\t\tQ 2 94 2 72\n\t\tV 24\n\t\tQ 2 2 24 2 Z\"/>\n\t\t\t</clipPath>\n\t\t</defs>\n\t\t<path d=\"M 24 2\n\t\tH 72\n\t\tQ 94 2 94 24\n\t\tV 72\n\t\tQ 94 94 72 94\n\t\tH 24\n\t\tQ 2 94 2 72\n\t\tV 24\n\t\tQ 2 2 24 2 Z\" fill=\"#31cae2\"/>\n\t\t<g clip-path=\"url(#frame-meadow-filled-light)\"><path d=\"M 32.75 15.39 A 36 36 0 0 1 63.25 80.61 Z\" fill=\"rgba(255,255,255,0.18)\" opacity=\"0.95\"/>\n\t\t\t\t\t<path d=\"M 32.75 15.39 A 36 36 0 0 0 63.25 80.61 Z\" fill=\"#dd9166\" opacity=\"0.95\"/></g>\n\t\t<text x=\"48\" y=\"50\" text-anchor=\"middle\" dominant-baseline=\"central\"\n\t\t\tfont-family=\"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif\"\n\t\t\tfont-size=\"56\" font-weight=\"600\"\n\t\t\tfill=\"#ffffff\" letter-spacing=\"-1\">M</text>\n\t</svg>",
+	"IconType": "svg",
+	"Favicon": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 96 96\" width=\"96\" height=\"96\">\n\t\t<defs>\n\t\t\t<clipPath id=\"fav-meadow-light\">\n\t\t\t\t<path d=\"M 24 2\n\t\tH 72\n\t\tQ 94 2 94 24\n\t\tV 72\n\t\tQ 94 94 72 94\n\t\tH 24\n\t\tQ 2 94 2 72\n\t\tV 24\n\t\tQ 2 2 24 2 Z\"/>\n\t\t\t</clipPath>\n\t\t</defs>\n\t\t<path d=\"M 24 2\n\t\tH 72\n\t\tQ 94 2 94 24\n\t\tV 72\n\t\tQ 94 94 72 94\n\t\tH 24\n\t\tQ 2 94 2 72\n\t\tV 24\n\t\tQ 2 2 24 2 Z\" fill=\"#31cae2\"/>\n\t\t<g clip-path=\"url(#fav-meadow-light)\"><circle cx=\"48\" cy=\"48\" r=\"40\" fill=\"rgba(255,255,255,0.22)\"/></g>\n\t\t<text x=\"48\" y=\"50\" text-anchor=\"middle\" dominant-baseline=\"central\"\n\t\t\tfont-family=\"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif\"\n\t\t\tfont-size=\"60\" font-weight=\"800\"\n\t\t\tfill=\"#ffffff\" letter-spacing=\"-1\">M</text>\n\t</svg>",
+	"FaviconDark": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 96 96\" width=\"96\" height=\"96\">\n\t\t<defs>\n\t\t\t<clipPath id=\"fav-meadow-dark\">\n\t\t\t\t<path d=\"M 24 2\n\t\tH 72\n\t\tQ 94 2 94 24\n\t\tV 72\n\t\tQ 94 94 72 94\n\t\tH 24\n\t\tQ 2 94 2 72\n\t\tV 24\n\t\tQ 2 2 24 2 Z\"/>\n\t\t\t</clipPath>\n\t\t</defs>\n\t\t<path d=\"M 24 2\n\t\tH 72\n\t\tQ 94 2 94 24\n\t\tV 72\n\t\tQ 94 94 72 94\n\t\tH 24\n\t\tQ 2 94 2 72\n\t\tV 24\n\t\tQ 2 2 24 2 Z\" fill=\"#86dce9\"/>\n\t\t<g clip-path=\"url(#fav-meadow-dark)\"><circle cx=\"48\" cy=\"48\" r=\"40\" fill=\"rgba(255,255,255,0.22)\"/></g>\n\t\t<text x=\"48\" y=\"50\" text-anchor=\"middle\" dominant-baseline=\"central\"\n\t\t\tfont-family=\"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif\"\n\t\t\tfont-size=\"60\" font-weight=\"800\"\n\t\t\tfill=\"#101418\" letter-spacing=\"-1\">M</text>\n\t</svg>",
+	"Colors": {
+		"Primary": "#31cae2",
+		"Secondary": "#dd9166",
+		"PrimaryLight": "#31cae2",
+		"PrimaryDark": "#86dce9",
+		"SecondaryLight": "#dd9166",
+		"SecondaryDark": "#e9c4af"
+	}
+}

package/docs/index.html

@@ -8,8 +8,6 @@
 
 		<title>Meadow v2.0.33 Documentation</title>
 
-		<!-- Application Stylesheet -->
-		<link href="css/docuserve.css" rel="stylesheet">
 		<!-- KaTeX stylesheet for LaTeX equation rendering -->
 		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.21/dist/katex.min.css">
 		<!-- PICT Dynamic View CSS Container -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meadow",
-  "version": "2.0.39",
+  "version": "2.0.40",
   "description": "A data access library.",
   "main": "source/Meadow.js",
   "scripts": {
@@ -95,7 +95,7 @@
     "meadow-connection-sqlite-browser": "^1.0.2",
     "mongodb": "^6.12.0",
     "mysql2": "^3.18.2",
-    "pict-docuserve": "^1.0.0",
+    "pict-docuserve": "^1.0.1",
     "puppeteer": "^24.38.0",
     "quackage": "^1.2.3",
     "solr-client": "^0.9.0"

package/source/behaviors/Meadow-Create.js

@@ -45,9 +45,13 @@ var meadowBehaviorCreate = function(pMeadow, pQuery, fCallBack)
 					{
 						pMeadow.fable.log.warn('Error during the unique-constraint pre-flight',
 							{ Error: pPreflightError, Message: pPreflightError && pPreflightError.message });
-						return fStageComplete(pPreflightError, pQuery, false);
+						return setImmediate(fStageComplete, pPreflightError, pQuery, false);
 					}
-					return fStageComplete();
+					// Defer via setImmediate so synchronous providers (node:sqlite,
+					// previously better-sqlite3) cannot stack-accumulate frames
+					// across a long synchronous chain of Creates — every record's
+					// pre-flight returns to the event loop before the INSERT runs.
+					return setImmediate(fStageComplete);
 				});
 			},
 			// Step 1: Create the record in the data source

package/source/providers/Meadow-Provider-ALASQL.js

@@ -4,6 +4,8 @@
 * @author <steven@velozo.com>
 */
 
+var libAsyncEachSeries = require('async/eachSeries');
+
 var MeadowProvider = function()
 {
 	function createNew(pFable)
@@ -436,7 +438,25 @@ var MeadowProvider = function()
 		 *      Data:            []     (optional array of records, one object each)
 		 * }
 		 */
-		var constructFromObject = (pParameters) =>
+		/**
+		 * Construct an ALASQL-backed meadow from a JS object array.
+		 *
+		 * Signatures:
+		 *   constructFromObject(pParameters)            — bindObject path only;
+		 *                                                  returns meadow synchronously
+		 *   constructFromObject(pParameters, fCallback) — Import path (doCreate
+		 *                                                  per record); meadow + records
+		 *                                                  delivered via fCallback
+		 *
+		 * The Import path drives `doCreate` per record, which is no longer
+		 * guaranteed to complete in the same tick (Meadow-Create's pre-flight
+		 * yields via setImmediate to keep bulk-create chains stack-safe on
+		 * synchronous providers).  Callers that need the imported records
+		 * queryable on return must pass a callback.  Without a callback the
+		 * Import path is rejected — synchronous fire-and-forget imports were
+		 * a latent footgun and are no longer supported.
+		 */
+		var constructFromObject = (pParameters, fCallback) =>
 		{
 			if ((typeof(pParameters) !== 'object') || (typeof(pParameters.Meadow) !== 'object'))
 				return false;
@@ -452,12 +472,12 @@ var MeadowProvider = function()
 				pParameters.Import = true;
 			if (!Array.isArray(pParameters.Data))
 				pParameters.Data = [];
-				
+
 			// Construct a meadow
 			var tmpMeadow = pParameters.Meadow
 				.new(_Fable, pParameters.Scope)
 				.setProvider('ALASQL');
-			
+
 			var tmpSchema = [];
 			var tmpDefaultIdentifier;
 
@@ -489,7 +509,7 @@ var MeadowProvider = function()
 					case "function":
 						// Do nothing with these types of properties
 						break;
-						
+
 					case "boolean":
 						tmpSchema.push({ Column: tmpProperty, Type:"Boolean" });
 						break;
@@ -499,7 +519,7 @@ var MeadowProvider = function()
 					case "string":
 						tmpSchema.push({ Column: tmpProperty, Type:"Text" });
 						break;
-					
+
 					default:
 						break;
 				}
@@ -516,23 +536,47 @@ var MeadowProvider = function()
 			// Now import the data
 			if(pParameters.Import)
 			{
-				for (var j = 0; j < pParameters.Data.length; j++)
+				if (typeof(fCallback) !== 'function')
 				{
-					tmpMeadow.doCreate(tmpMeadow.query.clone().addRecord(pParameters.Data[j]),
-							function(pError, pQuery, pQueryRead, pRecord)
-							{
-								// Maybe log the error?
-								_Fable.log.trace('Auto imported record', pRecord);
-							}
-						);
+					_Fable.log.error('Meadow-Provider-ALASQL: constructFromObject called with Import=true but no callback — doCreate is no longer synchronous, callers must await record import.');
+					return false;
 				}
+
+				libAsyncEachSeries(
+					pParameters.Data,
+					function (pRecord, fNext)
+					{
+						tmpMeadow.doCreate(tmpMeadow.query.clone().addRecord(pRecord),
+							function (pError, pQuery, pQueryRead, pCreated)
+							{
+								if (pError)
+								{
+									_Fable.log.warn('Meadow-Provider-ALASQL: auto-import doCreate failed', { Error: pError, Record: pRecord });
+								}
+								else
+								{
+									_Fable.log.trace('Auto imported record', pCreated);
+								}
+								// Errors are logged but not propagated — the historical
+								// fire-and-forget loop swallowed them, preserve that
+								// shape so partial imports still return a usable meadow.
+								return fNext();
+							});
+					},
+					function ()
+					{
+						return fCallback(null, tmpMeadow);
+					});
+				return tmpMeadow;
 			}
-			else
+
+			// Just assign the object
+			tmpMeadow.provider.bindObject(pParameters.Data);
+
+			if (typeof(fCallback) === 'function')
 			{
-				// Just assign the object
-				tmpMeadow.provider.bindObject(pParameters.Data);
+				fCallback(null, tmpMeadow);
 			}
-			
 			return tmpMeadow;
 		};
 

package/source/providers/Meadow-Provider-SQLite.js

@@ -105,6 +105,54 @@ var MeadowProvider = function ()
 			return pParams;
 		};
 
+		/**
+		 * Filter a named-parameters object down to only those keys whose
+		 * `:name` form appears in the SQL body.
+		 *
+		 * node:sqlite is strict about unknown named parameters — passing
+		 * a key the prepared statement doesn't reference throws
+		 * `Unknown named parameter '<name>'`.  better-sqlite3 was lenient
+		 * about extras, so this regressed silently when
+		 * meadow-connection-sqlite switched to node:sqlite.  It matters
+		 * whenever Meadow.rawQueries.loadQuery installs an override SQL
+		 * whose placeholders are a strict subset of meadow's auto-
+		 * generated params (filter columns, soft-delete tracking,
+		 * AutoGUID conflict-check), but the filter is cheap and applied
+		 * uniformly — also protects any future case where the auto-built
+		 * SQL and the params dict drift apart.
+		 *
+		 * Approach mirrors `convertNamedToPositional` in the PostgreSQL
+		 * provider: walk the SQL with /:([A-Za-z_][A-Za-z0-9_]*)/g, keep
+		 * names that exist in the params dict, leave the literal alone
+		 * otherwise (handles `::typecast`-style sequences without
+		 * tripping).  Over-matches inside string literals are harmless
+		 * because we only ever *keep* params — never invent them.
+		 */
+		var filterUsedNamedParams = function (pQueryBody, pNamedParams)
+		{
+			if (typeof (pNamedParams) !== 'object' || pNamedParams === null)
+			{
+				return pNamedParams;
+			}
+			if (typeof (pQueryBody) !== 'string')
+			{
+				return pNamedParams;
+			}
+
+			var tmpUsed = {};
+			var tmpPattern = /:([A-Za-z_][A-Za-z0-9_]*)/g;
+			var tmpMatch;
+			while ((tmpMatch = tmpPattern.exec(pQueryBody)) !== null)
+			{
+				var tmpName = tmpMatch[1];
+				if (Object.prototype.hasOwnProperty.call(pNamedParams, tmpName))
+				{
+					tmpUsed[tmpName] = pNamedParams[tmpName];
+				}
+			}
+			return tmpUsed;
+		};
+
 		// The Meadow marshaller passes in the Schema as the third parameter for JSON/JSONProxy deserialization.
 		var marshalRecordFromSourceToObject = function (pObject, pRecord, pSchema)
 		{
@@ -173,6 +221,11 @@ var MeadowProvider = function ()
 
 			var tmpQueryBody = fixDateFunctions(pQuery.query.body);
 			coerceParameters(pQuery.query.parameters);
+			// Filter to keys actually referenced as :name in the SQL —
+			// node:sqlite is strict about unknown named parameters, and
+			// meadow auto-generates filter/Deleted/AutoGUID params that
+			// a rawQueries override may not reference.
+			var tmpBindParams = filterUsedNamedParams(tmpQueryBody, pQuery.query.parameters);
 
 			if (pQuery.logLevel > 0)
 			{
@@ -190,7 +243,7 @@ var MeadowProvider = function ()
 				}
 
 				var tmpStatement = tmpDB.prepare(tmpQueryBody);
-				var tmpInfo = tmpStatement.run(pQuery.query.parameters);
+				var tmpInfo = tmpStatement.run(tmpBindParams);
 
 				tmpResult.error = null;
 				tmpResult.value = false;
@@ -222,6 +275,11 @@ var MeadowProvider = function ()
 
 			var tmpQueryBody = fixDateFunctions(pQuery.query.body);
 			coerceParameters(pQuery.query.parameters);
+			// Filter to keys actually referenced as :name in the SQL —
+			// node:sqlite is strict about unknown named parameters, and
+			// meadow auto-generates filter/Deleted/AutoGUID params that
+			// a rawQueries override may not reference.
+			var tmpBindParams = filterUsedNamedParams(tmpQueryBody, pQuery.query.parameters);
 
 			if (pQuery.logLevel > 0)
 			{
@@ -239,7 +297,7 @@ var MeadowProvider = function ()
 				}
 
 				var tmpStatement = tmpDB.prepare(tmpQueryBody);
-				var tmpRows = tmpStatement.all(pQuery.query.parameters);
+				var tmpRows = tmpStatement.all(tmpBindParams);
 
 				tmpResult.error = null;
 				tmpResult.value = tmpRows;
@@ -262,6 +320,11 @@ var MeadowProvider = function ()
 
 			var tmpQueryBody = fixDateFunctions(pQuery.query.body);
 			coerceParameters(pQuery.query.parameters);
+			// Filter to keys actually referenced as :name in the SQL —
+			// node:sqlite is strict about unknown named parameters, and
+			// meadow auto-generates filter/Deleted/AutoGUID params that
+			// a rawQueries override may not reference.
+			var tmpBindParams = filterUsedNamedParams(tmpQueryBody, pQuery.query.parameters);
 
 			if (pQuery.logLevel > 0)
 			{
@@ -279,7 +342,7 @@ var MeadowProvider = function ()
 				}
 
 				var tmpStatement = tmpDB.prepare(tmpQueryBody);
-				var tmpInfo = tmpStatement.run(pQuery.query.parameters);
+				var tmpInfo = tmpStatement.run(tmpBindParams);
 
 				tmpResult.error = null;
 				tmpResult.value = tmpInfo;
@@ -302,6 +365,11 @@ var MeadowProvider = function ()
 
 			var tmpQueryBody = fixDateFunctions(pQuery.query.body);
 			coerceParameters(pQuery.query.parameters);
+			// Filter to keys actually referenced as :name in the SQL —
+			// node:sqlite is strict about unknown named parameters, and
+			// meadow auto-generates filter/Deleted/AutoGUID params that
+			// a rawQueries override may not reference.
+			var tmpBindParams = filterUsedNamedParams(tmpQueryBody, pQuery.query.parameters);
 
 			if (pQuery.logLevel > 0)
 			{
@@ -319,7 +387,7 @@ var MeadowProvider = function ()
 				}
 
 				var tmpStatement = tmpDB.prepare(tmpQueryBody);
-				var tmpInfo = tmpStatement.run(pQuery.query.parameters);
+				var tmpInfo = tmpStatement.run(tmpBindParams);
 
 				tmpResult.error = null;
 				tmpResult.value = false;
@@ -350,6 +418,11 @@ var MeadowProvider = function ()
 
 			var tmpQueryBody = fixDateFunctions(pQuery.query.body);
 			coerceParameters(pQuery.query.parameters);
+			// Filter to keys actually referenced as :name in the SQL —
+			// node:sqlite is strict about unknown named parameters, and
+			// meadow auto-generates filter/Deleted/AutoGUID params that
+			// a rawQueries override may not reference.
+			var tmpBindParams = filterUsedNamedParams(tmpQueryBody, pQuery.query.parameters);
 
 			if (pQuery.logLevel > 0)
 			{
@@ -367,7 +440,7 @@ var MeadowProvider = function ()
 				}
 
 				var tmpStatement = tmpDB.prepare(tmpQueryBody);
-				var tmpInfo = tmpStatement.run(pQuery.query.parameters);
+				var tmpInfo = tmpStatement.run(tmpBindParams);
 
 				tmpResult.error = null;
 				tmpResult.value = false;
@@ -398,6 +471,11 @@ var MeadowProvider = function ()
 
 			var tmpQueryBody = fixDateFunctions(pQuery.query.body);
 			coerceParameters(pQuery.query.parameters);
+			// Filter to keys actually referenced as :name in the SQL —
+			// node:sqlite is strict about unknown named parameters, and
+			// meadow auto-generates filter/Deleted/AutoGUID params that
+			// a rawQueries override may not reference.
+			var tmpBindParams = filterUsedNamedParams(tmpQueryBody, pQuery.query.parameters);
 
 			if (pQuery.logLevel > 0)
 			{
@@ -415,7 +493,7 @@ var MeadowProvider = function ()
 				}
 
 				var tmpStatement = tmpDB.prepare(tmpQueryBody);
-				var tmpRows = tmpStatement.all(pQuery.query.parameters);
+				var tmpRows = tmpStatement.all(tmpBindParams);
 
 				tmpResult.executed = true;
 				tmpResult.error = null;

package/test/Meadow-Provider-ALASQL.js

@@ -968,26 +968,35 @@ suite
 								{Brand:'Puma', Style:'Lowtop', Size:15, SKU:'dsa33234'}
 							];
 
-						var testMeadow = require('../source/Meadow.js')
-										.new(libFable, 'Master')
-										.setProvider('ALASQL')
-										.provider.constructFromObject(
-											{
-												Meadow: require('../source/Meadow.js').new(libFable, 'Master'),
-												Scope: 'ShoeCity',
-												ObjectPrototype: myData[0],
-												Data: myData
-											});
-
-						testMeadow.doReads(testMeadow.query.clone().addFilter('SKU', 'dsa33234'),
-							function(pError, pQuery, pRecords)
-							{
-								// We should have a record ....
-								Expect(pRecords[0].Style)
-									.to.equal('Lowtop');
-								fDone();
-							}
-						);
+						// constructFromObject's Import path drives doCreate per record,
+						// which is no longer synchronous (Meadow-Create defers its
+						// pre-flight callback via setImmediate to keep bulk-create
+						// chains stack-safe on sync providers).  Pass a callback so
+						// records are queryable before the subsequent doReads runs.
+						require('../source/Meadow.js')
+							.new(libFable, 'Master')
+							.setProvider('ALASQL')
+							.provider.constructFromObject(
+								{
+									Meadow: require('../source/Meadow.js').new(libFable, 'Master'),
+									Scope: 'ShoeCity',
+									ObjectPrototype: myData[0],
+									Data: myData
+								},
+								function (pImportError, testMeadow)
+								{
+									Expect(pImportError, pImportError && pImportError.message).to.not.exist;
+
+									testMeadow.doReads(testMeadow.query.clone().addFilter('SKU', 'dsa33234'),
+										function(pError, pQuery, pRecords)
+										{
+											// We should have a record ....
+											Expect(pRecords[0].Style)
+												.to.equal('Lowtop');
+											fDone();
+										}
+									);
+								});
 					}
 				);
 			}

package/test/Meadow-Provider-SQLite_tests.js

@@ -744,8 +744,11 @@ suite
 						testMeadow.doCount(testMeadow.query.setScope('BadTable'),
 							function(pError, pQuery, pRecord)
 							{
+								// chai's type-detect classifies Error instances
+								// as 'error', not 'object' — assert against the
+								// type chai actually returns.
 								Expect(pError)
-									.to.be.an('object');
+									.to.be.an('error');
 								fDone();
 							}
 						)
@@ -1080,5 +1083,244 @@ suite
 				);
 			}
 		);
+		suite
+		(
+			'Bulk Create — synchronous chain stack safety',
+			function ()
+			{
+				// Regression for the stack-overflow seen during liveconnect_local
+				// bulk sync: every doCreate runs the libRenameSoftDeletedConflicts
+				// pre-flight, which on a sync provider (node:sqlite) returns its
+				// callback in the same tick. Combined with a synchronous caller
+				// chain (eachLimit's replenish loop, or a tail-recursive driver
+				// like this test), per-record frames accumulate without bound.
+				// The fix is a setImmediate barrier at the pre-flight callback
+				// in Meadow-Create.js so each Create yields to the event loop
+				// before the INSERT runs.
+				var _StackTestSchema =
+				[
+					{ Column: 'IDStackTest',    Type: 'AutoIdentity' },
+					{ Column: 'GUIDStackTest',  Type: 'AutoGUID' },
+					{ Column: 'CreateDate',     Type: 'CreateDate' },
+					{ Column: 'CreatingIDUser', Type: 'CreateIDUser' },
+					{ Column: 'UpdateDate',     Type: 'UpdateDate' },
+					{ Column: 'UpdatingIDUser', Type: 'UpdateIDUser' },
+					{ Column: 'Deleted',        Type: 'Deleted' },
+					{ Column: 'DeleteDate',     Type: 'DeleteDate' },
+					{ Column: 'DeletingIDUser', Type: 'DeleteIDUser' },
+					{ Column: 'Code',           Type: 'String', Unique: true },
+					{ Column: 'Name',           Type: 'String' }
+				];
+				var _StackTestDefault =
+				{
+					IDStackTest: 0,
+					GUIDStackTest: '',
+					CreateDate: false,
+					CreatingIDUser: 0,
+					UpdateDate: false,
+					UpdatingIDUser: 0,
+					Deleted: 0,
+					DeleteDate: false,
+					DeletingIDUser: 0,
+					Code: '',
+					Name: ''
+				};
+
+				var newStackTestMeadow = function ()
+				{
+					return require('../source/Meadow.js').new(libFable, 'StackTest')
+						.setProvider('SQLite')
+						.setSchema(_StackTestSchema)
+						.setJsonSchema({ title: 'StackTest', type: 'object', properties: {}, required: [] })
+						.setDefaultIdentifier('IDStackTest')
+						.setDefault(_StackTestDefault);
+				};
+
+				suiteSetup(function (fDone)
+				{
+					var tmpDB = libFable.MeadowSQLiteProvider.db;
+					tmpDB.exec(
+						'CREATE TABLE IF NOT EXISTS StackTest (' +
+						'  IDStackTest INTEGER PRIMARY KEY AUTOINCREMENT,' +
+						'  GUIDStackTest TEXT NOT NULL DEFAULT \'\',' +
+						'  CreateDate TEXT,' +
+						'  CreatingIDUser INTEGER NOT NULL DEFAULT 0,' +
+						'  UpdateDate TEXT,' +
+						'  UpdatingIDUser INTEGER NOT NULL DEFAULT 0,' +
+						'  Deleted INTEGER NOT NULL DEFAULT 0,' +
+						'  DeleteDate TEXT,' +
+						'  DeletingIDUser INTEGER NOT NULL DEFAULT 0,' +
+						'  Code TEXT NOT NULL DEFAULT \'\',' +
+						'  Name TEXT NOT NULL DEFAULT \'\'' +
+						');' +
+						'CREATE UNIQUE INDEX IF NOT EXISTS stacktest_code_unique ON StackTest(Code);'
+					);
+					return fDone();
+				});
+
+				test
+				(
+					'1500 sync-chained doCreate calls complete without RangeError',
+					function (fDone)
+					{
+						// 1500 was chosen empirically: with a single Unique column
+						// pre-flight (one synchronous Read per Create) plus the
+						// surrounding waterfall steps, per-record frame growth
+						// without the fix exceeds V8's default stack budget well
+						// before reaching this count. With the fix in place each
+						// iteration yields to the event loop, so frame growth is
+						// bounded and the chain completes in O(seconds).
+						this.timeout(30000);
+
+						var tmpRecordCount = 1500;
+						var tmpCreated = 0;
+						var tmpFirstError = null;
+
+						var fCreateNext = function (pIndex)
+						{
+							if (pIndex >= tmpRecordCount)
+							{
+								Expect(tmpFirstError, tmpFirstError && tmpFirstError.message).to.not.exist;
+								Expect(tmpCreated).to.equal(tmpRecordCount);
+								return fDone();
+							}
+
+							var tmpMeadow = newStackTestMeadow().setIDUser(1);
+							var tmpQuery = tmpMeadow.query.addRecord(
+								{
+									Code: 'stack-' + pIndex,
+									Name: 'row-' + pIndex
+								});
+
+							// Caller invokes the next iteration synchronously
+							// inside doCreate's terminal callback — the exact
+							// pattern that surfaced the bug.  Without the
+							// setImmediate barrier inside Meadow-Create, this
+							// chain stack-overflows in node:sqlite mid-loop.
+							tmpMeadow.doCreate(tmpQuery, function (pError)
+							{
+								if (pError && !tmpFirstError)
+								{
+									tmpFirstError = pError;
+								}
+								else if (!pError)
+								{
+									tmpCreated++;
+								}
+								return fCreateNext(pIndex + 1);
+							});
+						};
+
+						fCreateNext(0);
+					}
+				);
+			}
+		);
+		suite
+		(
+			'Raw query overrides — parameter handling',
+			function ()
+			{
+				// EXPECTED FAILING (until provider fix lands).
+				//
+				// When rawQueries.loadQuery installs a Read override that
+				// doesn't reference some of the named parameters meadow's
+				// query builder auto-generates (e.g. the soft-delete filter
+				// `Deleted_w1`, or a user-added filter like `IDWidget_w0`),
+				// the SQLite provider still binds them via
+				// `statement.all(pQuery.query.parameters)`.  node:sqlite is
+				// strict about unknown named parameters and throws
+				// `Unknown named parameter '<name>'` — better-sqlite3 was
+				// lenient about extras, so this regressed silently when
+				// meadow-connection-sqlite switched to node:sqlite.
+				//
+				// Isolation: dedicated table + raw-query file with no
+				// placeholders, so the test doesn't depend on FableTest
+				// state mutated by earlier suites.
+				var _WidgetSchema =
+				[
+					{ Column: 'IDWidget',       Type: 'AutoIdentity' },
+					{ Column: 'GUIDWidget',     Type: 'AutoGUID' },
+					{ Column: 'CreateDate',     Type: 'CreateDate' },
+					{ Column: 'CreatingIDUser', Type: 'CreateIDUser' },
+					{ Column: 'UpdateDate',     Type: 'UpdateDate' },
+					{ Column: 'UpdatingIDUser', Type: 'UpdateIDUser' },
+					{ Column: 'Deleted',        Type: 'Deleted' },
+					{ Column: 'DeleteDate',     Type: 'DeleteDate' },
+					{ Column: 'DeletingIDUser', Type: 'DeleteIDUser' },
+					{ Column: 'Label',          Type: 'String' }
+				];
+
+				var newWidgetMeadow = function ()
+				{
+					return require('../source/Meadow.js').new(libFable, 'Widget')
+						.setProvider('SQLite')
+						.setSchema(_WidgetSchema)
+						.setJsonSchema({ title: 'Widget', type: 'object', properties: {}, required: [] })
+						.setDefaultIdentifier('IDWidget');
+				};
+
+				var _RawQueryPath = __dirname + '/Meadow-Provider-SQLite-WidgetRawRead.sql';
+
+				suiteSetup(function (fDone)
+				{
+					var tmpDB = libFable.MeadowSQLiteProvider.db;
+					tmpDB.exec(
+						'CREATE TABLE IF NOT EXISTS Widget (' +
+						'  IDWidget INTEGER PRIMARY KEY AUTOINCREMENT,' +
+						'  GUIDWidget TEXT NOT NULL DEFAULT \'\',' +
+						'  CreateDate TEXT,' +
+						'  CreatingIDUser INTEGER NOT NULL DEFAULT 0,' +
+						'  UpdateDate TEXT,' +
+						'  UpdatingIDUser INTEGER NOT NULL DEFAULT 0,' +
+						'  Deleted INTEGER NOT NULL DEFAULT 0,' +
+						'  DeleteDate TEXT,' +
+						'  DeletingIDUser INTEGER NOT NULL DEFAULT 0,' +
+						'  Label TEXT NOT NULL DEFAULT \'\'' +
+						');'
+					);
+					tmpDB.exec("INSERT INTO Widget (Label) VALUES ('alpha'), ('beta'), ('gamma');");
+
+					// Raw query has no placeholders — projection-only SELECT.
+					libFS.writeFileSync(_RawQueryPath,
+						'SELECT IDWidget, Label AS LabelAlias FROM Widget WHERE IDWidget = 1');
+					return fDone();
+				});
+
+				suiteTeardown(function (fDone)
+				{
+					try { libFS.unlinkSync(_RawQueryPath); } catch (pError) { /* ignore */ }
+					return fDone();
+				});
+
+				test
+				(
+					'doRead with a meadow-generated filter still resolves a parameterless raw query',
+					function (fDone)
+					{
+						var testMeadow = newWidgetMeadow();
+
+						testMeadow.rawQueries.loadQuery('Read', _RawQueryPath, function (pLoaded)
+						{
+							Expect(pLoaded).to.equal(true);
+
+							// addFilter generates a `:IDWidget_w0` named parameter
+							// (and soft-delete tracking adds `:Deleted_w1`).
+							// Neither appears in the raw SQL above.  Without
+							// param-filtering in the provider, node:sqlite
+							// throws "Unknown named parameter 'IDWidget_w0'".
+							testMeadow.doRead(testMeadow.query.addFilter('IDWidget', 1),
+								function (pError, pQuery, pRecord)
+								{
+									Expect(pError, pError && pError.message ? pError.message : pError).to.not.exist;
+									Expect(pRecord, 'pRecord should be a marshalled object, not ' + pRecord).to.be.an('object');
+									Expect(pRecord.LabelAlias).to.equal('alpha');
+									fDone();
+								});
+						});
+					}
+				);
+			}
+		);
 	}
 );

package/docs/css/docuserve.css

@@ -1,327 +0,0 @@
-/* ============================================================================
-   Pict Docuserve - Base Styles & Theme Variables
-   ============================================================================ */
-
-/* ----------------------------------------------------------------------------
-   Theme variables — light defaults on :root.
-   Dark mode applies when either:
-     (a) the user explicitly selected dark via <html data-theme="dark">
-     (b) the user hasn't chosen anything AND the system prefers dark
-   An explicit <html data-theme="light"> pins the light palette regardless.
-   ---------------------------------------------------------------------------- */
-
-:root
-{
-	/* Surfaces */
-	--docuserve-bg: #FDFBF7;
-	--docuserve-bg-elevated: #FFFFFF;
-	--docuserve-border: #DDD6CA;
-	--docuserve-border-soft: #EAE3D8;
-
-	/* Text */
-	--docuserve-text: #2A241E;
-	--docuserve-text-strong: #3D3229;
-	--docuserve-text-muted: #5E5549;
-	--docuserve-text-dim: #8A7F72;
-
-	/* Accent / links */
-	--docuserve-accent: #2E7D74;
-	--docuserve-accent-hover: #236660;
-
-	/* Top bar */
-	--docuserve-topbar-bg: #3D3229;
-	--docuserve-topbar-text: #E8E0D4;
-	--docuserve-topbar-text-muted: #B5AA9A;
-	--docuserve-topbar-text-dim: #8A7F72;
-	--docuserve-topbar-hover-bg: #524438;
-	--docuserve-topbar-version-bg: rgba(255, 255, 255, 0.06);
-	--docuserve-topbar-version-border: rgba(255, 255, 255, 0.08);
-	--docuserve-topbar-version-text: #B5AA9A;
-
-	/* Sidebar */
-	--docuserve-sidebar-bg: #FAF7F1;
-	--docuserve-sidebar-border: #DDD6CA;
-	--docuserve-sidebar-border-soft: #E5DED1;
-	--docuserve-sidebar-text: #423D37;
-	--docuserve-sidebar-group-title: #3D3229;
-	--docuserve-sidebar-module-text: #5E5549;
-	--docuserve-sidebar-hover-bg: #EAE3D8;
-	--docuserve-sidebar-hover-text: #2E7D74;
-	--docuserve-sidebar-active-bg: #E5DED1;
-	--docuserve-sidebar-active-text: #2E7D74;
-	--docuserve-sidebar-search-bg: #FFFFFF;
-	--docuserve-sidebar-search-border: #DDD6CA;
-
-	/* Inline code */
-	--docuserve-inline-code-bg: #F0ECE4;
-	--docuserve-inline-code-text: #9E3A50;
-
-	/* Code block panel */
-	--docuserve-code-bg: #F6F3EE;
-	--docuserve-code-border: #E5DED1;
-	--docuserve-code-gutter-bg: #EFEAE0;
-	--docuserve-code-gutter-border: #DDD6CA;
-	--docuserve-code-gutter-text: #A59986;
-	--docuserve-code-text: #2A241E;
-
-	/* Syntax tokens — low-chroma dark-on-light palette */
-	--docuserve-tok-keyword: #A03472;
-	--docuserve-tok-string: #1A6640;
-	--docuserve-tok-number: #B25A00;
-	--docuserve-tok-comment: #8A7F72;
-	--docuserve-tok-operator: #2E7D74;
-	--docuserve-tok-punctuation: #2A241E;
-	--docuserve-tok-function: #2A5DB0;
-	--docuserve-tok-property: #9E3A50;
-	--docuserve-tok-tag: #9E3A50;
-	--docuserve-tok-attr-name: #B25A00;
-	--docuserve-tok-attr-value: #1A6640;
-
-	/* Tables, blockquotes, mermaid */
-	--docuserve-table-header-bg: #F5F0E8;
-	--docuserve-table-row-alt-bg: #F9F6F0;
-	--docuserve-blockquote-bg: #F7F5F0;
-	--docuserve-blockquote-border: #2E7D74;
-	--docuserve-blockquote-text: #5E5549;
-	--docuserve-mermaid-bg: #FFFFFF;
-
-	/* Scrollbars */
-	--docuserve-scrollbar-track: #F5F0E8;
-	--docuserve-scrollbar-thumb: #D4CCBE;
-	--docuserve-scrollbar-thumb-hover: #B5AA9A;
-}
-
-@media (prefers-color-scheme: dark)
-{
-	:root:not([data-theme="light"])
-	{
-		--docuserve-bg: #15120F;
-		--docuserve-bg-elevated: #1B1814;
-		--docuserve-border: #2F2823;
-		--docuserve-border-soft: #26211C;
-
-		--docuserve-text: #E8E0D4;
-		--docuserve-text-strong: #F2ECE0;
-		--docuserve-text-muted: #B5AA9A;
-		--docuserve-text-dim: #7A6F62;
-
-		--docuserve-accent: #5DB8A8;
-		--docuserve-accent-hover: #7FCCB8;
-
-		--docuserve-topbar-bg: #1A1612;
-		--docuserve-topbar-text: #E8E0D4;
-		--docuserve-topbar-text-muted: #B5AA9A;
-		--docuserve-topbar-text-dim: #7A6F62;
-		--docuserve-topbar-hover-bg: #2A241E;
-		--docuserve-topbar-version-bg: rgba(255, 255, 255, 0.05);
-		--docuserve-topbar-version-border: rgba(255, 255, 255, 0.09);
-		--docuserve-topbar-version-text: #B5AA9A;
-
-		--docuserve-sidebar-bg: #1B1814;
-		--docuserve-sidebar-border: #2F2823;
-		--docuserve-sidebar-border-soft: #26211C;
-		--docuserve-sidebar-text: #C9C0B3;
-		--docuserve-sidebar-group-title: #F2ECE0;
-		--docuserve-sidebar-module-text: #B5AA9A;
-		--docuserve-sidebar-hover-bg: #2A241E;
-		--docuserve-sidebar-hover-text: #7FCCB8;
-		--docuserve-sidebar-active-bg: #2F2823;
-		--docuserve-sidebar-active-text: #7FCCB8;
-		--docuserve-sidebar-search-bg: #26211C;
-		--docuserve-sidebar-search-border: #2F2823;
-
-		--docuserve-inline-code-bg: #2A241E;
-		--docuserve-inline-code-text: #E8B07A;
-
-		--docuserve-code-bg: #1E1A17;
-		--docuserve-code-border: #2F2823;
-		--docuserve-code-gutter-bg: #17130F;
-		--docuserve-code-gutter-border: #2F2823;
-		--docuserve-code-gutter-text: #6A6052;
-		--docuserve-code-text: #E8E0D4;
-
-		--docuserve-tok-keyword: #C678DD;
-		--docuserve-tok-string: #98C379;
-		--docuserve-tok-number: #D19A66;
-		--docuserve-tok-comment: #7F848E;
-		--docuserve-tok-operator: #56B6C2;
-		--docuserve-tok-punctuation: #E8E0D4;
-		--docuserve-tok-function: #61AFEF;
-		--docuserve-tok-property: #E06C75;
-		--docuserve-tok-tag: #E06C75;
-		--docuserve-tok-attr-name: #D19A66;
-		--docuserve-tok-attr-value: #98C379;
-
-		--docuserve-table-header-bg: #26211C;
-		--docuserve-table-row-alt-bg: #1F1B17;
-		--docuserve-blockquote-bg: #1F1B17;
-		--docuserve-blockquote-border: #5DB8A8;
-		--docuserve-blockquote-text: #C9C0B3;
-		--docuserve-mermaid-bg: #E8E0D4;
-
-		--docuserve-scrollbar-track: #1B1814;
-		--docuserve-scrollbar-thumb: #3A322B;
-		--docuserve-scrollbar-thumb-hover: #524438;
-	}
-}
-
-:root[data-theme="dark"]
-{
-	--docuserve-bg: #15120F;
-	--docuserve-bg-elevated: #1B1814;
-	--docuserve-border: #2F2823;
-	--docuserve-border-soft: #26211C;
-
-	--docuserve-text: #E8E0D4;
-	--docuserve-text-strong: #F2ECE0;
-	--docuserve-text-muted: #B5AA9A;
-	--docuserve-text-dim: #7A6F62;
-
-	--docuserve-accent: #5DB8A8;
-	--docuserve-accent-hover: #7FCCB8;
-
-	--docuserve-topbar-bg: #1A1612;
-	--docuserve-topbar-text: #E8E0D4;
-	--docuserve-topbar-text-muted: #B5AA9A;
-	--docuserve-topbar-text-dim: #7A6F62;
-	--docuserve-topbar-hover-bg: #2A241E;
-	--docuserve-topbar-version-bg: rgba(255, 255, 255, 0.05);
-	--docuserve-topbar-version-border: rgba(255, 255, 255, 0.09);
-	--docuserve-topbar-version-text: #B5AA9A;
-
-	--docuserve-sidebar-bg: #1B1814;
-	--docuserve-sidebar-border: #2F2823;
-	--docuserve-sidebar-border-soft: #26211C;
-	--docuserve-sidebar-text: #C9C0B3;
-	--docuserve-sidebar-group-title: #F2ECE0;
-	--docuserve-sidebar-module-text: #B5AA9A;
-	--docuserve-sidebar-hover-bg: #2A241E;
-	--docuserve-sidebar-hover-text: #7FCCB8;
-	--docuserve-sidebar-active-bg: #2F2823;
-	--docuserve-sidebar-active-text: #7FCCB8;
-	--docuserve-sidebar-search-bg: #26211C;
-	--docuserve-sidebar-search-border: #2F2823;
-
-	--docuserve-inline-code-bg: #2A241E;
-	--docuserve-inline-code-text: #E8B07A;
-
-	--docuserve-code-bg: #1E1A17;
-	--docuserve-code-border: #2F2823;
-	--docuserve-code-gutter-bg: #17130F;
-	--docuserve-code-gutter-border: #2F2823;
-	--docuserve-code-gutter-text: #6A6052;
-	--docuserve-code-text: #E8E0D4;
-
-	--docuserve-tok-keyword: #C678DD;
-	--docuserve-tok-string: #98C379;
-	--docuserve-tok-number: #D19A66;
-	--docuserve-tok-comment: #7F848E;
-	--docuserve-tok-operator: #56B6C2;
-	--docuserve-tok-punctuation: #E8E0D4;
-	--docuserve-tok-function: #61AFEF;
-	--docuserve-tok-property: #E06C75;
-	--docuserve-tok-tag: #E06C75;
-	--docuserve-tok-attr-name: #D19A66;
-	--docuserve-tok-attr-value: #98C379;
-
-	--docuserve-table-header-bg: #26211C;
-	--docuserve-table-row-alt-bg: #1F1B17;
-	--docuserve-blockquote-bg: #1F1B17;
-	--docuserve-blockquote-border: #5DB8A8;
-	--docuserve-blockquote-text: #C9C0B3;
-	--docuserve-mermaid-bg: #E8E0D4;
-
-	--docuserve-scrollbar-track: #1B1814;
-	--docuserve-scrollbar-thumb: #3A322B;
-	--docuserve-scrollbar-thumb-hover: #524438;
-}
-
-/* ----------------------------------------------------------------------------
-   Reset and base
-   ---------------------------------------------------------------------------- */
-
-*, *::before, *::after
-{
-	box-sizing: border-box;
-}
-
-html, body
-{
-	margin: 0;
-	padding: 0;
-	font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-	font-size: 16px;
-	line-height: 1.5;
-	color: var(--docuserve-text);
-	background-color: var(--docuserve-bg);
-	-webkit-font-smoothing: antialiased;
-	-moz-osx-font-smoothing: grayscale;
-	transition: background-color 0.15s ease, color 0.15s ease;
-}
-
-/* Typography */
-h1, h2, h3, h4, h5, h6
-{
-	margin-top: 0;
-	line-height: 1.3;
-	color: var(--docuserve-text-strong);
-}
-
-a
-{
-	color: var(--docuserve-accent);
-	text-decoration: none;
-}
-
-a:hover
-{
-	color: var(--docuserve-accent-hover);
-}
-
-/* Application container */
-#Docuserve-Application-Container
-{
-	min-height: 100vh;
-}
-
-/* Utility: scrollbar styling */
-::-webkit-scrollbar
-{
-	width: 8px;
-	height: 8px;
-}
-
-::-webkit-scrollbar-track
-{
-	background: var(--docuserve-scrollbar-track);
-}
-
-::-webkit-scrollbar-thumb
-{
-	background: var(--docuserve-scrollbar-thumb);
-	border-radius: 4px;
-}
-
-::-webkit-scrollbar-thumb:hover
-{
-	background: var(--docuserve-scrollbar-thumb-hover);
-}
-
-/* Responsive adjustments */
-@media (max-width: 768px)
-{
-	html
-	{
-		font-size: 14px;
-	}
-
-	#Docuserve-Sidebar-Container
-	{
-		display: none;
-	}
-
-	.docuserve-body
-	{
-		flex-direction: column;
-	}
-}