foxhound 2.0.26 → 2.0.27

package/README.md

@@ -6,15 +6,15 @@ FoxHound is a database query builder that generates dialect-specific SQL from a
 
 ## Features
 
-- **Chainable API** — every configuration method returns the query object for fluent composition
-- **Multiple Dialects** — generate SQL for MySQL, PostgreSQL, MSSQL, SQLite, ALASQL, or plain English from the same code
-- **Parameterized Queries** — user-supplied values are always bound as named parameters, preventing SQL injection
-- **Schema-Aware** — automatic management of identity columns, timestamps, user stamps, and soft-delete tracking
-- **Full CRUD + Count** — build CREATE, READ, UPDATE, DELETE, UNDELETE, and COUNT queries
-- **Query Overrides** — underscore-style templates for custom SQL while retaining automatic parameter binding
-- **Filtering & Sorting** — rich filter expressions with multiple operators, logical grouping, and multi-column sorting
-- **Joins & Pagination** — INNER, LEFT, and custom joins plus dialect-aware LIMIT/OFFSET pagination
-- **Fable Integration** — operates as a Fable service, inheriting configuration, logging, and UUID generation
+- **Chainable API** -- every configuration method returns the query object for fluent composition
+- **Multiple Dialects** -- generate SQL for MySQL, PostgreSQL, MSSQL, SQLite, ALASQL, or plain English from the same code
+- **Parameterized Queries** -- user-supplied values are always bound as named parameters, preventing SQL injection
+- **Schema-Aware** -- automatic management of identity columns, timestamps, user stamps, and soft-delete tracking
+- **Full CRUD + Count** -- build CREATE, READ, UPDATE, DELETE, UNDELETE, and COUNT queries
+- **Query Overrides** -- underscore-style templates for custom SQL while retaining automatic parameter binding
+- **Filtering & Sorting** -- rich filter expressions with multiple operators, logical grouping, and multi-column sorting
+- **Joins & Pagination** -- INNER, LEFT, and custom joins plus dialect-aware LIMIT/OFFSET pagination
+- **Fable Integration** -- operates as a Fable service, inheriting configuration, logging, and UUID generation
 
 ## Quick Start
 
@@ -55,14 +55,14 @@ FoxHound follows a configure-then-build pattern.  You create a query instance, c
 ```
 Application Code
   └── FoxHound Query
-        ├── setScope('Books')         → target table
-        ├── addFilter('Genre', '...')  → WHERE clause
-        ├── addSort('Title')          → ORDER BY clause
-        ├── setCap(25)                → LIMIT clause
-        ├── setDialect('MySQL')       → output format
-        └── buildReadQuery()          → SQL generation
-              ├── query.body          → SQL string
-              └── query.parameters    → bound values
+        ├── setScope('Books')         -> target table
+        ├── addFilter('Genre', '...')  -> WHERE clause
+        ├── addSort('Title')          -> ORDER BY clause
+        ├── setCap(25)                -> LIMIT clause
+        ├── setDialect('MySQL')       -> output format
+        └── buildReadQuery()          -> SQL generation
+              ├── query.body          -> SQL string
+              └── query.parameters    -> bound values
 ```
 
 ## Dialects
@@ -83,14 +83,14 @@ When a schema is attached, FoxHound automatically manages special columns:
 
 | Type | Description |
 |------|-------------|
-| `AutoIdentity` | Auto-increment primary key — `NULL` on insert, skipped on update |
+| `AutoIdentity` | Auto-increment primary key -- `NULL` on insert, skipped on update |
 | `AutoGUID` | Automatically generated UUID on insert |
 | `CreateDate` / `CreateIDUser` | Auto-populated on insert only |
 | `UpdateDate` / `UpdateIDUser` | Auto-populated on insert and update |
 | `DeleteDate` / `DeleteIDUser` | Auto-populated on soft delete |
-| `Deleted` | Soft-delete flag — auto-filtered in reads |
-| `JSON` | Structured JSON data — serialized to `TEXT` on write, parsed on read |
-| `JSONProxy` | JSON stored in a different SQL column — uses `StorageColumn` for SQL, virtual name for objects |
+| `Deleted` | Soft-delete flag -- auto-filtered in reads |
+| `JSON` | Structured JSON data -- serialized to `TEXT` on write, parsed on read |
+| `JSONProxy` | JSON stored in a different SQL column -- uses `StorageColumn` for SQL, virtual name for objects |
 
 ## Filter Operators
 
