meadow-connection-sqlite 1.0.17 → 1.0.19

package/docs/README.md

@@ -10,7 +10,7 @@ SQLite databases are single files that require no server process. This makes the
 npm install meadow-connection-sqlite
 ```
 
-Requires Node.js. The `better-sqlite3` dependency compiles a native addon at install time — a C compiler toolchain must be available on the host.
+Requires Node.js. The `better-sqlite3` dependency compiles a native addon at install time -- a C compiler toolchain must be available on the host.
 
 ## Quick Start
 
@@ -54,7 +54,7 @@ _Fable.MeadowSQLiteProvider.connectAsync(
 			return;
 		}
 
-		// Connection is ready — WAL journaling is enabled automatically
+		// Connection is ready -- WAL journaling is enabled automatically
 		_Fable.log.info('SQLite connected!');
 	});
 ```
@@ -88,8 +88,8 @@ console.log(tmpBooks);
 
 The provider reads `SQLiteFilePath` from two sources, in order of priority:
 
-1. **Constructor options** — passed as the second argument to `instantiateServiceProvider()`
-2. **Fable settings** — `fable.settings.SQLite.SQLiteFilePath`
+1. **Constructor options** -- passed as the second argument to `instantiateServiceProvider()`
+2. **Fable settings** -- `fable.settings.SQLite.SQLiteFilePath`
 
 | Setting | Type | Description |
 |---------|------|-------------|