@@ -125,7 +125,7 @@ npm run docker-dev-build
 npm run docker-dev-run
 ```
 
-3. Open http://localhost:24238/ — the password is "retold"
+3. Open http://localhost:24238/ -- the password is "retold"
 
 ## Documentation
 

package/docs/README.md

@@ -6,15 +6,15 @@ FoxHound is a fluent query generation DSL for Node.js and the browser.  It produ
 
 ## Features
 
-- **Chainable API** — every configuration method returns the query object, so you can compose queries in a single expression
-- **Multiple Dialects** — generate SQL for MySQL, PostgreSQL, Microsoft SQL Server, SQLite, ALASQL, or plain English, all from the same code
-- **Parameterized Queries** — user-supplied values are always bound as named parameters, preventing SQL injection
-- **Schema-Aware** — when a schema is provided, FoxHound automatically manages identity columns, timestamps, user stamps, and soft-delete tracking
-- **Full CRUD + Count** — build CREATE, READ, UPDATE, DELETE, UNDELETE, and COUNT queries
-- **Query Overrides** — supply an underscore-style template to customize query generation while still benefiting from automatic parameter binding
-- **Filtering & Sorting** — rich filter expressions with multiple operators, logical grouping, and multi-column sorting
-- **Joins & Pagination** — INNER, LEFT, and custom joins plus dialect-aware LIMIT/OFFSET pagination
-- **Fable Integration** — operates as a Fable service, inheriting configuration, logging, and UUID generation
+- **Chainable API** -- every configuration method returns the query object, so you can compose queries in a single expression
+- **Multiple Dialects** -- generate SQL for MySQL, PostgreSQL, Microsoft SQL Server, SQLite, ALASQL, or plain English, all from the same code
+- **Parameterized Queries** -- user-supplied values are always bound as named parameters, preventing SQL injection
+- **Schema-Aware** -- when a schema is provided, FoxHound automatically manages identity columns, timestamps, user stamps, and soft-delete tracking
+- **Full CRUD + Count** -- build CREATE, READ, UPDATE, DELETE, UNDELETE, and COUNT queries
+- **Query Overrides** -- supply an underscore-style template to customize query generation while still benefiting from automatic parameter binding
+- **Filtering & Sorting** -- rich filter expressions with multiple operators, logical grouping, and multi-column sorting
+- **Joins & Pagination** -- INNER, LEFT, and custom joins plus dialect-aware LIMIT/OFFSET pagination
+- **Fable Integration** -- operates as a Fable service, inheriting configuration, logging, and UUID generation
 
 ## Quick Start
 
@@ -48,24 +48,24 @@ console.log(tmpQuery.query.parameters);
 
 ## How It Works
 
-1. **Create a Query** — instantiate via `foxhound.new(fable)` or through a Fable service
-2. **Configure** — chain methods to set scope (table), fields, filters, sorts, joins, and pagination
-3. **Set a Dialect** — call `.setDialect('MySQL')` (or PostgreSQL, MSSQL, SQLite, ALASQL, English)
-4. **Build** — call a build method such as `.buildReadQuery()` to generate the SQL
-5. **Execute** — read the generated SQL from `.query.body` and bound parameters from `.query.parameters`
+1. **Create a Query** -- instantiate via `foxhound.new(fable)` or through a Fable service
+2. **Configure** -- chain methods to set scope (table), fields, filters, sorts, joins, and pagination
+3. **Set a Dialect** -- call `.setDialect('MySQL')` (or PostgreSQL, MSSQL, SQLite, ALASQL, English)
+4. **Build** -- call a build method such as `.buildReadQuery()` to generate the SQL
+5. **Execute** -- read the generated SQL from `.query.body` and bound parameters from `.query.parameters`
 
 ## Documentation
 
-- [Quickstart](quickstart.md) — get up and running in five minutes
-- [Architecture](architecture.md) — understand FoxHound's internal design
-- [Filters](filters.md) — filter operators and logical grouping
-- [Sorting](sorting.md) — ORDER BY clause generation
-- [Joins](joins.md) — multi-table queries
-- [Pagination](pagination.md) — LIMIT/OFFSET across dialects
-- [Schema Integration](schema.md) — automatic column management
-- [Dialects](dialects/README.md) — dialect-specific features and differences
-- [API Reference](api/README.md) — complete function reference with code examples
-- [Query Overrides](query-overrides.md) — custom SQL templates
+- [Quickstart](quickstart.md) -- get up and running in five minutes
+- [Architecture](architecture.md) -- understand FoxHound's internal design
+- [Filters](filters.md) -- filter operators and logical grouping
+- [Sorting](sorting.md) -- ORDER BY clause generation
+- [Joins](joins.md) -- multi-table queries
+- [Pagination](pagination.md) -- LIMIT/OFFSET across dialects
+- [Schema Integration](schema.md) -- automatic column management
+- [Dialects](dialects/README.md) -- dialect-specific features and differences
+- [API Reference](api/README.md) -- complete function reference with code examples
+- [Query Overrides](query-overrides.md) -- custom SQL templates
 
 ## Related Packages
 

package/docs/_cover.md

@@ -1,4 +1,4 @@
-# FoxHound <small>2</small>
+# FoxHound
 
 > A fluent query generation DSL for Node.js and the browser
 

package/docs/_version.json

@@ -0,0 +1,7 @@
+{
+	"Name": "foxhound",
+	"Version": "2.0.26",
+	"Description": "A Database Query generation library.",
+	"GeneratedAt": "2026-04-10T17:20:13.929Z",
+	"GitCommit": "9fe56f5"
+}

package/docs/api/behaviorFlags.md

@@ -120,4 +120,4 @@ tmpQuery
 	.setDisableDeleteTracking(true);
 ```
 
-This gives you full manual control over all column values — useful for data migration or import scenarios.
+This gives you full manual control over all column values -- useful for data migration or import scenarios.

package/docs/api/buildQuery.md

@@ -89,7 +89,7 @@ Generate a soft-delete UPDATE or a hard DELETE.
 When a schema has a `Deleted` column type and delete tracking is enabled:
 
 ```javascript
-// Soft delete — generates an UPDATE
+// Soft delete -- generates an UPDATE
 tmpQuery.buildDeleteQuery();
 // => UPDATE `Books` SET Deleted = 1, DeleteDate = NOW(3), ...
 ```
@@ -97,7 +97,7 @@ tmpQuery.buildDeleteQuery();
 When no schema or delete tracking is disabled:
 
 ```javascript
-// Hard delete — generates a DELETE
+// Hard delete -- generates a DELETE
 tmpQuery.setDisableDeleteTracking(true).buildDeleteQuery();
 // => DELETE FROM `Books` WHERE IDBook = :IDBook_w0;
 ```

package/docs/api/clone.md

@@ -18,7 +18,7 @@ Returns a new FoxHound query instance with copies of the current scope, begin, c
 
 ### Description
 
-Cloning is useful when you need to build multiple similar queries from the same base configuration.  The cloned query has its own independent state — changes to the clone do not affect the original.
+Cloning is useful when you need to build multiple similar queries from the same base configuration.  The cloned query has its own independent state -- changes to the clone do not affect the original.
 
 ### Example
 

package/docs/api/setScope.md

@@ -20,7 +20,7 @@ Returns `this` for chaining.
 
 ## Description
 
-The scope defines which table (or collection, in NoSQL dialects) the query targets.  This is required for all query types — it appears as the `FROM` clause in SELECT, `INSERT INTO` in CREATE, `UPDATE` in UPDATE, and `DELETE FROM` in DELETE.
+The scope defines which table (or collection, in NoSQL dialects) the query targets.  This is required for all query types -- it appears as the `FROM` clause in SELECT, `INSERT INTO` in CREATE, `UPDATE` in UPDATE, and `DELETE FROM` in DELETE.
 
 FoxHound validates that the input is a string.  Non-string values are ignored and an error is logged.
 

package/docs/architecture.md

@@ -168,10 +168,10 @@ tmpQuery
 
 FoxHound depends on Fable for:
 
-- **UUID Generation** — each query and record gets a unique identifier via `_Fable.getUUID()`
-- **Logging** — filter, scope, and query errors are logged through `_Fable.log`
-- **Utility Functions** — `_Fable.Utility.extend()` for parameter merging and `_Fable.Utility.template()` for query overrides
-- **Configuration** — inherits any relevant settings from the Fable config
+- **UUID Generation** -- each query and record gets a unique identifier via `_Fable.getUUID()`
+- **Logging** -- filter, scope, and query errors are logged through `_Fable.log`
+- **Utility Functions** -- `_Fable.Utility.extend()` for parameter merging and `_Fable.Utility.template()` for query overrides
+- **Configuration** -- inherits any relevant settings from the Fable config
 
 ## Schema-Aware Generation
 

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/dialects/README.md