@@ -141,7 +141,7 @@ let _Fable = new libFable(
             └─────────────────────────┘
 ```
 
-The provider manages the connection lifecycle and exposes the raw `better-sqlite3` `Database` object. All queries go through better-sqlite3's synchronous API — there are no promises or callbacks for individual statements.
+The provider manages the connection lifecycle and exposes the raw `better-sqlite3` `Database` object. All queries go through better-sqlite3's synchronous API -- there are no promises or callbacks for individual statements.
 
 ## Learn More
 

package/docs/_cover.md

@@ -1,12 +1,10 @@
 # Meadow Connection SQLite
 
-<small>v1.0.12</small>
-
 > SQLite database provider for the Meadow data layer
 
 Connect any Fable application to a local SQLite database through the service provider pattern. Built on better-sqlite3 for fast synchronous access with WAL journaling, automatic file creation, and in-memory database support.
 
-- **Zero Config Server** -- No daemon, no Docker — just a file path and you have a database
+- **Zero Config Server** -- No daemon, no Docker -- just a file path and you have a database
 - **Synchronous API** -- All queries run synchronously through better-sqlite3's native bindings
 - **WAL Journaling** -- Write-Ahead Logging enabled automatically for concurrent read/write performance
 - **In-Memory Mode** -- Use `:memory:` as the file path for ephemeral databases in tests and prototypes

package/docs/_version.json

@@ -0,0 +1,7 @@
+{
+	"Name": "meadow-connection-sqlite",
+	"Version": "1.0.18",
+	"Description": "Meadow SQLite Plugin",
+	"GeneratedAt": "2026-04-10T17:21:23.144Z",
+	"GitCommit": "b2227fe"
+}

package/docs/api/connect.md

@@ -22,12 +22,12 @@ Calls `connectAsync()` internally without passing a callback. The provider logs
 
 ```
 Meadow-Connection-SQLite connect() called without a callback; this could
-result in race conditions — use connectAsync(callback) instead.
+result in race conditions -- use connectAsync(callback) instead.
 ```
 
 ## Why This Exists
 
-`connect()` is provided for legacy compatibility and quick prototyping. Because the underlying better-sqlite3 library opens databases synchronously, the connection actually completes immediately — but the method still logs a warning because the Fable service pattern expects asynchronous lifecycle management.
+`connect()` is provided for legacy compatibility and quick prototyping. Because the underlying better-sqlite3 library opens databases synchronously, the connection actually completes immediately -- but the method still logs a warning because the Fable service pattern expects asynchronous lifecycle management.
 
 ## Usage
 

package/docs/api/connectAsync.md

@@ -60,7 +60,7 @@ Calling `connectAsync()` on an already-connected provider logs an error but does
 _Fable.MeadowSQLiteProvider.connectAsync(
 	(pError, pDatabase) =>
 	{
-		// First connection — succeeds normally
+		// First connection -- succeeds normally
 
 		_Fable.MeadowSQLiteProvider.connectAsync(
 			(pError, pDatabase2) =>
@@ -111,7 +111,7 @@ If `connectAsync()` is called without a callback, the provider logs an error:
 
 ```
 Meadow-Connection-SQLite connect() called without a callback; this could
-result in race conditions — use connectAsync(callback) instead.
+result in race conditions -- use connectAsync(callback) instead.
 ```
 
 ## Related

package/docs/api/createTable.md

@@ -25,7 +25,7 @@ None. Results are delivered via the callback.
 2. Executes the DDL using `db.exec()`
 3. Calls back with `undefined` on success, or an error if the DDL fails
 
-Because the generated DDL uses `CREATE TABLE IF NOT EXISTS`, calling `createTable()` for an already-existing table is a no-op — it does not error.
+Because the generated DDL uses `CREATE TABLE IF NOT EXISTS`, calling `createTable()` for an already-existing table is a no-op -- it does not error.
 
 ## Basic Usage
 
@@ -68,7 +68,7 @@ _Fable.MeadowSQLiteProvider.createTable(tmpBookSchema,
 		_Fable.MeadowSQLiteProvider.createTable(tmpBookSchema,
 			(pError) =>
 			{
-				// No error — "IF NOT EXISTS" handles it
+				// No error -- "IF NOT EXISTS" handles it
 			});
 	});
 ```

package/docs/api/db.md

@@ -22,7 +22,7 @@ The `db` getter is the main entry point for all query operations. All queries go
 ```javascript
 let tmpDB = _Fable.MeadowSQLiteProvider.db;
 
-// DDL — run raw SQL (no return value)
+// DDL -- run raw SQL (no return value)
 tmpDB.exec(`
 	CREATE TABLE IF NOT EXISTS Book (
 		IDBook INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -31,16 +31,16 @@ tmpDB.exec(`
 	)
 `);
 
-// INSERT / UPDATE / DELETE — returns { changes, lastInsertRowid }
+// INSERT / UPDATE / DELETE -- returns { changes, lastInsertRowid }
 let tmpResult = tmpDB.prepare('INSERT INTO Book (Title, Author) VALUES (?, ?)').run('Dune', 'Frank Herbert');
 console.log(tmpResult.lastInsertRowid); // => 1
 console.log(tmpResult.changes);         // => 1
 
-// SELECT single row — returns object or undefined
+// SELECT single row -- returns object or undefined
 let tmpBook = tmpDB.prepare('SELECT * FROM Book WHERE IDBook = ?').get(1);
 console.log(tmpBook.Title); // => 'Dune'
 
-// SELECT all rows — returns array of objects
+// SELECT all rows -- returns array of objects
 let tmpBooks = tmpDB.prepare('SELECT * FROM Book').all();
 console.log(tmpBooks.length); // => 1
 ```

package/docs/api/generateDropTableStatement.md

@@ -35,7 +35,7 @@ DROP TABLE IF EXISTS Book;
 
 ## Executing the Drop
 
-The method only generates the SQL — it does not execute it. Use `db.exec()` to run it:
+The method only generates the SQL -- it does not execute it. Use `db.exec()` to run it:
 
 ```javascript
 let tmpDropSQL = _Fable.MeadowSQLiteProvider.generateDropTableStatement('Book');
@@ -49,7 +49,7 @@ The generated statement uses `IF EXISTS`, so dropping a table that does not exis
 ```javascript
 let tmpDropSQL = _Fable.MeadowSQLiteProvider.generateDropTableStatement('NonExistentTable');
 _Fable.MeadowSQLiteProvider.db.exec(tmpDropSQL);
-// No error — IF EXISTS handles it
+// No error -- IF EXISTS handles it
 ```
 
 ## Comparison with MSSQL

package/docs/api/preparedStatement.md

@@ -51,12 +51,12 @@ Use `db` when you want to check for connection state gracefully. Use `preparedSt
 ## Comparison with MSSQL Provider
 
 ```javascript
-// MSSQL — each access creates a new PreparedStatement
+// MSSQL -- each access creates a new PreparedStatement
 let tmpPS = _Fable.MeadowMSSQLProvider.preparedStatement;
 tmpPS.input('id', _Fable.MeadowMSSQLProvider.MSSQL.Int);
 tmpPS.prepare('SELECT * FROM Book WHERE IDBook = @id', ...);
 
-// SQLite — returns the Database handle (prepare directly)
+// SQLite -- returns the Database handle (prepare directly)
 let tmpDB = _Fable.MeadowSQLiteProvider.preparedStatement;
 let tmpStmt = tmpDB.prepare('SELECT * FROM Book WHERE IDBook = ?');
 ```

package/docs/api/reference.md

@@ -26,7 +26,7 @@ On construction:
 - Sets `connected` to `false`
 - Reads `SQLiteFilePath` from `fable.settings.SQLite` if available
 
-The provider is not connected after construction — call `connectAsync()` to open the database.
+The provider is not connected after construction -- call `connectAsync()` to open the database.
 
 ---
 
@@ -66,7 +66,7 @@ Always `'MeadowConnectionSQLite'`.
 | Method | Description |
 |--------|-------------|
 | [`connectAsync(fCallback)`](connectAsync.md) | Open the database and enable WAL (recommended) |
-| [`connect()`](connect.md) | Synchronous wrapper — logs a race-condition warning |
+| [`connect()`](connect.md) | Synchronous wrapper -- logs a race-condition warning |
 
 ---
 

package/docs/architecture.md

@@ -67,10 +67,10 @@ flowchart LR
 	subgraph "better-sqlite3 Synchronous API"
 		EXEC["db.exec(sql)<br/>DDL / multi-statement"]
 		PREP["db.prepare(sql)"]
-		RUN["stmt.run(params)<br/>→ { changes, lastInsertRowid }"]
-		GET["stmt.get(params)<br/>→ object | undefined"]
-		ALL["stmt.all(params)<br/>→ array of objects"]
-		TXN["db.transaction(fn)<br/>→ atomic wrapper"]
+		RUN["stmt.run(params)<br/>-> { changes, lastInsertRowid }"]
+		GET["stmt.get(params)<br/>-> object | undefined"]
+		ALL["stmt.all(params)<br/>-> array of objects"]
+		TXN["db.transaction(fn)<br/>-> atomic wrapper"]
 	end
 
 	PREP --> RUN
@@ -114,8 +114,8 @@ flowchart TD
 
 Settings priority:
 
-1. **Constructor options** — passed as the second argument to `instantiateServiceProvider()`
-2. **Fable settings** — `fable.settings.SQLite.SQLiteFilePath`
+1. **Constructor options** -- passed as the second argument to `instantiateServiceProvider()`
+2. **Fable settings** -- `fable.settings.SQLite.SQLiteFilePath`
 
 Constructor options take priority, allowing multiple provider instances with different database files.
 

package/docs/css/docuserve.css

@@ -1,73 +1,327 @@
 /* ============================================================================
-   Pict Docuserve - Base Styles
+   Pict Docuserve - Base Styles & Theme Variables
    ============================================================================ */
 
-/* Reset and base */
-*, *::before, *::after {
+/* ----------------------------------------------------------------------------
+   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 {
+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: #423D37;
-	background-color: #fff;
+	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 {
+h1, h2, h3, h4, h5, h6
+{
 	margin-top: 0;
 	line-height: 1.3;
+	color: var(--docuserve-text-strong);
 }
 
-a {
-	color: #2E7D74;
+a
+{
+	color: var(--docuserve-accent);
 	text-decoration: none;
 }
 
-a:hover {
-	color: #256861;
+a:hover
+{
+	color: var(--docuserve-accent-hover);
 }
 
 /* Application container */
-#Docuserve-Application-Container {
+#Docuserve-Application-Container
+{
 	min-height: 100vh;
 }
 
 /* Utility: scrollbar styling */
-::-webkit-scrollbar {
+::-webkit-scrollbar
+{
 	width: 8px;
+	height: 8px;
 }
 
-::-webkit-scrollbar-track {
-	background: #F5F0E8;
+::-webkit-scrollbar-track
+{
+	background: var(--docuserve-scrollbar-track);
 }
 
-::-webkit-scrollbar-thumb {
-	background: #D4CCBE;
+::-webkit-scrollbar-thumb
+{
+	background: var(--docuserve-scrollbar-thumb);
 	border-radius: 4px;
 }
 
-::-webkit-scrollbar-thumb:hover {
-	background: #B5AA9A;
+::-webkit-scrollbar-thumb:hover
+{
+	background: var(--docuserve-scrollbar-thumb-hover);
 }
 
 /* Responsive adjustments */
-@media (max-width: 768px) {
-	html {
+@media (max-width: 768px)
+{
+	html
+	{
 		font-size: 14px;
 	}
 
-	#Docuserve-Sidebar-Container {
+	#Docuserve-Sidebar-Container
+	{
 		display: none;
 	}
 
-	.docuserve-body {
+	.docuserve-body
+	{
 		flex-direction: column;
 	}
 }

package/docs/examples-pipeline.md

@@ -278,7 +278,7 @@ console.log(`Total value: $${tmpStats.TotalValue.toFixed(2)}`);
 tmpDB.close();
 ```
 
-After closing, further queries on this database instance will throw. The provider's `connected` property remains `true` — if you need to reconnect, create a new provider instance.
+After closing, further queries on this database instance will throw. The provider's `connected` property remains `true` -- if you need to reconnect, create a new provider instance.
 
 ---
 

package/docs/index.html

@@ -4,9 +4,9 @@
 		<meta charset="utf-8">
 		<meta http-equiv="X-UA-Compatible" content="IE=edge">
 		<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
-		<meta name="description" content="Documentation powered by pict-docuserve">
+		<meta name="description" content="Meadow Connection SQLite v1.0.18 Documentation — Meadow SQLite Plugin">
 
-		<title>Documentation</title>
+		<title>Meadow Connection SQLite v1.0.18 Documentation</title>
 
 		<!-- Application Stylesheet -->
 		<link href="css/docuserve.css" rel="stylesheet">

package/docs/quickstart.md

@@ -4,7 +4,7 @@ Get a SQLite database connected and running in five steps.
 
 ---
 
-## Step 1 — Install
+## Step 1 -- Install
 
 ```bash
 npm install meadow-connection-sqlite fable
@@ -14,7 +14,7 @@ npm install meadow-connection-sqlite fable
 
 ---
 
-## Step 2 — Configure and Connect
+## Step 2 -- Configure and Connect
 
 ```javascript
 const libFable = require('fable');
@@ -53,7 +53,7 @@ For in-memory databases (useful in tests), set `SQLiteFilePath` to `":memory:"`.
 
 ---
 
-## Step 3 — Run Queries
+## Step 3 -- Run Queries
 
 All queries use the synchronous `better-sqlite3` API via the `db` getter:
 
@@ -101,7 +101,7 @@ console.log(tmpBook.Title);
 
 ---
 
-## Step 4 — Create Tables from Schema
+## Step 4 -- Create Tables from Schema
 
 Instead of writing DDL by hand, pass a Meadow table schema to `createTable()`:
 
@@ -146,7 +146,7 @@ CREATE TABLE IF NOT EXISTS Book (IDBook INTEGER PRIMARY KEY AUTOINCREMENT, GUIDB
 
 ---
 
-## Step 5 — Meadow ORM Integration
+## Step 5 -- Meadow ORM Integration
 
 Wire the SQLite connection into Meadow for full ORM capabilities:
 

package/docs/retold-catalog.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-03-01T22:42:54.080Z",
+	"Generated": "2026-04-10T17:21:22.875Z",
 	"GitHubOrg": "stevenvelozo",
 	"DefaultBranch": "master",
 	"Groups": [

package/docs/retold-keyword-index.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-03-01T22:42:54.183Z",
+	"Generated": "2026-04-10T17:21:23.119Z",
 	"DocumentCount": 10,
 	"LunrIndex": {
 		"version": "2.3.9",

package/docs/schema.md

@@ -26,7 +26,7 @@ SQLite uses a flexible type system called "type affinity." Unlike MySQL or MSSQL
 - **REAL** -- Used for decimal/floating-point values
 - **TEXT** -- Used for strings, GUIDs, and dates (ISO-8601 format)
 
-The `Size` field on Meadow `String` columns is accepted but has no effect in SQLite — `TEXT` columns have unlimited length.
+The `Size` field on Meadow `String` columns is accepted but has no effect in SQLite -- `TEXT` columns have unlimited length.
 
 ---
 
@@ -82,7 +82,7 @@ CREATE TABLE IF NOT EXISTS Book (IDBook INTEGER PRIMARY KEY AUTOINCREMENT, GUIDB
 
 Key behaviors:
 
-- Always uses `CREATE TABLE IF NOT EXISTS` — safe to run repeatedly
+- Always uses `CREATE TABLE IF NOT EXISTS` -- safe to run repeatedly
 - Column names are used as-is (no quoting needed in SQLite)
 - The `ID` column is always `INTEGER PRIMARY KEY AUTOINCREMENT`
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "meadow-connection-sqlite",
-    "version": "1.0.17",
+    "version": "1.0.19",
     "description": "Meadow SQLite Plugin",
     "main": "source/Meadow-Connection-SQLite.js",
     "scripts": {
@@ -42,7 +42,8 @@
     },
     "homepage": "https://github.com/stevenvelozo/meadow-connection-sqlite",
     "devDependencies": {
-        "quackage": "^1.0.59",
+        "pict-docuserve": "^0.1.5",
+        "quackage": "^1.1.0",
         "retold-harness": "^1.1.2"
     },
     "dependencies": {

package/source/Meadow-Connection-SQLite-FormSchema.js

@@ -0,0 +1,32 @@
+/**
+ * Connection form schema for SQLite.
+ *
+ * Consumed by meadow-connection-manager#getProviderFormSchema('SQLite').
+ * Pure data — safe to require() even when better-sqlite3 is not
+ * installed.  See Meadow-Connection-MySQL-FormSchema.js for the field
+ * contract.
+ *
+ * SQLite is file-based; the only configurable input is the path to the
+ * database file.  A leading `~` is expanded to the user's home directory
+ * by retold-data-service before the connection is opened.
+ */
+'use strict';
+
+module.exports =
+{
+	Provider:    'SQLite',
+	DisplayName: 'SQLite',
+	Description: 'Open or create a local SQLite database file.',
+	Fields:
+	[
+		{
+			Name:        'SQLiteFilePath',
+			Label:       'SQLite File Path',
+			Type:        'Path',
+			Default:     '~/headlight-liveconnect-local/cloned.sqlite',
+			Required:    true,
+			Placeholder: '~/headlight-liveconnect-local/cloned.sqlite',
+			Help:        'A leading ~ is expanded to your home directory.  Parent directories are created automatically.'
+		}
+	]
+};

package/source/Meadow-Schema-SQLite.js

@@ -85,6 +85,12 @@ class MeadowSchemaSQLite extends libFableServiceProviderBase
 				case 'Boolean':
 					tmpCreateTableStatement += `        ${tmpColumn.Column} INTEGER NOT NULL DEFAULT 0`;
 					break;
+				case 'JSON':
+					tmpCreateTableStatement += `        ${tmpColumn.Column} TEXT`;
+					break;
+				case 'JSONProxy':
+					tmpCreateTableStatement += `        ${tmpColumn.StorageColumn} TEXT`;
+					break;
 				default:
 					break;
 			}
@@ -935,6 +941,10 @@ class MeadowSchemaSQLite extends libFableServiceProviderBase
 				return 'DateTime';
 			case 'Boolean':
 				return 'Boolean';
+			case 'JSON':
+				return 'JSON';
+			case 'JSONProxy':
+				return 'JSONProxy';
 			default:
 				return 'String';
 		}
@@ -968,6 +978,10 @@ class MeadowSchemaSQLite extends libFableServiceProviderBase
 				return '';
 			case 'Boolean':
 				return false;
+			case 'JSON':
+				return {};
+			case 'JSONProxy':
+				return {};
 			default:
 				return '';
 		}