@@ -45,10 +45,10 @@ Each method receives the full Parameters object and returns a SQL string (or `fa
 
 All SQL dialects share these behaviors:
 
-- **Parameterized values** — user data is always bound as named parameters, never interpolated
-- **Schema-aware column management** — AutoIdentity, timestamps, user stamps, and soft-delete columns are handled automatically based on schema type annotations
-- **Soft-delete filtering** — Read and Count queries automatically exclude rows where the `Deleted` column is `1` (when schema is present)
-- **Query overrides** — Read and Count queries support underscore templates for custom SQL generation
+- **Parameterized values** -- user data is always bound as named parameters, never interpolated
+- **Schema-aware column management** -- AutoIdentity, timestamps, user stamps, and soft-delete columns are handled automatically based on schema type annotations
+- **Soft-delete filtering** -- Read and Count queries automatically exclude rows where the `Deleted` column is `1` (when schema is present)
+- **Query overrides** -- Read and Count queries support underscore templates for custom SQL generation
 
 ## Choosing a Dialect
 

package/docs/dialects/postgresql.md

@@ -56,7 +56,7 @@ INSERT INTO "Books" ( "IDBook", "Title") VALUES ( DEFAULT, :Title_1) RETURNING *
 
 ## RETURNING Clause
 
-All INSERT statements include `RETURNING *`, which returns the full inserted row — including any auto-generated values like serial IDs and default timestamps.
+All INSERT statements include `RETURNING *`, which returns the full inserted row -- including any auto-generated values like serial IDs and default timestamps.
 
 ## Joins
 

package/docs/dialects/sqlite.md

@@ -10,7 +10,7 @@ SQLite uses backtick quoting for identifiers to avoid conflicts with SQLite's ma
 SELECT * FROM Books WHERE `Genre` = :Genre_w0;
 ```
 
-Table names are not quoted in the SQLite dialect — they are used as plain identifiers.
+Table names are not quoted in the SQLite dialect -- they are used as plain identifiers.
 
 ## Named Parameters
 
@@ -49,7 +49,7 @@ SELECT COUNT(DISTINCT IDBook) AS RowCount FROM Books;
 
 ## Soft Delete
 
-Works the same as other dialects — when a `Deleted` column is present in the schema, Delete generates an UPDATE:
+Works the same as other dialects -- when a `Deleted` column is present in the schema, Delete generates an UPDATE:
 
 ```sql
 UPDATE Books SET `Deleted` = 1, `DeleteDate` = NOW(),
@@ -63,9 +63,9 @@ The `NOW()` calls are replaced with `datetime('now')` by the Meadow SQLite provi
 
 When using the Meadow SQLite provider with `better-sqlite3`:
 
-- **Boolean coercion** — `better-sqlite3` only accepts numbers, strings, bigints, buffers, and null. The provider automatically converts boolean values (`true`/`false`) to integers (`1`/`0`)
-- **Undefined coercion** — undefined values are converted to `null`
-- **Synchronous execution** — `better-sqlite3` is synchronous, but the Meadow provider wraps calls in an async-compatible callback pattern
+- **Boolean coercion** -- `better-sqlite3` only accepts numbers, strings, bigints, buffers, and null. The provider automatically converts boolean values (`true`/`false`) to integers (`1`/`0`)
+- **Undefined coercion** -- undefined values are converted to `null`
+- **Synchronous execution** -- `better-sqlite3` is synchronous, but the Meadow provider wraps calls in an async-compatible callback pattern
 
 ## Query Overrides
 

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="FoxHound v2.0.26 Documentation — A Database Query generation library.">
 
-		<title>Documentation</title>
+		<title>FoxHound v2.0.26 Documentation</title>
 
 		<!-- Application Stylesheet -->
 		<link href="css/docuserve.css" rel="stylesheet">

package/docs/joins.md

@@ -94,8 +94,8 @@ Invalid joins are logged as warnings and silently skipped.
 
 ## Dialect Differences
 
-- **MySQL** — `INNER JOIN Authors ON Authors.IDAuthor = Books.IDAuthor`
-- **MSSQL** — `INNER JOIN [Authors] ON Authors.IDAuthor = Books.IDAuthor`
-- **SQLite/ALASQL** — joins are supported in Read queries but not generated (the SQLite and ALASQL dialects do not include a `generateJoins` function; joins work through query overrides)
+- **MySQL** -- `INNER JOIN Authors ON Authors.IDAuthor = Books.IDAuthor`
+- **MSSQL** -- `INNER JOIN [Authors] ON Authors.IDAuthor = Books.IDAuthor`
+- **SQLite/ALASQL** -- joins are supported in Read queries but not generated (the SQLite and ALASQL dialects do not include a `generateJoins` function; joins work through query overrides)
 
 > **Note:** The SQLite and ALASQL dialects are primarily designed for simpler single-table queries.  For complex join scenarios, consider using a query override or the MySQL/MSSQL dialect.

package/docs/query/README.md

@@ -8,9 +8,9 @@ FoxHound builds queries through a two-phase process: **configure** then **build*
 Configure  ──►  Build  ──►  Access Results
 ```
 
-1. **Configure** — set the scope, fields, filters, sorts, joins, pagination, records, and dialect
-2. **Build** — call one of the `build*Query()` methods to generate the SQL
-3. **Access** — read `query.body` for the SQL string and `query.parameters` for bound values
+1. **Configure** -- set the scope, fields, filters, sorts, joins, pagination, records, and dialect
+2. **Build** -- call one of the `build*Query()` methods to generate the SQL
+3. **Access** -- read `query.body` for the SQL string and `query.parameters` for bound values
 
 ## Creating a Query Instance
 
@@ -84,7 +84,7 @@ After a query is built, you can reset the parameters for reuse or clone the quer
 // Reset to default parameters
 tmpQuery.resetParameters();
 
-// Clone — copies scope, begin, cap, schema, filters, sorts, and dataElements
+// Clone -- copies scope, begin, cap, schema, filters, sorts, and dataElements
 var tmpClone = tmpQuery.clone();
 ```
 

package/docs/query/create.md

@@ -60,7 +60,7 @@ tmpQuery.setDisableDeleteTracking(true);  // Include delete columns on insert
 
 The INSERT syntax is largely the same across dialects, with a few differences:
 
-- **MySQL** — uses backtick-quoted identifiers and `:name` parameters
-- **MSSQL** — uses bracket-quoted identifiers, `@name` parameters, and skips the AutoIdentity column entirely (rather than inserting NULL)
-- **SQLite** — uses backtick-quoted identifiers and `:name` parameters
-- **ALASQL** — same as SQLite
+- **MySQL** -- uses backtick-quoted identifiers and `:name` parameters
+- **MSSQL** -- uses bracket-quoted identifiers, `@name` parameters, and skips the AutoIdentity column entirely (rather than inserting NULL)
+- **SQLite** -- uses backtick-quoted identifiers and `:name` parameters
+- **ALASQL** -- same as SQLite

package/docs/query/update.md

@@ -27,13 +27,13 @@ When a schema is present, FoxHound manages certain columns automatically:
 
 | Schema Type | Behavior on Update |
 |------------|-------------------|
-| `AutoIdentity` | **Skipped** — never updated |
-| `CreateDate` | **Skipped** — set only on insert |
-| `CreateIDUser` | **Skipped** — set only on insert |
+| `AutoIdentity` | **Skipped** -- never updated |
+| `CreateDate` | **Skipped** -- set only on insert |
+| `CreateIDUser` | **Skipped** -- set only on insert |
 | `UpdateDate` | Set to current timestamp automatically |
 | `UpdateIDUser` | Set to the value from `setIDUser()` |
-| `DeleteDate` | **Skipped** — managed by delete operations |
-| `DeleteIDUser` | **Skipped** — managed by delete operations |
+| `DeleteDate` | **Skipped** -- managed by delete operations |
+| `DeleteIDUser` | **Skipped** -- managed by delete operations |
 
 ## Disabling Auto-Management
 
@@ -44,13 +44,13 @@ tmpQuery.setDisableAutoUserStamp(true);   // Don't auto-set UpdateIDUser
 
 ## Important Notes
 
-- The record passed to `addRecord()` should contain only the columns you want to change — FoxHound generates SET clauses for each key in the record object
+- The record passed to `addRecord()` should contain only the columns you want to change -- FoxHound generates SET clauses for each key in the record object
 - Always include a filter (usually on the primary key) to avoid updating all rows
 - If the record object is empty or no records have been added, `buildUpdateQuery()` returns `false` for the query body
 
 ## Dialect Differences
 
-- **MySQL** — backtick-quoted identifiers, `:name` parameters
-- **MSSQL** — bracket-quoted identifiers, `@name` parameters; special handling for `UpdateDate` with `disableAutoDateStamp`
-- **SQLite** — backtick-quoted identifiers, `:name` parameters
-- **ALASQL** — same as SQLite
+- **MySQL** -- backtick-quoted identifiers, `:name` parameters
+- **MSSQL** -- bracket-quoted identifiers, `@name` parameters; special handling for `UpdateDate` with `disableAutoDateStamp`
+- **SQLite** -- backtick-quoted identifiers, `:name` parameters
+- **ALASQL** -- same as SQLite

package/docs/query-overrides.md

@@ -85,4 +85,4 @@ Query overrides are useful when you need:
 - `UNION` queries
 - Any SQL feature not directly supported by FoxHound's fluent API
 
-For straightforward CRUD operations, the standard query builders are preferred — they are safer and more portable across dialects.
+For straightforward CRUD operations, the standard query builders are preferred -- they are safer and more portable across dialects.

package/docs/quickstart.md

@@ -189,8 +189,8 @@ console.log(tmpQuery.query.body);
 
 ## Next Steps
 
-- [Architecture](architecture.md) — understand FoxHound's internal design
-- [Filters](filters.md) — learn about filter operators and grouping
-- [Schema Integration](schema.md) — use schemas for automatic column management
-- [Dialects](dialects/README.md) — explore dialect-specific features
-- [API Reference](api/README.md) — complete function reference
+- [Architecture](architecture.md) -- understand FoxHound's internal design
+- [Filters](filters.md) -- learn about filter operators and grouping
+- [Schema Integration](schema.md) -- use schemas for automatic column management
+- [Dialects](dialects/README.md) -- explore dialect-specific features
+- [API Reference](api/README.md) -- complete function reference

package/docs/retold-catalog.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-03-03T14:33:09.873Z",
+	"Generated": "2026-04-10T17:20:13.644Z",
 	"GitHubOrg": "stevenvelozo",
 	"DefaultBranch": "master",
 	"Groups": [

package/docs/retold-keyword-index.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-03-03T14:33:09.982Z",
+	"Generated": "2026-04-10T17:20:13.902Z",
 	"DocumentCount": 27,
 	"LunrIndex": {
 		"version": "2.3.9",

package/docs/schema.md

@@ -1,6 +1,6 @@
 # Schema Integration
 
-FoxHound is schema-aware — when a schema array is attached to a query, it uses the column type annotations to automatically manage identity columns, timestamps, user stamps, and soft-delete tracking.
+FoxHound is schema-aware -- when a schema array is attached to a query, it uses the column type annotations to automatically manage identity columns, timestamps, user stamps, and soft-delete tracking.
 
 ## Attaching a Schema
 
@@ -29,22 +29,22 @@ tmpQuery.query.schema = [
 
 | Type | Purpose | Create | Read | Update | Delete | Undelete |
 |------|---------|--------|------|--------|--------|----------|
-| `AutoIdentity` | Auto-increment primary key | `NULL` (DB assigns) | included | **skipped** | — | — |
-| `AutoGUID` | Auto-generated UUID | UUID or user value | included | included | — | — |
-| `CreateDate` | Row creation timestamp | `NOW()` | included | **skipped** | — | — |
-| `CreateIDUser` | Row creator user ID | `IDUser` | included | **skipped** | — | — |
+| `AutoIdentity` | Auto-increment primary key | `NULL` (DB assigns) | included | **skipped** | -- | -- |
+| `AutoGUID` | Auto-generated UUID | UUID or user value | included | included | -- | -- |
+| `CreateDate` | Row creation timestamp | `NOW()` | included | **skipped** | -- | -- |
+| `CreateIDUser` | Row creator user ID | `IDUser` | included | **skipped** | -- | -- |
 | `UpdateDate` | Last modification timestamp | `NOW()` | included | `NOW()` | `NOW()` | `NOW()` |
-| `UpdateIDUser` | Last modifier user ID | `IDUser` | included | `IDUser` | — | `IDUser` |
-| `Deleted` | Soft-delete flag | `0` | auto-filtered | — | set to `1` | set to `0` |
-| `DeleteDate` | Deletion timestamp | **skipped** | included | **skipped** | `NOW()` | — |
-| `DeleteIDUser` | Deleter user ID | **skipped** | included | **skipped** | `IDUser` | — |
-| `String` | Text data | parameterized | included | parameterized | — | — |
-| `Integer` | Numeric data | parameterized | included | parameterized | — | — |
-| `Decimal` | Decimal data | parameterized | included | parameterized | — | — |
-| `Boolean` | Boolean data | parameterized | included | parameterized | — | — |
-| `DateTime` | Date/time data | parameterized | included | parameterized | — | — |
-| `JSON` | Structured JSON data | `JSON.stringify` | included | `JSON.stringify` | — | — |
-| `JSONProxy` | JSON with different SQL column name | `JSON.stringify` to `StorageColumn` | included | `JSON.stringify` to `StorageColumn` | — | — |
+| `UpdateIDUser` | Last modifier user ID | `IDUser` | included | `IDUser` | -- | `IDUser` |
+| `Deleted` | Soft-delete flag | `0` | auto-filtered | -- | set to `1` | set to `0` |
+| `DeleteDate` | Deletion timestamp | **skipped** | included | **skipped** | `NOW()` | -- |
+| `DeleteIDUser` | Deleter user ID | **skipped** | included | **skipped** | `IDUser` | -- |
+| `String` | Text data | parameterized | included | parameterized | -- | -- |
+| `Integer` | Numeric data | parameterized | included | parameterized | -- | -- |
+| `Decimal` | Decimal data | parameterized | included | parameterized | -- | -- |
+| `Boolean` | Boolean data | parameterized | included | parameterized | -- | -- |
+| `DateTime` | Date/time data | parameterized | included | parameterized | -- | -- |
+| `JSON` | Structured JSON data | `JSON.stringify` | included | `JSON.stringify` | -- | -- |
+| `JSONProxy` | JSON with different SQL column name | `JSON.stringify` to `StorageColumn` | included | `JSON.stringify` to `StorageColumn` | -- | -- |
 
 ## JSON and JSON Proxy Types
 
@@ -99,33 +99,33 @@ Nested paths are supported (e.g., `Metadata.dimensions.width`). JSON Proxy colum
 
 ### Create (INSERT)
 
-- `AutoIdentity` → inserts `NULL` (MySQL/SQLite) or is omitted (MSSQL)
-- `AutoGUID` → generates a UUID via Fable, unless the record has a valid GUID already
-- `CreateDate`, `UpdateDate` → inserts the current timestamp
-- `CreateIDUser`, `UpdateIDUser` → inserts the user ID from `setIDUser()`
-- `DeleteDate`, `DeleteIDUser` → **skipped** (when delete tracking is enabled)
+- `AutoIdentity` -> inserts `NULL` (MySQL/SQLite) or is omitted (MSSQL)
+- `AutoGUID` -> generates a UUID via Fable, unless the record has a valid GUID already
+- `CreateDate`, `UpdateDate` -> inserts the current timestamp
+- `CreateIDUser`, `UpdateIDUser` -> inserts the user ID from `setIDUser()`
+- `DeleteDate`, `DeleteIDUser` -> **skipped** (when delete tracking is enabled)
 
 ### Update
 
-- `AutoIdentity`, `CreateDate`, `CreateIDUser`, `DeleteDate`, `DeleteIDUser` → **skipped**
-- `UpdateDate` → set to current timestamp automatically
-- `UpdateIDUser` → set to the value from `setIDUser()`
-- All other columns → parameterized from the record
+- `AutoIdentity`, `CreateDate`, `CreateIDUser`, `DeleteDate`, `DeleteIDUser` -> **skipped**
+- `UpdateDate` -> set to current timestamp automatically
+- `UpdateIDUser` -> set to the value from `setIDUser()`
+- All other columns -> parameterized from the record
 
 ### Delete (Soft)
 
 Only these columns are modified:
-- `Deleted` → set to `1`
-- `DeleteDate` → set to current timestamp
-- `UpdateDate` → set to current timestamp
-- `DeleteIDUser` → set to the value from `setIDUser()`
+- `Deleted` -> set to `1`
+- `DeleteDate` -> set to current timestamp
+- `UpdateDate` -> set to current timestamp
+- `DeleteIDUser` -> set to the value from `setIDUser()`
 
 ### Undelete
 
 Only these columns are modified:
-- `Deleted` → set to `0`
-- `UpdateDate` → set to current timestamp
-- `UpdateIDUser` → set to the value from `setIDUser()`
+- `Deleted` -> set to `0`
+- `UpdateDate` -> set to current timestamp
+- `UpdateIDUser` -> set to the value from `setIDUser()`
 
 ### Read / Count
 

package/docs/sorting.md

@@ -33,7 +33,7 @@ tmpQuery
 // ORDER BY Genre, PublishedYear DESC
 ```
 
-Columns without an explicit `Direction` (or with `Direction: 'Ascending'`) sort in ascending order — the SQL default.
+Columns without an explicit `Direction` (or with `Direction: 'Ascending'`) sort in ascending order -- the SQL default.
 
 ## Setting Sorts Directly
 
@@ -71,9 +71,9 @@ tmpQuery.setSort({Column: 'Title', Direction: 'Descending'});
 
 The `ORDER BY` clause syntax is consistent across all SQL dialects.  The main difference is in identifier quoting:
 
-- **MySQL** — `ORDER BY PublishedYear DESC`
-- **MSSQL** — `ORDER BY [PublishedYear] DESC`
-- **SQLite/ALASQL** — `ORDER BY \`PublishedYear\` DESC`
+- **MySQL** -- `ORDER BY PublishedYear DESC`
+- **MSSQL** -- `ORDER BY [PublishedYear] DESC`
+- **SQLite/ALASQL** -- `ORDER BY \`PublishedYear\` DESC`
 
 ## Interaction with Pagination
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "foxhound",
-    "version": "2.0.26",
+    "version": "2.0.27",
     "description": "A Database Query generation library.",
     "main": "source/FoxHound.js",
     "scripts": {
@@ -48,7 +48,8 @@
     },
     "homepage": "https://github.com/stevenvelozo/foxhound",
     "devDependencies": {
-        "quackage": "^1.0.63"
+        "pict-docuserve": "^0.1.5",
+        "quackage": "^1.1.0"
     },
     "dependencies": {
         "fable": "^3.1.63",

package/source/dialects/MicrosoftSQL/FoxHound-Dialect-MSSQL.js

@@ -179,6 +179,51 @@ var FoxHoundDialectMSSQL = function(pFable)
 		return tmpFieldList;
 	};
 
+	/**
+	* Generate a field list for the outer SELECT of the legacy pagination
+	* wrapper.  The outer FROM is a subquery aliased as [_Paged], so the
+	* default "[Table].*" qualifier can't resolve there — we need either
+	* an explicit column list from the schema or a bare "*".
+	*
+	* If the caller set explicit dataElements, reuse them (they reference
+	* bare column names, which work fine against the subquery alias).
+	* Otherwise emit an explicit list from the schema to keep [_RowNum]
+	* from leaking.  As a last resort, fall back to "*" — callers without
+	* a schema will see [_RowNum] as an extra property on marshalled
+	* records but the query itself remains valid.
+	*
+	* @param: {Object} pParameters SQL Query Parameters
+	* @return: {String} Field list (prefixed with a single leading space)
+	*/
+	var generateOuterFieldListForLegacyPagination = function(pParameters)
+	{
+		var tmpDataElements = pParameters.dataElements;
+		if (Array.isArray(tmpDataElements) && tmpDataElements.length > 0)
+		{
+			// Reuse the caller-supplied list.  It emits unqualified column
+			// names ([Col], [Col] AS [Alias]) which resolve fine against
+			// the subquery alias.
+			return generateFieldList(pParameters);
+		}
+
+		var tmpSchema = Array.isArray(pParameters.query.schema) ? pParameters.query.schema : [];
+		if (tmpSchema.length > 0)
+		{
+			var tmpList = ' ';
+			for (var i = 0; i < tmpSchema.length; i++)
+			{
+				if (i > 0) tmpList += ', ';
+				tmpList += generateSafeFieldName(tmpSchema[i].Column);
+			}
+			return tmpList;
+		}
+
+		// No schema, no explicit dataElements — "*" is the best we can do.
+		// [_RowNum] will surface on marshalled records; downstream code can
+		// ignore it.  Schemas are the norm via Meadow so this is rare.
+		return ' *';
+	};
+
 	/**
 	* Ensure a field name is properly escaped.
 	*/
@@ -352,12 +397,41 @@ var FoxHoundDialectMSSQL = function(pFable)
 		return tmpWhere;
 	};
 
+	/**
+	* Find the table's AutoIdentity primary-key column from the schema, if any.
+	* Used as a deterministic default ORDER BY when the caller didn't set a
+	* sort — MSSQL pagination (both OFFSET/FETCH and ROW_NUMBER) requires an
+	* ORDER BY clause or it produces a syntax error.
+	*
+	* @param: {Object} pParameters SQL Query Parameters
+	* @return: {String|null} The column name, or null if none found
+	*/
+	var findPrimaryKeyColumn = function(pParameters)
+	{
+		var tmpSchema = Array.isArray(pParameters.query.schema) ? pParameters.query.schema : [];
+		for (var i = 0; i < tmpSchema.length; i++)
+		{
+			if (tmpSchema[i].Type === 'AutoIdentity')
+			{
+				return tmpSchema[i].Column;
+			}
+		}
+		return null;
+	};
+
 	/**
 	* Generate an ORDER BY clause from the sort array
 	*
 	* Each entry in the sort is an object like:
 	* {Column:'Color',Direction:'Descending'}
 	*
+	* When no sort is specified but the query has a cap (pagination is
+	* active), inject a default ORDER BY on the primary key so MSSQL
+	* doesn't reject the OFFSET/FETCH or ROW_NUMBER clause.  Without a
+	* schema the PK can't be inferred — fall back to `ORDER BY (SELECT 1)`
+	* which is legal for OFFSET/FETCH but not for ROW_NUMBER (the legacy
+	* pagination path handles that case by refusing to paginate).
+	*
 	* @method: generateOrderBy
 	* @param: {Object} pParameters SQL Query Parameters
 	* @return: {String} Returns the field list clause
@@ -367,6 +441,15 @@ var FoxHoundDialectMSSQL = function(pFable)
 		var tmpOrderBy = pParameters.sort;
 		if (!Array.isArray(tmpOrderBy) || tmpOrderBy.length < 1)
 		{
+			if (pParameters.cap)
+			{
+				var tmpPK = findPrimaryKeyColumn(pParameters);
+				if (tmpPK)
+				{
+					return ' ORDER BY ['+tmpPK+']';
+				}
+				return ' ORDER BY (SELECT 1)';
+			}
 			return '';
 		}
 
@@ -390,6 +473,12 @@ var FoxHoundDialectMSSQL = function(pFable)
 	/**
 	* Generate the limit clause
 	*
+	* When `legacyPagination` is set on pParameters the limit is emitted
+	* by the Read function using a ROW_NUMBER() subquery wrapper instead
+	* (OFFSET/FETCH NEXT requires SQL Server 2012+ / compatibility level
+	* 110+, which some customers don't have).  In that case this function
+	* returns an empty string.
+	*
 	* @method: generateLimit
 	* @param: {Object} pParameters SQL Query Parameters
 	* @return: {String} Returns the table limit clause
@@ -401,6 +490,13 @@ var FoxHoundDialectMSSQL = function(pFable)
 			return '';
 		}
 
+		if (pParameters.legacyPagination)
+		{
+			// The Read function wraps the query in a ROW_NUMBER() subquery
+			// instead of appending an OFFSET/FETCH tail clause.
+			return '';
+		}
+
 		var tmpLimit = ' OFFSET ';
 		// If there is a begin record, we'll pass that in as well.
 		if (pParameters.begin !== false)
@@ -1037,6 +1133,30 @@ var FoxHoundDialectMSSQL = function(pFable)
 			}
 		}
 
+		// Legacy pagination path — emit a ROW_NUMBER() wrapper instead of
+		// OFFSET/FETCH.  Required for SQL Server 2008 R2 and earlier, or
+		// for databases running at a compatibility level below 110 (2012).
+		// Enabled via pParameters.legacyPagination (forwarded from the
+		// meadow-connection-mssql provider's LegacyPagination config).
+		if (pParameters.legacyPagination && pParameters.cap)
+		{
+			var tmpBegin = (pParameters.begin !== false) ? pParameters.begin : 0;
+			var tmpEnd = tmpBegin + pParameters.cap;
+			// generateOrderBy always returns a usable ORDER BY when cap is
+			// set.  ROW_NUMBER()'s OVER() clause takes the same body but
+			// without the leading space.
+			var tmpOverClause = tmpOrderBy.replace(/^ /, '');
+			// The outer SELECT's FROM is the subquery alias, not the base
+			// table — so the default field list's "[Table].*" qualifier
+			// won't resolve at the outer level.  Compute an outer field
+			// list that works regardless of whether the caller supplied
+			// explicit dataElements or relied on the default.
+			var tmpOuterFieldList = generateOuterFieldListForLegacyPagination(pParameters);
+			// INDEX hints and JOINs live on the inner select (they apply
+			// to the base table).  [_RowNum] is confined to the subquery.
+			return `SELECT${tmpOptDistinct}${tmpOuterFieldList} FROM (SELECT${tmpFieldList}, ROW_NUMBER() OVER (${tmpOverClause}) AS [_RowNum] FROM${tmpTableName}${tmpIndexHints}${tmpJoin}${tmpWhere}) AS [_Paged] WHERE [_RowNum] > ${tmpBegin} AND [_RowNum] <= ${tmpEnd};`;
+		}
+
 		return `SELECT${tmpOptDistinct}${tmpFieldList} FROM${tmpTableName}${tmpIndexHints}${tmpJoin}${tmpWhere}${tmpOrderBy}${tmpLimit};`;
 	};
 

package/test/Foxhound-Dialect-MSSQL_tests.js

@@ -618,7 +618,7 @@ suite
 						// This is the query generated by the MSSQL dialect
 						_Fable.log.trace('Select Query', tmpQuery.query);
 						Expect(tmpQuery.query.body)
-							.to.equal('SELECT [Name], [Age], [Cost] FROM [Animal] WHERE [Deleted] = @Deleted_w0 OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;');
+							.to.equal('SELECT [Name], [Age], [Cost] FROM [Animal] WHERE [Deleted] = @Deleted_w0 ORDER BY [IDAnimal] OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;');
 					}
 				);
 				test
@@ -640,7 +640,7 @@ suite
 						// This is the query generated by the MSSQL dialect
 						_Fable.log.trace('Select Query', tmpQuery.query);
 						Expect(tmpQuery.query.body)
-							.to.equal('SELECT DISTINCT [Name], [Age], [Cost] FROM [Animal] WHERE [Deleted] = @Deleted_w0 OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;');
+							.to.equal('SELECT DISTINCT [Name], [Age], [Cost] FROM [Animal] WHERE [Deleted] = @Deleted_w0 ORDER BY [IDAnimal] OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;');
 					}
 				);
 				test
@@ -669,7 +669,7 @@ suite
 						// This is the query generated by the MSSQL dialect
 						_Fable.log.trace('Select Query', tmpQuery.query);
 						Expect(tmpQuery.query.body)
-							.to.equal('SELECT [Name], [Age], [Cost] FROM [Animal] WHERE [Age] = @Age_w0 AND ( [Color] = @Color_w2 OR [Color] = @Color_w3 ) AND [Description] IS NOT NULL AND [IDOffice] IN ( @IDOffice_w6 ) AND [Deleted] = @Deleted_w7 OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;');
+							.to.equal('SELECT [Name], [Age], [Cost] FROM [Animal] WHERE [Age] = @Age_w0 AND ( [Color] = @Color_w2 OR [Color] = @Color_w3 ) AND [Description] IS NOT NULL AND [IDOffice] IN ( @IDOffice_w6 ) AND [Deleted] = @Deleted_w7 ORDER BY [IDAnimal] OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;');
 					}
 				);
 				test
@@ -691,7 +691,62 @@ suite
 						// This is the query generated by the MSSQL dialect
 						_Fable.log.trace('Select Query', tmpQuery.query);
 						Expect(tmpQuery.query.body)
-							.to.equal('SELECT [Name], [Age], [Cost] FROM [Animal] OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;');
+							.to.equal('SELECT [Name], [Age], [Cost] FROM [Animal] ORDER BY [IDAnimal] OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;');
+					}
+				);
+				test
+				(
+					'Read Query with legacyPagination uses ROW_NUMBER() wrapper (caller sort)',
+					function()
+					{
+						var tmpQuery = libFoxHound.new(_Fable)
+							.setDialect('MSSQL')
+							.setScope('Animal')
+							.setDataElements(['Name', 'Age', 'Cost'])
+							.setCap(10)
+							.setBegin(20)
+							.setSort([{Column:'Age',Direction:'Ascending'}]);
+						tmpQuery.query.schema = _AnimalSchema;
+						tmpQuery.parameters.legacyPagination = true;
+						tmpQuery.buildReadQuery();
+						_Fable.log.trace('Legacy Select Query', tmpQuery.query);
+						Expect(tmpQuery.query.body)
+							.to.equal('SELECT [Name], [Age], [Cost] FROM (SELECT [Name], [Age], [Cost], ROW_NUMBER() OVER (ORDER BY [Age]) AS [_RowNum] FROM [Animal] WHERE [Deleted] = @Deleted_w0) AS [_Paged] WHERE [_RowNum] > 20 AND [_RowNum] <= 30;');
+					}
+				);
+				test
+				(
+					'Read Query with legacyPagination injects PK ORDER BY when caller omits sort',
+					function()
+					{
+						var tmpQuery = libFoxHound.new(_Fable)
+							.setDialect('MSSQL')
+							.setScope('Animal')
+							.setDataElements(['Name', 'Age', 'Cost'])
+							.setCap(10);
+						tmpQuery.query.schema = _AnimalSchema;
+						tmpQuery.parameters.legacyPagination = true;
+						tmpQuery.buildReadQuery();
+						_Fable.log.trace('Legacy Select Query', tmpQuery.query);
+						Expect(tmpQuery.query.body)
+							.to.equal('SELECT [Name], [Age], [Cost] FROM (SELECT [Name], [Age], [Cost], ROW_NUMBER() OVER (ORDER BY [IDAnimal]) AS [_RowNum] FROM [Animal] WHERE [Deleted] = @Deleted_w0) AS [_Paged] WHERE [_RowNum] > 0 AND [_RowNum] <= 10;');
+					}
+				);
+				test
+				(
+					'Read Query with legacyPagination is inert without cap',
+					function()
+					{
+						// No cap → no pagination at all (legacy or otherwise);
+						// the flag should be a no-op and not produce a ROW_NUMBER wrapper.
+						var tmpQuery = libFoxHound.new(_Fable)
+							.setDialect('MSSQL')
+							.setScope('Animal');
+						tmpQuery.addSort({Column:'Cost',Direction:'Descending'});
+						tmpQuery.parameters.legacyPagination = true;
+						tmpQuery.buildReadQuery();
+						Expect(tmpQuery.query.body)
+							.to.equal('SELECT [Animal].* FROM [Animal] ORDER BY [Cost] DESC;');
 					}
 				);
 				test