@proteinjs/db-ui 1.8.5 → 1.9.1

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.9.1](https://github.com/proteinjs/db/compare/@proteinjs/db-ui@1.9.0...@proteinjs/db-ui@1.9.1) (2026-08-14)
+
+**Note:** Version bump only for package @proteinjs/db-ui
+
+
+
+
+
+# [1.9.0](https://github.com/proteinjs/db/compare/@proteinjs/db-ui@1.8.5...@proteinjs/db-ui@1.9.0) (2026-08-14)
+
+
+### Features
+
+* cursor-window paging owner; RecordIterator migrated off offset paging ([453c4a2](https://github.com/proteinjs/db/commit/453c4a2a5f87bd7b58b0042185100bcf9ae0e183))
+
+
+
+
+
 ## [1.8.5](https://github.com/proteinjs/db/compare/@proteinjs/db-ui@1.8.4...@proteinjs/db-ui@1.8.5) (2026-08-14)
 
 

package/dist/generated/index.js

@@ -28,7 +28,7 @@ require("react");
 require("string");
 require("uuid");
 /** Generate Source Graph */
-var sourceGraph = "{\"options\":{\"directed\":true,\"multigraph\":false,\"compound\":false},\"nodes\":[{\"v\":\"@proteinjs/db-ui/QueryCursorLoader\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"QueryCursorLoader\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/table/QueryCursorLoader.ts\",\"qualifiedName\":\"@proteinjs/db-ui/QueryCursorLoader\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"reactQueryKeys\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"ReactQueryKeys\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/ReactQueryKeys\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"},{\"name\":\"sort\",\"type\":{\"packageName\":\"\",\"name\":\"SortCriteria<T>[]\",\"filePath\":null,\"qualifiedName\":\"/SortCriteria<T>[]\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"table\",\"type\":{\"packageName\":\"\",\"name\":\"Table<T>\",\"filePath\":null,\"qualifiedName\":\"/Table<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"createQuery\",\"type\":{\"packageName\":\"\",\"name\":\"() => QueryBuilder<T>\",\"filePath\":null,\"qualifiedName\":\"/() => QueryBuilder<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"queryOptions\",\"type\":{\"packageName\":\"\",\"name\":\"QueryOptions<T>\",\"filePath\":null,\"qualifiedName\":\"/QueryOptions<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"}],\"methods\":[{\"name\":\"loadWindow\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<CursorWindow<T>>\",\"filePath\":null,\"qualifiedName\":\"/Promise<CursorWindow<T>>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"cursor\",\"type\":{\"packageName\":\"\",\"name\":\"CursorValue | null\",\"filePath\":null,\"qualifiedName\":\"/CursorValue | null\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"windowSize\",\"type\":{\"packageName\":\"\",\"name\":\"number\",\"filePath\":null,\"qualifiedName\":\"/number\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"buildWindowQuery\",\"returnType\":{\"packageName\":\"\",\"name\":\"QueryBuilder<T>\",\"filePath\":null,\"qualifiedName\":\"/QueryBuilder<T>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\",\"parameters\":[{\"name\":\"cursor\",\"type\":{\"packageName\":\"\",\"name\":\"CursorValue | null\",\"filePath\":null,\"qualifiedName\":\"/CursorValue | null\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"windowSize\",\"type\":{\"packageName\":\"\",\"name\":\"number\",\"filePath\":null,\"qualifiedName\":\"/number\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"deriveNextCursor\",\"returnType\":{\"packageName\":\"\",\"name\":\"CursorValue | null\",\"filePath\":null,\"qualifiedName\":\"/CursorValue | null\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\",\"parameters\":[{\"name\":\"rows\",\"type\":{\"packageName\":\"\",\"name\":\"T[]\",\"filePath\":null,\"qualifiedName\":\"/T[]\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"windowSize\",\"type\":{\"packageName\":\"\",\"name\":\"number\",\"filePath\":null,\"qualifiedName\":\"/number\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[\"/T extends Record\"],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"CursorLoader\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/CursorLoader\",\"properties\":[],\"methods\":[],\"typeParameters\":[\"/T\"],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/ui/CursorLoader\"},{\"v\":\"@proteinjs/db-ui/QueryTableLoader\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"QueryTableLoader\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/table/QueryTableLoader.ts\",\"qualifiedName\":\"@proteinjs/db-ui/QueryTableLoader\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"rowCountQb\",\"type\":{\"packageName\":\"\",\"name\":\"QueryBuilder<T>\",\"filePath\":null,\"qualifiedName\":\"/QueryBuilder<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"paginationQb\",\"type\":{\"packageName\":\"\",\"name\":\"QueryBuilder<T>\",\"filePath\":null,\"qualifiedName\":\"/QueryBuilder<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"reactQueryKeys\",\"type\":{\"packageName\":\"\",\"name\":\"TableLoader<T>['reactQueryKeys']\",\"filePath\":null,\"qualifiedName\":\"/TableLoader<T>['reactQueryKeys']\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"},{\"name\":\"table\",\"type\":{\"packageName\":\"\",\"name\":\"Table<T>\",\"filePath\":null,\"qualifiedName\":\"/Table<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"query\",\"type\":{\"packageName\":\"\",\"name\":\"Query<T>\",\"filePath\":null,\"qualifiedName\":\"/Query<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"sort\",\"type\":{\"packageName\":\"\",\"name\":\"SortCriteria<T>[]\",\"filePath\":null,\"qualifiedName\":\"/SortCriteria<T>[]\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"queryOptions\",\"type\":{\"packageName\":\"\",\"name\":\"QueryOptions<T>\",\"filePath\":null,\"qualifiedName\":\"/QueryOptions<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"}],\"methods\":[{\"name\":\"load\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<RowWindow<T>>\",\"filePath\":null,\"qualifiedName\":\"/Promise<RowWindow<T>>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"startIndex\",\"type\":{\"packageName\":\"\",\"name\":\"number\",\"filePath\":null,\"qualifiedName\":\"/number\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"endIndex\",\"type\":{\"packageName\":\"\",\"name\":\"number\",\"filePath\":null,\"qualifiedName\":\"/number\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"skipRowCount\",\"type\":{\"packageName\":\"\",\"name\":\"boolean\",\"filePath\":null,\"qualifiedName\":\"/boolean\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[\"/T extends Record\"],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"TableLoader\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/TableLoader\",\"properties\":[],\"methods\":[],\"typeParameters\":[\"/T\"],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/ui/TableLoader\"},{\"v\":\"@proteinjs/db-ui/RecordFormCustomization\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"RecordFormCustomization\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/form/RecordFormCustomization.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/RecordFormCustomization\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"table\",\"type\":{\"packageName\":\"\",\"name\":\"Table<any>\",\"filePath\":null,\"qualifiedName\":\"/Table<any>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"}],\"methods\":[{\"name\":\"getFormButtons\",\"returnType\":{\"packageName\":\"\",\"name\":\"FormButtons<any>\",\"filePath\":null,\"qualifiedName\":\"/FormButtons<any>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"record\",\"type\":{\"packageName\":\"\",\"name\":\"any\",\"filePath\":null,\"qualifiedName\":\"/any\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"defaultFormButtons\",\"type\":{\"packageName\":\"\",\"name\":\"FormButtons<any>\",\"filePath\":null,\"qualifiedName\":\"/FormButtons<any>\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"getFieldLayout\",\"returnType\":{\"packageName\":\"\",\"name\":\"string[] | string[][]\",\"filePath\":null,\"qualifiedName\":\"/string[] | string[][]\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"record\",\"type\":{\"packageName\":\"\",\"name\":\"any\",\"filePath\":null,\"qualifiedName\":\"/any\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"defaultFieldLayout\",\"type\":{\"packageName\":\"\",\"name\":\"string[] | string[][]\",\"filePath\":null,\"qualifiedName\":\"/string[] | string[][]\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/reflection\",\"name\":\"Loadable\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/reflection/Loadable\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/reflection/Loadable\"},{\"v\":\"@proteinjs/db-ui/hashGeneratorPage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"hashGeneratorPage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/HashGeneratorPage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/hashGeneratorPage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/ui/Page\"},{\"v\":\"@proteinjs/db-ui/recordFormPage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"recordFormPage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/RecordFormPage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/recordFormPage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/db-ui/recordTablePage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"recordTablePage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/RecordTablePage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/recordTablePage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/db-ui/tablesPage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"tablesPage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/TablesPage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/tablesPage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/db-ui/uuidGeneratorPage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"uuidGeneratorPage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/UuidGeneratorPage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/uuidGeneratorPage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/db-ui/SpecificTableProps\"},{\"v\":\"@proteinjs/db-ui/MigrationRecordFormCustomization\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"MigrationRecordFormCustomization\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/form/customizations/MigrationRecordFormCustomization.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/MigrationRecordFormCustomization\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"table\",\"type\":null,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"}],\"methods\":[{\"name\":\"getFormButtons\",\"returnType\":{\"packageName\":\"\",\"name\":\"FormButtons<any>\",\"filePath\":null,\"qualifiedName\":\"/FormButtons<any>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"migration\",\"type\":{\"packageName\":\"@proteinjs/db\",\"name\":\"Migration\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db/Migration\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"defaultFormButtons\",\"type\":{\"packageName\":\"\",\"name\":\"FormButtons<any>\",\"filePath\":null,\"qualifiedName\":\"/FormButtons<any>\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[],\"directParentInterfaces\":[],\"directParentClasses\":[{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"RecordFormCustomization\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-ui/RecordFormCustomization\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParentInterfaces\":[],\"directParentClasses\":[]}],\"sourceType\":2}}],\"edges\":[{\"v\":\"@proteinjs/db-ui/QueryCursorLoader\",\"w\":\"@proteinjs/ui/CursorLoader\",\"value\":\"implements interface\"},{\"v\":\"@proteinjs/db-ui/QueryTableLoader\",\"w\":\"@proteinjs/ui/TableLoader\",\"value\":\"implements interface\"},{\"v\":\"@proteinjs/db-ui/RecordFormCustomization\",\"w\":\"@proteinjs/reflection/Loadable\",\"value\":\"implements interface\"},{\"v\":\"@proteinjs/db-ui/hashGeneratorPage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/recordFormPage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/recordTablePage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/tablesPage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/uuidGeneratorPage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/MigrationRecordFormCustomization\",\"w\":\"@proteinjs/db-ui/RecordFormCustomization\",\"value\":\"extends class\"}]}";
+var sourceGraph = "{\"options\":{\"directed\":true,\"multigraph\":false,\"compound\":false},\"nodes\":[{\"v\":\"@proteinjs/db-ui/QueryCursorLoader\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"QueryCursorLoader\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/table/QueryCursorLoader.ts\",\"qualifiedName\":\"@proteinjs/db-ui/QueryCursorLoader\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"reactQueryKeys\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"ReactQueryKeys\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/ReactQueryKeys\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"},{\"name\":\"pager\",\"type\":{\"packageName\":\"\",\"name\":\"CursorWindowPager<T>\",\"filePath\":null,\"qualifiedName\":\"/CursorWindowPager<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"}],\"methods\":[{\"name\":\"loadWindow\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<CursorWindow<T>>\",\"filePath\":null,\"qualifiedName\":\"/Promise<CursorWindow<T>>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"cursor\",\"type\":{\"packageName\":\"\",\"name\":\"CursorValue | null\",\"filePath\":null,\"qualifiedName\":\"/CursorValue | null\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"windowSize\",\"type\":{\"packageName\":\"\",\"name\":\"number\",\"filePath\":null,\"qualifiedName\":\"/number\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[\"/T extends Record\"],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"CursorLoader\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/CursorLoader\",\"properties\":[],\"methods\":[],\"typeParameters\":[\"/T\"],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/ui/CursorLoader\"},{\"v\":\"@proteinjs/db-ui/QueryTableLoader\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"QueryTableLoader\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/table/QueryTableLoader.ts\",\"qualifiedName\":\"@proteinjs/db-ui/QueryTableLoader\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"rowCountQb\",\"type\":{\"packageName\":\"\",\"name\":\"QueryBuilder<T>\",\"filePath\":null,\"qualifiedName\":\"/QueryBuilder<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"paginationQb\",\"type\":{\"packageName\":\"\",\"name\":\"QueryBuilder<T>\",\"filePath\":null,\"qualifiedName\":\"/QueryBuilder<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"reactQueryKeys\",\"type\":{\"packageName\":\"\",\"name\":\"TableLoader<T>['reactQueryKeys']\",\"filePath\":null,\"qualifiedName\":\"/TableLoader<T>['reactQueryKeys']\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"},{\"name\":\"table\",\"type\":{\"packageName\":\"\",\"name\":\"Table<T>\",\"filePath\":null,\"qualifiedName\":\"/Table<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"query\",\"type\":{\"packageName\":\"\",\"name\":\"Query<T>\",\"filePath\":null,\"qualifiedName\":\"/Query<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"sort\",\"type\":{\"packageName\":\"\",\"name\":\"SortCriteria<T>[]\",\"filePath\":null,\"qualifiedName\":\"/SortCriteria<T>[]\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"queryOptions\",\"type\":{\"packageName\":\"\",\"name\":\"QueryOptions<T>\",\"filePath\":null,\"qualifiedName\":\"/QueryOptions<T>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"}],\"methods\":[{\"name\":\"load\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<RowWindow<T>>\",\"filePath\":null,\"qualifiedName\":\"/Promise<RowWindow<T>>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"startIndex\",\"type\":{\"packageName\":\"\",\"name\":\"number\",\"filePath\":null,\"qualifiedName\":\"/number\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"endIndex\",\"type\":{\"packageName\":\"\",\"name\":\"number\",\"filePath\":null,\"qualifiedName\":\"/number\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"skipRowCount\",\"type\":{\"packageName\":\"\",\"name\":\"boolean\",\"filePath\":null,\"qualifiedName\":\"/boolean\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[\"/T extends Record\"],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"TableLoader\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/TableLoader\",\"properties\":[],\"methods\":[],\"typeParameters\":[\"/T\"],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/ui/TableLoader\"},{\"v\":\"@proteinjs/db-ui/RecordFormCustomization\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"RecordFormCustomization\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/form/RecordFormCustomization.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/RecordFormCustomization\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"table\",\"type\":{\"packageName\":\"\",\"name\":\"Table<any>\",\"filePath\":null,\"qualifiedName\":\"/Table<any>\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"}],\"methods\":[{\"name\":\"getFormButtons\",\"returnType\":{\"packageName\":\"\",\"name\":\"FormButtons<any>\",\"filePath\":null,\"qualifiedName\":\"/FormButtons<any>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"record\",\"type\":{\"packageName\":\"\",\"name\":\"any\",\"filePath\":null,\"qualifiedName\":\"/any\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"defaultFormButtons\",\"type\":{\"packageName\":\"\",\"name\":\"FormButtons<any>\",\"filePath\":null,\"qualifiedName\":\"/FormButtons<any>\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"getFieldLayout\",\"returnType\":{\"packageName\":\"\",\"name\":\"string[] | string[][]\",\"filePath\":null,\"qualifiedName\":\"/string[] | string[][]\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"record\",\"type\":{\"packageName\":\"\",\"name\":\"any\",\"filePath\":null,\"qualifiedName\":\"/any\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"defaultFieldLayout\",\"type\":{\"packageName\":\"\",\"name\":\"string[] | string[][]\",\"filePath\":null,\"qualifiedName\":\"/string[] | string[][]\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/reflection\",\"name\":\"Loadable\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/reflection/Loadable\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/reflection/Loadable\"},{\"v\":\"@proteinjs/db-ui/hashGeneratorPage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"hashGeneratorPage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/HashGeneratorPage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/hashGeneratorPage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/ui/Page\"},{\"v\":\"@proteinjs/db-ui/recordFormPage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"recordFormPage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/RecordFormPage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/recordFormPage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/db-ui/recordTablePage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"recordTablePage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/RecordTablePage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/recordTablePage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/db-ui/tablesPage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"tablesPage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/TablesPage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/tablesPage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/db-ui/uuidGeneratorPage\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"uuidGeneratorPage\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/pages/UuidGeneratorPage.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/uuidGeneratorPage\",\"type\":{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/ui\",\"name\":\"Page\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/ui/Page\",\"typeParameters\":[],\"directParents\":null}]},\"isExported\":true,\"isConst\":true,\"sourceType\":0}},{\"v\":\"@proteinjs/db-ui/SpecificTableProps\"},{\"v\":\"@proteinjs/db-ui/MigrationRecordFormCustomization\",\"value\":{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"MigrationRecordFormCustomization\",\"filePath\":\"/home/runner/work/db/db/packages/ui/src/form/customizations/MigrationRecordFormCustomization.tsx\",\"qualifiedName\":\"@proteinjs/db-ui/MigrationRecordFormCustomization\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"table\",\"type\":null,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"}],\"methods\":[{\"name\":\"getFormButtons\",\"returnType\":{\"packageName\":\"\",\"name\":\"FormButtons<any>\",\"filePath\":null,\"qualifiedName\":\"/FormButtons<any>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"migration\",\"type\":{\"packageName\":\"@proteinjs/db\",\"name\":\"Migration\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db/Migration\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"defaultFormButtons\",\"type\":{\"packageName\":\"\",\"name\":\"FormButtons<any>\",\"filePath\":null,\"qualifiedName\":\"/FormButtons<any>\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[],\"directParentInterfaces\":[],\"directParentClasses\":[{\"packageName\":\"@proteinjs/db-ui\",\"name\":\"RecordFormCustomization\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-ui/RecordFormCustomization\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParentInterfaces\":[],\"directParentClasses\":[]}],\"sourceType\":2}}],\"edges\":[{\"v\":\"@proteinjs/db-ui/QueryCursorLoader\",\"w\":\"@proteinjs/ui/CursorLoader\",\"value\":\"implements interface\"},{\"v\":\"@proteinjs/db-ui/QueryTableLoader\",\"w\":\"@proteinjs/ui/TableLoader\",\"value\":\"implements interface\"},{\"v\":\"@proteinjs/db-ui/RecordFormCustomization\",\"w\":\"@proteinjs/reflection/Loadable\",\"value\":\"implements interface\"},{\"v\":\"@proteinjs/db-ui/hashGeneratorPage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/recordFormPage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/recordTablePage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/tablesPage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/uuidGeneratorPage\",\"w\":\"@proteinjs/ui/Page\",\"value\":\"has type\"},{\"v\":\"@proteinjs/db-ui/MigrationRecordFormCustomization\",\"w\":\"@proteinjs/db-ui/RecordFormCustomization\",\"value\":\"extends class\"}]}";
 /** Generate Source Links */
 var QueryCursorLoader_1 = require("../src/table/QueryCursorLoader");
 var QueryTableLoader_1 = require("../src/table/QueryTableLoader");

package/dist/generated/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,0BAAwB;AACxB,2BAAyB;AACzB,+BAA6B;AAC7B,yBAAuB;AACvB,yBAAuB;AACvB,iCAA+B;AAC/B,yBAAuB;AACvB,2BAAyB;AACzB,kBAAgB;AAChB,iBAAe;AACf,kBAAgB;AAChB,gBAAc;AAGd,4BAA4B;AAE5B,IAAM,WAAW,GAAG,+zfAA+zf,CAAC;AAGp1f,4BAA4B;AAE5B,oEAAmE;AACnE,kEAAiE;AACjE,+EAA8E;AAC9E,oEAAmE;AACnE,8DAA6D;AAC7D,gEAA+D;AAC/D,sDAAqD;AACrD,oEAAmE;AACnE,gHAA+G;AAE/G,IAAM,WAAW,GAAG;IACnB,oCAAoC,EAAE,qCAAiB;IACvD,mCAAmC,EAAE,mCAAgB;IACrD,0CAA0C,EAAE,iDAAuB;IACnE,oCAAoC,EAAE,qCAAiB;IACvD,iCAAiC,EAAE,+BAAc;IACjD,kCAAkC,EAAE,iCAAe;IACnD,6BAA6B,EAAE,uBAAU;IACzC,oCAAoC,EAAE,qCAAiB;IACvD,mDAAmD,EAAE,mEAAgC;CACrF,CAAC;AAGF,kCAAkC;AAElC,oDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,0BAAwB;AACxB,2BAAyB;AACzB,+BAA6B;AAC7B,yBAAuB;AACvB,yBAAuB;AACvB,iCAA+B;AAC/B,yBAAuB;AACvB,2BAAyB;AACzB,kBAAgB;AAChB,iBAAe;AACf,kBAAgB;AAChB,gBAAc;AAGd,4BAA4B;AAE5B,IAAM,WAAW,GAAG,wrbAAwrb,CAAC;AAG7sb,4BAA4B;AAE5B,oEAAmE;AACnE,kEAAiE;AACjE,+EAA8E;AAC9E,oEAAmE;AACnE,8DAA6D;AAC7D,gEAA+D;AAC/D,sDAAqD;AACrD,oEAAmE;AACnE,gHAA+G;AAE/G,IAAM,WAAW,GAAG;IACnB,oCAAoC,EAAE,qCAAiB;IACvD,mCAAmC,EAAE,mCAAgB;IACrD,0CAA0C,EAAE,iDAAuB;IACnE,oCAAoC,EAAE,qCAAiB;IACvD,iCAAiC,EAAE,+BAAc;IACjD,kCAAkC,EAAE,iCAAe;IACnD,6BAA6B,EAAE,uBAAU;IACzC,oCAAoC,EAAE,qCAAiB;IACvD,mDAAmD,EAAE,mEAAgC;CACrF,CAAC;AAGF,kCAAkC;AAElC,oDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,2CAAyB"}

package/dist/src/table/QueryCursorLoader.d.ts

@@ -1,33 +1,29 @@
 import { QueryBuilder, QueryOptions, Record, SortCriteria, Table } from '@proteinjs/db';
 import { CursorLoader, CursorValue, CursorWindow, ReactQueryKeys } from '@proteinjs/ui';
 /**
- * `CursorLoader` over the same QueryBuilder machinery as `QueryTableLoader`: each window
- * applies `cursorField < cursor` (`>` for an ascending sort) plus `paginate(0, windowSize)`
- * on a fresh build of the base query, so rows created or removed while paging can never
- * shift the window frame. The cursor field and direction derive from the PRIMARY sort
- * criterion.
+ * `CursorLoader` over the db-owned cursor-window machinery (`CursorWindowPager`): each window
+ * carries a lexicographic continuation past the anchor row — the primary sort axes plus a
+ * unique `id` tiebreak — and `paginate(0, windowSize)` on a fresh build of the base query, so
+ * rows created or removed while paging can never shift the window frame, and ties on the sort
+ * axis can never skip or duplicate boundary rows. Cursors are the pager's anchors encoded as
+ * strings (house `Serializer`, so dates/moments survive react-query page params).
  *
  * `dataKey` is the table name — table-level invalidation (`useTableMutation`) reaches every
  * cursor query over it; `dataQueryKey` is the serialized query + sort.
  */
 export declare class QueryCursorLoader<T extends Record> implements CursorLoader<T> {
-    private table;
-    private createQuery;
-    private queryOptions?;
     reactQueryKeys: ReactQueryKeys;
-    private sort;
+    private pager;
     /**
      * @param table the table to load windows from
      * @param createQuery factory producing a FRESH conditions-only QueryBuilder per call —
-     *   builders are mutable, so every window builds its own to hang the cursor condition,
+     *   builders are mutable, so every window builds its own to hang the cursor conditions,
      *   sort, and pagination on
      * @param sort the sort criteria to apply to every window; the primary criterion is the
-     *   cursor axis
+     *   cursor axis (the pager appends the `id` tiebreak)
      * @param queryOptions query options passed through to every window query
      */
-    constructor(table: Table<T>, createQuery: () => QueryBuilder<T>, sort?: SortCriteria<T>[], queryOptions?: QueryOptions<T> | undefined);
+    constructor(table: Table<T>, createQuery: () => QueryBuilder<T>, sort?: SortCriteria<T>[], queryOptions?: QueryOptions<T>);
     loadWindow(cursor: CursorValue | null, windowSize: number): Promise<CursorWindow<T>>;
-    private buildWindowQuery;
-    private deriveNextCursor;
 }
 //# sourceMappingURL=QueryCursorLoader.d.ts.map

package/dist/src/table/QueryCursorLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryCursorLoader.d.ts","sourceRoot":"","sources":["../../../src/table/QueryCursorLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAS,MAAM,eAAe,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAExF;;;;;;;;;GASG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAcvE,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,WAAW;IAEnB,OAAO,CAAC,YAAY,CAAC;IAhBvB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAoB;IAEhC;;;;;;;;OAQG;gBAEO,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,WAAW,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,EAC1C,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAChB,YAAY,CAAC,6BAAiB;IASlC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAM1F,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,gBAAgB;CAWzB"}
+{"version":3,"file":"QueryCursorLoader.d.ts","sourceRoot":"","sources":["../../../src/table/QueryCursorLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3G,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAExF;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IACzE,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAuB;IAEpC;;;;;;;;OAQG;gBAED,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,WAAW,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,EAClC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EACxB,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAU1B,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAQ3F"}

package/dist/src/table/QueryCursorLoader.js

@@ -39,11 +39,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.QueryCursorLoader = void 0;
 var db_1 = require("@proteinjs/db");
 /**
- * `CursorLoader` over the same QueryBuilder machinery as `QueryTableLoader`: each window
- * applies `cursorField < cursor` (`>` for an ascending sort) plus `paginate(0, windowSize)`
- * on a fresh build of the base query, so rows created or removed while paging can never
- * shift the window frame. The cursor field and direction derive from the PRIMARY sort
- * criterion.
+ * `CursorLoader` over the db-owned cursor-window machinery (`CursorWindowPager`): each window
+ * carries a lexicographic continuation past the anchor row — the primary sort axes plus a
+ * unique `id` tiebreak — and `paginate(0, windowSize)` on a fresh build of the base query, so
+ * rows created or removed while paging can never shift the window frame, and ties on the sort
+ * axis can never skip or duplicate boundary rows. Cursors are the pager's anchors encoded as
+ * strings (house `Serializer`, so dates/moments survive react-query page params).
  *
  * `dataKey` is the table name — table-level invalidation (`useTableMutation`) reaches every
  * cursor query over it; `dataQueryKey` is the serialized query + sort.
@@ -52,60 +53,38 @@ var QueryCursorLoader = /** @class */ (function () {
     /**
      * @param table the table to load windows from
      * @param createQuery factory producing a FRESH conditions-only QueryBuilder per call —
-     *   builders are mutable, so every window builds its own to hang the cursor condition,
+     *   builders are mutable, so every window builds its own to hang the cursor conditions,
      *   sort, and pagination on
      * @param sort the sort criteria to apply to every window; the primary criterion is the
-     *   cursor axis
+     *   cursor axis (the pager appends the `id` tiebreak)
      * @param queryOptions query options passed through to every window query
      */
     function QueryCursorLoader(table, createQuery, sort, queryOptions) {
-        this.table = table;
-        this.createQuery = createQuery;
-        this.queryOptions = queryOptions;
-        this.sort = sort ? sort : [{ field: 'created', desc: true }];
+        var effectiveSort = sort ? sort : [{ field: 'created', desc: true }];
+        this.pager = new db_1.CursorWindowPager(table, createQuery, effectiveSort, { queryOptions: queryOptions });
         this.reactQueryKeys = {
-            dataKey: this.table.name,
-            dataQueryKey: JSON.stringify({ query: this.createQuery(), sort: this.sort }),
+            dataKey: table.name,
+            dataQueryKey: JSON.stringify({ query: createQuery(), sort: effectiveSort }),
         };
     }
     QueryCursorLoader.prototype.loadWindow = function (cursor, windowSize) {
         return __awaiter(this, void 0, void 0, function () {
-            var qb, rows;
+            var anchor, window;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        qb = this.buildWindowQuery(cursor, windowSize);
-                        return [4 /*yield*/, (0, db_1.getDb)().query(this.table, qb, this.queryOptions)];
+                        anchor = cursor === null ? null : db_1.CursorWindowPager.decodeAnchor(cursor);
+                        return [4 /*yield*/, this.pager.loadWindow(anchor, windowSize)];
                     case 1:
-                        rows = _a.sent();
-                        return [2 /*return*/, { rows: rows, nextCursor: this.deriveNextCursor(rows, windowSize) }];
+                        window = _a.sent();
+                        return [2 /*return*/, {
+                                rows: window.rows,
+                                nextCursor: window.nextAnchor ? db_1.CursorWindowPager.encodeAnchor(window.nextAnchor) : null,
+                            }];
                 }
             });
         });
     };
-    QueryCursorLoader.prototype.buildWindowQuery = function (cursor, windowSize) {
-        var qb = this.createQuery();
-        var primarySort = this.sort[0];
-        if (cursor !== null) {
-            qb.condition({
-                field: primarySort.field,
-                operator: primarySort.desc ? '<' : '>',
-                value: cursor,
-            });
-        }
-        return qb.sort(this.sort).paginate({ start: 0, end: windowSize });
-    };
-    QueryCursorLoader.prototype.deriveNextCursor = function (rows, windowSize) {
-        // A short window means the data set is exhausted; a full one implies more may exist —
-        // the next (short or empty) window settles it.
-        if (rows.length < windowSize) {
-            return null;
-        }
-        // NULL cursor-field rows collect at the tail under the sort, and a null tail can't
-        // anchor a cursor: the data set's dated rows are exhausted, so paging stops here.
-        var tail = rows[rows.length - 1][this.sort[0].field];
-        return tail == null ? null : tail;
-    };
     return QueryCursorLoader;
 }());
 exports.QueryCursorLoader = QueryCursorLoader;

package/dist/src/table/QueryCursorLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueryCursorLoader.js","sourceRoot":"","sources":["../../../src/table/QueryCursorLoader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oCAA+F;AAG/F;;;;;;;;;GASG;AACH;IAIE;;;;;;;;OAQG;IACH,2BACU,KAAe,EACf,WAAkC,EAC1C,IAAwB,EAChB,YAA8B;QAH9B,UAAK,GAAL,KAAK,CAAU;QACf,gBAAW,GAAX,WAAW,CAAuB;QAElC,iBAAY,GAAZ,YAAY,CAAkB;QAEtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAoB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,cAAc,GAAG;YACpB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACxB,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC;IAEK,sCAAU,GAAhB,UAAiB,MAA0B,EAAE,UAAkB;;;;;;wBACvD,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;wBACxC,qBAAM,IAAA,UAAK,GAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,EAAA;;wBAA7D,IAAI,GAAG,SAAsD;wBACnE,sBAAO,EAAE,IAAI,MAAA,EAAE,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAC;;;;KACtE;IAEO,4CAAgB,GAAxB,UAAyB,MAA0B,EAAE,UAAkB;QACrE,IAAM,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,IAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,IAAI,EAAE;YACnB,EAAE,CAAC,SAAS,CAAC;gBACX,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;gBACtC,KAAK,EAAE,MAAoB;aAC5B,CAAC,CAAC;SACJ;QACD,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC;IAEO,4CAAgB,GAAxB,UAAyB,IAAS,EAAE,UAAkB;QACpD,sFAAsF;QACtF,+CAA+C;QAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE;YAC5B,OAAO,IAAI,CAAC;SACb;QACD,mFAAmF;QACnF,kFAAkF;QAClF,IAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACvD,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAA+B,CAAC;IAChE,CAAC;IACH,wBAAC;AAAD,CAAC,AAxDD,IAwDC;AAxDY,8CAAiB"}
+{"version":3,"file":"QueryCursorLoader.js","sourceRoot":"","sources":["../../../src/table/QueryCursorLoader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oCAA2G;AAG3G;;;;;;;;;;GAUG;AACH;IAIE;;;;;;;;OAQG;IACH,2BACE,KAAe,EACf,WAAkC,EAClC,IAAwB,EACxB,YAA8B;QAE9B,IAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAoB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,KAAK,GAAG,IAAI,sBAAiB,CAAI,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,YAAY,cAAA,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,cAAc,GAAG;YACpB,OAAO,EAAE,KAAK,CAAC,IAAI;YACnB,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC;IAEK,sCAAU,GAAhB,UAAiB,MAA0B,EAAE,UAAkB;;;;;;wBACvD,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAiB,CAAC,YAAY,CAAC,MAAgB,CAAC,CAAC;wBAC1E,qBAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,EAAA;;wBAAxD,MAAM,GAAG,SAA+C;wBAC9D,sBAAO;gCACL,IAAI,EAAE,MAAM,CAAC,IAAI;gCACjB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;6BACzF,EAAC;;;;KACH;IACH,wBAAC;AAAD,CAAC,AAnCD,IAmCC;AAnCY,8CAAiB"}

package/dist/test/QueryCursorLoader.test.d.ts

@@ -1,2 +1,2 @@
-export {};
+import '../generated/index';
 //# sourceMappingURL=QueryCursorLoader.test.d.ts.map

package/dist/test/QueryCursorLoader.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryCursorLoader.test.d.ts","sourceRoot":"","sources":["../../test/QueryCursorLoader.test.ts"],"names":[],"mappings":""}
+{"version":3,"file":"QueryCursorLoader.test.d.ts","sourceRoot":"","sources":["../../test/QueryCursorLoader.test.ts"],"names":[],"mappings":"AAcA,OAAO,oBAAoB,CAAC"}

package/dist/test/QueryCursorLoader.test.js

@@ -1,15 +1,4 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -51,30 +40,39 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
- * QueryCursorLoader (src/table/QueryCursorLoader.ts) at the pure level: react-query key
- * derivation, cursor threading into the window query, and next-cursor derivation — including
- * the null-tail exhaustion rule (NULL cursor-field rows collect at the tail under the sort;
- * a null tail can't anchor a cursor, so paging stops). Window queries are inspected through
- * the QueryBuilder graph; loadWindow's db round-trip is exercised with a stubbed getDb.
+ * QueryCursorLoader (src/table/QueryCursorLoader.ts) as the thin `CursorLoader` adapter over
+ * the db-owned `CursorWindowPager`: react-query key derivation, string-cursor encode/decode
+ * threading into the pager's lexicographic window queries (primary axis + `id` tiebreak), and
+ * exhaustion (short window, and the null-tail rule: NULL sort-value rows collect at the tail
+ * under the sort; a null can't anchor a continuation, so paging stops). The db round trip is
+ * injected through the pager's `options.db` seam via the house internals-cast pattern — no
+ * module mocking.
  */
 var moment_1 = __importDefault(require("moment"));
-var stagedRows = { rows: [] };
-var queries = [];
+var db_1 = require("@proteinjs/db");
+var QueryCursorLoader_1 = require("../src/table/QueryCursorLoader");
+// Load the reflection source graph so the house Serializer's custom serializers (moments)
+// are registered — cursor encode/decode fidelity rides them.
+require("../generated/index");
+var table = { name: 'test_content' };
+var sort = [{ field: 'lastActivityAt', desc: true }];
+var createQuery = function () { return new db_1.QueryBuilder(table.name); };
+var staged = { rows: [] };
+var executed = [];
 var stubDb = {
     query: function (_table, qb) { return __awaiter(void 0, void 0, void 0, function () {
         return __generator(this, function (_a) {
-            queries.push(qb);
-            return [2 /*return*/, stagedRows.rows];
+            executed.push(qb);
+            return [2 /*return*/, staged.rows];
         });
     }); },
 };
-jest.mock('@proteinjs/db', function () { return (__assign(__assign({}, jest.requireActual('@proteinjs/db')), { getDb: function () { return stubDb; } })); });
-var db_1 = require("@proteinjs/db");
-var QueryCursorLoader_1 = require("../src/table/QueryCursorLoader");
-var table = { name: 'test_content' };
-var sort = [{ field: 'lastActivityAt', desc: true }];
-var createQuery = function () { return new db_1.QueryBuilder(table.name); };
-var internals = function (loader) { return loader; };
+var loaderWithStubDb = function (sortCriteria, query) {
+    if (query === void 0) { query = createQuery; }
+    var loader = new QueryCursorLoader_1.QueryCursorLoader(table, query, sortCriteria);
+    loader.pager.options = { db: stubDb };
+    return loader;
+};
 var graphNodes = function (qb) { return qb.graph.nodes().map(function (id) { return qb.graph.node(id); }); };
 var conditionNodes = function (qb) { return graphNodes(qb).filter(function (node) { return (node === null || node === void 0 ? void 0 : node.type) === 'CONDITION'; }); };
 var paginationNode = function (qb) { return graphNodes(qb).find(function (node) { return (node === null || node === void 0 ? void 0 : node.type) === 'PAGINATION'; }); };
@@ -83,11 +81,11 @@ var dated = function (id, at) { return ({
     id: id,
     created: (0, moment_1.default)(),
     updated: (0, moment_1.default)(),
-    lastActivityAt: at ? (0, moment_1.default)(at) : undefined,
+    lastActivityAt: at ? (0, moment_1.default)(at) : null,
 }); };
 beforeEach(function () {
-    stagedRows.rows = [];
-    queries.length = 0;
+    staged.rows = [];
+    executed.length = 0;
 });
 describe('reactQueryKeys', function () {
     it('names the data set after the table and the query after its serialized query + sort', function () {
@@ -103,90 +101,119 @@ describe('reactQueryKeys', function () {
         expect(resorted.reactQueryKeys.dataQueryKey).not.toBe(loader.reactQueryKeys.dataQueryKey);
     });
 });
-describe('buildWindowQuery — cursor threading', function () {
-    it('the first window carries no cursor condition, only the sort and the window pagination', function () {
-        var loader = new QueryCursorLoader_1.QueryCursorLoader(table, createQuery, sort);
-        var qb = internals(loader).buildWindowQuery(null, 30);
-        expect(conditionNodes(qb)).toHaveLength(0);
-        expect(paginationNode(qb)).toMatchObject({ start: 0, end: 30 });
-        expect(sortNodes(qb)).toHaveLength(1);
-        expect(sortNodes(qb)[0].criteria).toMatchObject({ field: 'lastActivityAt', desc: true });
-    });
-    it('a cursor becomes `field < cursor` on the primary sort field for a descending sort', function () {
-        var loader = new QueryCursorLoader_1.QueryCursorLoader(table, createQuery, sort);
-        var cursor = (0, moment_1.default)('2026-08-10T12:00:00.000Z');
-        var qb = internals(loader).buildWindowQuery(cursor, 30);
-        var conditions = conditionNodes(qb);
-        expect(conditions).toHaveLength(1);
-        expect(conditions[0]).toMatchObject({ field: 'lastActivityAt', operator: '<' });
-        expect(conditions[0].value).toBe(cursor);
-        expect(paginationNode(qb)).toMatchObject({ start: 0, end: 30 });
-    });
-    it('an ascending primary sort flips the cursor operator to `>`', function () {
-        var loader = new QueryCursorLoader_1.QueryCursorLoader(table, createQuery, [{ field: 'lastActivityAt', desc: false }]);
-        var qb = internals(loader).buildWindowQuery(5, 10);
-        expect(conditionNodes(qb)[0]).toMatchObject({ field: 'lastActivityAt', operator: '>', value: 5 });
-    });
-    it('every window builds on a FRESH query — cursor conditions never accumulate across windows', function () {
-        var loader = new QueryCursorLoader_1.QueryCursorLoader(table, createQuery, sort);
-        internals(loader).buildWindowQuery((0, moment_1.default)('2026-08-10T12:00:00.000Z'), 30);
-        var second = internals(loader).buildWindowQuery((0, moment_1.default)('2026-08-01T12:00:00.000Z'), 30);
-        expect(conditionNodes(second)).toHaveLength(1);
-    });
-});
-describe('deriveNextCursor — exhaustion', function () {
-    var loader = new QueryCursorLoader_1.QueryCursorLoader(table, createQuery, sort);
-    it('a short window is exhausted', function () {
-        expect(internals(loader).deriveNextCursor([dated('a', '2026-08-10T12:00:00.000Z')], 3)).toBeNull();
-        expect(internals(loader).deriveNextCursor([], 3)).toBeNull();
-    });
-    it('a full window anchors the next cursor at its tail', function () {
-        var rows = [
-            dated('a', '2026-08-10T12:00:00.000Z'),
-            dated('b', '2026-08-09T12:00:00.000Z'),
-            dated('c', '2026-08-08T12:00:00.000Z'),
-        ];
-        var next = internals(loader).deriveNextCursor(rows, 3);
-        expect(next).toBe(rows[2].lastActivityAt);
-    });
-    it('a full window with a NULL cursor-field tail is exhausted (null rows collect at the tail; no anchor)', function () {
-        var rows = [dated('a', '2026-08-10T12:00:00.000Z'), dated('b', '2026-08-09T12:00:00.000Z'), dated('c', null)];
-        expect(internals(loader).deriveNextCursor(rows, 3)).toBeNull();
-    });
-});
-describe('loadWindow', function () {
-    it('returns the queried rows with the derived next cursor', function () { return __awaiter(void 0, void 0, void 0, function () {
-        var loader, rows, window;
+describe('loadWindow — cursor threading', function () {
+    it('the first window carries no cursor conditions — the sort (with id tiebreak) and the window pagination', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var loader, qb;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    loader = new QueryCursorLoader_1.QueryCursorLoader(table, createQuery, sort);
+                    loader = loaderWithStubDb(sort);
+                    staged.rows = [];
+                    return [4 /*yield*/, loader.loadWindow(null, 30)];
+                case 1:
+                    _a.sent();
+                    expect(executed).toHaveLength(1);
+                    qb = executed[0];
+                    expect(conditionNodes(qb)).toHaveLength(0);
+                    expect(paginationNode(qb)).toMatchObject({ start: 0, end: 30 });
+                    expect(sortNodes(qb).map(function (node) { return node.criteria; })).toEqual([
+                        { field: 'lastActivityAt', desc: true },
+                        { field: 'id', desc: false },
+                    ]);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('a full window returns a string cursor; feeding it back threads the lexicographic continuation', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var loader, rows, first, qb, conditions, past;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    loader = loaderWithStubDb(sort);
                     rows = [
                         dated('a', '2026-08-10T12:00:00.000Z'),
                         dated('b', '2026-08-09T12:00:00.000Z'),
                         dated('c', '2026-08-08T12:00:00.000Z'),
                     ];
-                    stagedRows.rows = rows;
+                    staged.rows = rows;
+                    return [4 /*yield*/, loader.loadWindow(null, 3)];
+                case 1:
+                    first = _a.sent();
+                    expect(first.rows).toBe(rows);
+                    expect(typeof first.nextCursor).toBe('string');
+                    staged.rows = [];
+                    return [4 /*yield*/, loader.loadWindow(first.nextCursor, 3)];
+                case 2:
+                    _a.sent();
+                    qb = executed[1];
+                    conditions = conditionNodes(qb);
+                    expect(conditions).toHaveLength(3);
+                    past = conditions.find(function (node) { return node.operator === '<'; });
+                    expect(past).toMatchObject({ field: 'lastActivityAt' });
+                    expect(moment_1.default.isMoment(past.value)).toBe(true);
+                    expect(past.value.toISOString()).toBe(rows[2].lastActivityAt.toISOString());
+                    expect(conditions.find(function (node) { return node.operator === '='; })).toMatchObject({ field: 'lastActivityAt' });
+                    expect(conditions.find(function (node) { return node.operator === '>'; })).toMatchObject({ field: 'id', value: 'c' });
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('every window builds on a FRESH query — cursor conditions never accumulate across windows', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var loader, first, second;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    loader = loaderWithStubDb(sort);
+                    staged.rows = [
+                        dated('a', '2026-08-10T12:00:00.000Z'),
+                        dated('b', '2026-08-09T12:00:00.000Z'),
+                        dated('c', '2026-08-08T12:00:00.000Z'),
+                    ];
+                    return [4 /*yield*/, loader.loadWindow(null, 3)];
+                case 1:
+                    first = _a.sent();
+                    staged.rows = [
+                        dated('d', '2026-08-07T12:00:00.000Z'),
+                        dated('e', '2026-08-06T12:00:00.000Z'),
+                        dated('f', '2026-08-05T12:00:00.000Z'),
+                    ];
+                    return [4 /*yield*/, loader.loadWindow(first.nextCursor, 3)];
+                case 2:
+                    second = _a.sent();
+                    staged.rows = [];
+                    return [4 /*yield*/, loader.loadWindow(second.nextCursor, 3)];
+                case 3:
+                    _a.sent();
+                    expect(conditionNodes(executed[2])).toHaveLength(3);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+describe('loadWindow — exhaustion', function () {
+    it('a short window is exhausted (null cursor)', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var loader, window;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    loader = loaderWithStubDb(sort);
+                    staged.rows = [dated('a', '2026-08-10T12:00:00.000Z')];
                     return [4 /*yield*/, loader.loadWindow(null, 3)];
                 case 1:
                     window = _a.sent();
-                    expect(window.rows).toBe(rows);
-                    expect(window.nextCursor).toBe(rows[2].lastActivityAt);
-                    // The executed query is the built window query: pagination sized to the window.
-                    expect(queries).toHaveLength(1);
-                    expect(paginationNode(queries[0])).toMatchObject({ start: 0, end: 3 });
+                    expect(window.nextCursor).toBeNull();
                     return [2 /*return*/];
             }
         });
     }); });
-    it('returns an exhausted window (null cursor) when the query comes back short', function () { return __awaiter(void 0, void 0, void 0, function () {
+    it('a full window with a NULL sort-value tail is exhausted (null rows collect at the tail; no anchor)', function () { return __awaiter(void 0, void 0, void 0, function () {
         var loader, window;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    loader = new QueryCursorLoader_1.QueryCursorLoader(table, createQuery, sort);
-                    stagedRows.rows = [dated('a', '2026-08-10T12:00:00.000Z')];
-                    return [4 /*yield*/, loader.loadWindow((0, moment_1.default)('2026-08-11T12:00:00.000Z'), 3)];
+                    loader = loaderWithStubDb(sort);
+                    staged.rows = [dated('a', '2026-08-10T12:00:00.000Z'), dated('b', '2026-08-09T12:00:00.000Z'), dated('c', null)];
+                    return [4 /*yield*/, loader.loadWindow(null, 3)];
                 case 1:
                     window = _a.sent();
                     expect(window.nextCursor).toBeNull();

package/dist/test/QueryCursorLoader.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueryCursorLoader.test.js","sourceRoot":"","sources":["../../test/QueryCursorLoader.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"QueryCursorLoader.test.js","sourceRoot":"","sources":["../../test/QueryCursorLoader.test.ts"],"names":[],"mappings":"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"}

package/generated/index.ts

@@ -16,7 +16,7 @@ import 'uuid';
 /** Generate Source Graph */
 
 const sourceGraph =
-  '{"options":{"directed":true,"multigraph":false,"compound":false},"nodes":[{"v":"@proteinjs/db-ui/QueryCursorLoader","value":{"packageName":"@proteinjs/db-ui","name":"QueryCursorLoader","filePath":"/home/runner/work/db/db/packages/ui/src/table/QueryCursorLoader.ts","qualifiedName":"@proteinjs/db-ui/QueryCursorLoader","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"reactQueryKeys","type":{"packageName":"@proteinjs/ui","name":"ReactQueryKeys","filePath":null,"qualifiedName":"@proteinjs/ui/ReactQueryKeys","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"},{"name":"sort","type":{"packageName":"","name":"SortCriteria<T>[]","filePath":null,"qualifiedName":"/SortCriteria<T>[]","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"table","type":{"packageName":"","name":"Table<T>","filePath":null,"qualifiedName":"/Table<T>","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"createQuery","type":{"packageName":"","name":"() => QueryBuilder<T>","filePath":null,"qualifiedName":"/() => QueryBuilder<T>","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"queryOptions","type":{"packageName":"","name":"QueryOptions<T>","filePath":null,"qualifiedName":"/QueryOptions<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"}],"methods":[{"name":"loadWindow","returnType":{"packageName":"","name":"Promise<CursorWindow<T>>","filePath":null,"qualifiedName":"/Promise<CursorWindow<T>>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"cursor","type":{"packageName":"","name":"CursorValue | null","filePath":null,"qualifiedName":"/CursorValue | null","typeParameters":null,"directParents":null}},{"name":"windowSize","type":{"packageName":"","name":"number","filePath":null,"qualifiedName":"/number","typeParameters":null,"directParents":null}}]},{"name":"buildWindowQuery","returnType":{"packageName":"","name":"QueryBuilder<T>","filePath":null,"qualifiedName":"/QueryBuilder<T>","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private","parameters":[{"name":"cursor","type":{"packageName":"","name":"CursorValue | null","filePath":null,"qualifiedName":"/CursorValue | null","typeParameters":null,"directParents":null}},{"name":"windowSize","type":{"packageName":"","name":"number","filePath":null,"qualifiedName":"/number","typeParameters":null,"directParents":null}}]},{"name":"deriveNextCursor","returnType":{"packageName":"","name":"CursorValue | null","filePath":null,"qualifiedName":"/CursorValue | null","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private","parameters":[{"name":"rows","type":{"packageName":"","name":"T[]","filePath":null,"qualifiedName":"/T[]","typeParameters":null,"directParents":null}},{"name":"windowSize","type":{"packageName":"","name":"number","filePath":null,"qualifiedName":"/number","typeParameters":null,"directParents":null}}]}],"typeParameters":["/T extends Record"],"directParentInterfaces":[{"packageName":"@proteinjs/ui","name":"CursorLoader","filePath":null,"qualifiedName":"@proteinjs/ui/CursorLoader","properties":[],"methods":[],"typeParameters":["/T"],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/ui/CursorLoader"},{"v":"@proteinjs/db-ui/QueryTableLoader","value":{"packageName":"@proteinjs/db-ui","name":"QueryTableLoader","filePath":"/home/runner/work/db/db/packages/ui/src/table/QueryTableLoader.ts","qualifiedName":"@proteinjs/db-ui/QueryTableLoader","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"rowCountQb","type":{"packageName":"","name":"QueryBuilder<T>","filePath":null,"qualifiedName":"/QueryBuilder<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"paginationQb","type":{"packageName":"","name":"QueryBuilder<T>","filePath":null,"qualifiedName":"/QueryBuilder<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"reactQueryKeys","type":{"packageName":"","name":"TableLoader<T>[\'reactQueryKeys\']","filePath":null,"qualifiedName":"/TableLoader<T>[\'reactQueryKeys\']","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"},{"name":"table","type":{"packageName":"","name":"Table<T>","filePath":null,"qualifiedName":"/Table<T>","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"query","type":{"packageName":"","name":"Query<T>","filePath":null,"qualifiedName":"/Query<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"sort","type":{"packageName":"","name":"SortCriteria<T>[]","filePath":null,"qualifiedName":"/SortCriteria<T>[]","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"queryOptions","type":{"packageName":"","name":"QueryOptions<T>","filePath":null,"qualifiedName":"/QueryOptions<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"}],"methods":[{"name":"load","returnType":{"packageName":"","name":"Promise<RowWindow<T>>","filePath":null,"qualifiedName":"/Promise<RowWindow<T>>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"startIndex","type":{"packageName":"","name":"number","filePath":null,"qualifiedName":"/number","typeParameters":null,"directParents":null}},{"name":"endIndex","type":{"packageName":"","name":"number","filePath":null,"qualifiedName":"/number","typeParameters":null,"directParents":null}},{"name":"skipRowCount","type":{"packageName":"","name":"boolean","filePath":null,"qualifiedName":"/boolean","typeParameters":null,"directParents":null}}]}],"typeParameters":["/T extends Record"],"directParentInterfaces":[{"packageName":"@proteinjs/ui","name":"TableLoader","filePath":null,"qualifiedName":"@proteinjs/ui/TableLoader","properties":[],"methods":[],"typeParameters":["/T"],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/ui/TableLoader"},{"v":"@proteinjs/db-ui/RecordFormCustomization","value":{"packageName":"@proteinjs/db-ui","name":"RecordFormCustomization","filePath":"/home/runner/work/db/db/packages/ui/src/form/RecordFormCustomization.tsx","qualifiedName":"@proteinjs/db-ui/RecordFormCustomization","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"table","type":{"packageName":"","name":"Table<any>","filePath":null,"qualifiedName":"/Table<any>","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"}],"methods":[{"name":"getFormButtons","returnType":{"packageName":"","name":"FormButtons<any>","filePath":null,"qualifiedName":"/FormButtons<any>","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"record","type":{"packageName":"","name":"any","filePath":null,"qualifiedName":"/any","typeParameters":null,"directParents":null}},{"name":"defaultFormButtons","type":{"packageName":"","name":"FormButtons<any>","filePath":null,"qualifiedName":"/FormButtons<any>","typeParameters":null,"directParents":null}}]},{"name":"getFieldLayout","returnType":{"packageName":"","name":"string[] | string[][]","filePath":null,"qualifiedName":"/string[] | string[][]","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"record","type":{"packageName":"","name":"any","filePath":null,"qualifiedName":"/any","typeParameters":null,"directParents":null}},{"name":"defaultFieldLayout","type":{"packageName":"","name":"string[] | string[][]","filePath":null,"qualifiedName":"/string[] | string[][]","typeParameters":null,"directParents":null}}]}],"typeParameters":[],"directParentInterfaces":[{"packageName":"@proteinjs/reflection","name":"Loadable","filePath":null,"qualifiedName":"@proteinjs/reflection/Loadable","properties":[],"methods":[],"typeParameters":[],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/reflection/Loadable"},{"v":"@proteinjs/db-ui/hashGeneratorPage","value":{"packageName":"@proteinjs/db-ui","name":"hashGeneratorPage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/HashGeneratorPage.tsx","qualifiedName":"@proteinjs/db-ui/hashGeneratorPage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/ui/Page"},{"v":"@proteinjs/db-ui/recordFormPage","value":{"packageName":"@proteinjs/db-ui","name":"recordFormPage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/RecordFormPage.tsx","qualifiedName":"@proteinjs/db-ui/recordFormPage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/db-ui/recordTablePage","value":{"packageName":"@proteinjs/db-ui","name":"recordTablePage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/RecordTablePage.tsx","qualifiedName":"@proteinjs/db-ui/recordTablePage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/db-ui/tablesPage","value":{"packageName":"@proteinjs/db-ui","name":"tablesPage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/TablesPage.tsx","qualifiedName":"@proteinjs/db-ui/tablesPage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/db-ui/uuidGeneratorPage","value":{"packageName":"@proteinjs/db-ui","name":"uuidGeneratorPage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/UuidGeneratorPage.tsx","qualifiedName":"@proteinjs/db-ui/uuidGeneratorPage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/db-ui/SpecificTableProps"},{"v":"@proteinjs/db-ui/MigrationRecordFormCustomization","value":{"packageName":"@proteinjs/db-ui","name":"MigrationRecordFormCustomization","filePath":"/home/runner/work/db/db/packages/ui/src/form/customizations/MigrationRecordFormCustomization.tsx","qualifiedName":"@proteinjs/db-ui/MigrationRecordFormCustomization","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"table","type":null,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"}],"methods":[{"name":"getFormButtons","returnType":{"packageName":"","name":"FormButtons<any>","filePath":null,"qualifiedName":"/FormButtons<any>","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"migration","type":{"packageName":"@proteinjs/db","name":"Migration","filePath":null,"qualifiedName":"@proteinjs/db/Migration","typeParameters":null,"directParents":null}},{"name":"defaultFormButtons","type":{"packageName":"","name":"FormButtons<any>","filePath":null,"qualifiedName":"/FormButtons<any>","typeParameters":null,"directParents":null}}]}],"typeParameters":[],"directParentInterfaces":[],"directParentClasses":[{"packageName":"@proteinjs/db-ui","name":"RecordFormCustomization","filePath":null,"qualifiedName":"@proteinjs/db-ui/RecordFormCustomization","isAbstract":false,"isStatic":false,"visibility":"public","properties":[],"methods":[],"typeParameters":[],"directParentInterfaces":[],"directParentClasses":[]}],"sourceType":2}}],"edges":[{"v":"@proteinjs/db-ui/QueryCursorLoader","w":"@proteinjs/ui/CursorLoader","value":"implements interface"},{"v":"@proteinjs/db-ui/QueryTableLoader","w":"@proteinjs/ui/TableLoader","value":"implements interface"},{"v":"@proteinjs/db-ui/RecordFormCustomization","w":"@proteinjs/reflection/Loadable","value":"implements interface"},{"v":"@proteinjs/db-ui/hashGeneratorPage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/recordFormPage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/recordTablePage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/tablesPage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/uuidGeneratorPage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/MigrationRecordFormCustomization","w":"@proteinjs/db-ui/RecordFormCustomization","value":"extends class"}]}';
+  '{"options":{"directed":true,"multigraph":false,"compound":false},"nodes":[{"v":"@proteinjs/db-ui/QueryCursorLoader","value":{"packageName":"@proteinjs/db-ui","name":"QueryCursorLoader","filePath":"/home/runner/work/db/db/packages/ui/src/table/QueryCursorLoader.ts","qualifiedName":"@proteinjs/db-ui/QueryCursorLoader","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"reactQueryKeys","type":{"packageName":"@proteinjs/ui","name":"ReactQueryKeys","filePath":null,"qualifiedName":"@proteinjs/ui/ReactQueryKeys","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"},{"name":"pager","type":{"packageName":"","name":"CursorWindowPager<T>","filePath":null,"qualifiedName":"/CursorWindowPager<T>","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"}],"methods":[{"name":"loadWindow","returnType":{"packageName":"","name":"Promise<CursorWindow<T>>","filePath":null,"qualifiedName":"/Promise<CursorWindow<T>>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"cursor","type":{"packageName":"","name":"CursorValue | null","filePath":null,"qualifiedName":"/CursorValue | null","typeParameters":null,"directParents":null}},{"name":"windowSize","type":{"packageName":"","name":"number","filePath":null,"qualifiedName":"/number","typeParameters":null,"directParents":null}}]}],"typeParameters":["/T extends Record"],"directParentInterfaces":[{"packageName":"@proteinjs/ui","name":"CursorLoader","filePath":null,"qualifiedName":"@proteinjs/ui/CursorLoader","properties":[],"methods":[],"typeParameters":["/T"],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/ui/CursorLoader"},{"v":"@proteinjs/db-ui/QueryTableLoader","value":{"packageName":"@proteinjs/db-ui","name":"QueryTableLoader","filePath":"/home/runner/work/db/db/packages/ui/src/table/QueryTableLoader.ts","qualifiedName":"@proteinjs/db-ui/QueryTableLoader","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"rowCountQb","type":{"packageName":"","name":"QueryBuilder<T>","filePath":null,"qualifiedName":"/QueryBuilder<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"paginationQb","type":{"packageName":"","name":"QueryBuilder<T>","filePath":null,"qualifiedName":"/QueryBuilder<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"reactQueryKeys","type":{"packageName":"","name":"TableLoader<T>[\'reactQueryKeys\']","filePath":null,"qualifiedName":"/TableLoader<T>[\'reactQueryKeys\']","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"},{"name":"table","type":{"packageName":"","name":"Table<T>","filePath":null,"qualifiedName":"/Table<T>","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"query","type":{"packageName":"","name":"Query<T>","filePath":null,"qualifiedName":"/Query<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"sort","type":{"packageName":"","name":"SortCriteria<T>[]","filePath":null,"qualifiedName":"/SortCriteria<T>[]","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"queryOptions","type":{"packageName":"","name":"QueryOptions<T>","filePath":null,"qualifiedName":"/QueryOptions<T>","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"private"}],"methods":[{"name":"load","returnType":{"packageName":"","name":"Promise<RowWindow<T>>","filePath":null,"qualifiedName":"/Promise<RowWindow<T>>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"startIndex","type":{"packageName":"","name":"number","filePath":null,"qualifiedName":"/number","typeParameters":null,"directParents":null}},{"name":"endIndex","type":{"packageName":"","name":"number","filePath":null,"qualifiedName":"/number","typeParameters":null,"directParents":null}},{"name":"skipRowCount","type":{"packageName":"","name":"boolean","filePath":null,"qualifiedName":"/boolean","typeParameters":null,"directParents":null}}]}],"typeParameters":["/T extends Record"],"directParentInterfaces":[{"packageName":"@proteinjs/ui","name":"TableLoader","filePath":null,"qualifiedName":"@proteinjs/ui/TableLoader","properties":[],"methods":[],"typeParameters":["/T"],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/ui/TableLoader"},{"v":"@proteinjs/db-ui/RecordFormCustomization","value":{"packageName":"@proteinjs/db-ui","name":"RecordFormCustomization","filePath":"/home/runner/work/db/db/packages/ui/src/form/RecordFormCustomization.tsx","qualifiedName":"@proteinjs/db-ui/RecordFormCustomization","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"table","type":{"packageName":"","name":"Table<any>","filePath":null,"qualifiedName":"/Table<any>","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"}],"methods":[{"name":"getFormButtons","returnType":{"packageName":"","name":"FormButtons<any>","filePath":null,"qualifiedName":"/FormButtons<any>","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"record","type":{"packageName":"","name":"any","filePath":null,"qualifiedName":"/any","typeParameters":null,"directParents":null}},{"name":"defaultFormButtons","type":{"packageName":"","name":"FormButtons<any>","filePath":null,"qualifiedName":"/FormButtons<any>","typeParameters":null,"directParents":null}}]},{"name":"getFieldLayout","returnType":{"packageName":"","name":"string[] | string[][]","filePath":null,"qualifiedName":"/string[] | string[][]","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"record","type":{"packageName":"","name":"any","filePath":null,"qualifiedName":"/any","typeParameters":null,"directParents":null}},{"name":"defaultFieldLayout","type":{"packageName":"","name":"string[] | string[][]","filePath":null,"qualifiedName":"/string[] | string[][]","typeParameters":null,"directParents":null}}]}],"typeParameters":[],"directParentInterfaces":[{"packageName":"@proteinjs/reflection","name":"Loadable","filePath":null,"qualifiedName":"@proteinjs/reflection/Loadable","properties":[],"methods":[],"typeParameters":[],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/reflection/Loadable"},{"v":"@proteinjs/db-ui/hashGeneratorPage","value":{"packageName":"@proteinjs/db-ui","name":"hashGeneratorPage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/HashGeneratorPage.tsx","qualifiedName":"@proteinjs/db-ui/hashGeneratorPage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/ui/Page"},{"v":"@proteinjs/db-ui/recordFormPage","value":{"packageName":"@proteinjs/db-ui","name":"recordFormPage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/RecordFormPage.tsx","qualifiedName":"@proteinjs/db-ui/recordFormPage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/db-ui/recordTablePage","value":{"packageName":"@proteinjs/db-ui","name":"recordTablePage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/RecordTablePage.tsx","qualifiedName":"@proteinjs/db-ui/recordTablePage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/db-ui/tablesPage","value":{"packageName":"@proteinjs/db-ui","name":"tablesPage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/TablesPage.tsx","qualifiedName":"@proteinjs/db-ui/tablesPage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/db-ui/uuidGeneratorPage","value":{"packageName":"@proteinjs/db-ui","name":"uuidGeneratorPage","filePath":"/home/runner/work/db/db/packages/ui/src/pages/UuidGeneratorPage.tsx","qualifiedName":"@proteinjs/db-ui/uuidGeneratorPage","type":{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":[{"packageName":"@proteinjs/ui","name":"Page","filePath":null,"qualifiedName":"@proteinjs/ui/Page","typeParameters":[],"directParents":null}]},"isExported":true,"isConst":true,"sourceType":0}},{"v":"@proteinjs/db-ui/SpecificTableProps"},{"v":"@proteinjs/db-ui/MigrationRecordFormCustomization","value":{"packageName":"@proteinjs/db-ui","name":"MigrationRecordFormCustomization","filePath":"/home/runner/work/db/db/packages/ui/src/form/customizations/MigrationRecordFormCustomization.tsx","qualifiedName":"@proteinjs/db-ui/MigrationRecordFormCustomization","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"table","type":null,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"}],"methods":[{"name":"getFormButtons","returnType":{"packageName":"","name":"FormButtons<any>","filePath":null,"qualifiedName":"/FormButtons<any>","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"migration","type":{"packageName":"@proteinjs/db","name":"Migration","filePath":null,"qualifiedName":"@proteinjs/db/Migration","typeParameters":null,"directParents":null}},{"name":"defaultFormButtons","type":{"packageName":"","name":"FormButtons<any>","filePath":null,"qualifiedName":"/FormButtons<any>","typeParameters":null,"directParents":null}}]}],"typeParameters":[],"directParentInterfaces":[],"directParentClasses":[{"packageName":"@proteinjs/db-ui","name":"RecordFormCustomization","filePath":null,"qualifiedName":"@proteinjs/db-ui/RecordFormCustomization","isAbstract":false,"isStatic":false,"visibility":"public","properties":[],"methods":[],"typeParameters":[],"directParentInterfaces":[],"directParentClasses":[]}],"sourceType":2}}],"edges":[{"v":"@proteinjs/db-ui/QueryCursorLoader","w":"@proteinjs/ui/CursorLoader","value":"implements interface"},{"v":"@proteinjs/db-ui/QueryTableLoader","w":"@proteinjs/ui/TableLoader","value":"implements interface"},{"v":"@proteinjs/db-ui/RecordFormCustomization","w":"@proteinjs/reflection/Loadable","value":"implements interface"},{"v":"@proteinjs/db-ui/hashGeneratorPage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/recordFormPage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/recordTablePage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/tablesPage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/uuidGeneratorPage","w":"@proteinjs/ui/Page","value":"has type"},{"v":"@proteinjs/db-ui/MigrationRecordFormCustomization","w":"@proteinjs/db-ui/RecordFormCustomization","value":"extends class"}]}';
 
 /** Generate Source Links */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteinjs/db-ui",
-  "version": "1.8.5",
+  "version": "1.9.1",
   "description": "Db ui components",
   "publishConfig": {
     "access": "public"
@@ -26,7 +26,7 @@
     "@emotion/styled": "11.11.0",
     "@mui/icons-material": "5.14.11",
     "@mui/material": "5.14.11",
-    "@proteinjs/db": "^1.30.0",
+    "@proteinjs/db": "^1.32.0",
     "@proteinjs/reflection": "^1.1.12",
     "@proteinjs/ui": "^4.5.0",
     "@proteinjs/util": "^1.6.1",
@@ -54,5 +54,5 @@
   },
   "main": "./dist/generated/index.js",
   "types": "./dist/generated/index.d.ts",
-  "gitHead": "91f8bc0e7c5873a61bd9ef6e4a1b380c24acc922"
+  "gitHead": "edfed2d7826c7e42ddc0ae84bf97cda11614c1f0"
 }

package/src/table/QueryCursorLoader.ts

@@ -1,70 +1,50 @@
-import { QueryBuilder, QueryOptions, Record, SortCriteria, Table, getDb } from '@proteinjs/db';
+import { CursorWindowPager, QueryBuilder, QueryOptions, Record, SortCriteria, Table } from '@proteinjs/db';
 import { CursorLoader, CursorValue, CursorWindow, ReactQueryKeys } from '@proteinjs/ui';
 
 /**
- * `CursorLoader` over the same QueryBuilder machinery as `QueryTableLoader`: each window
- * applies `cursorField < cursor` (`>` for an ascending sort) plus `paginate(0, windowSize)`
- * on a fresh build of the base query, so rows created or removed while paging can never
- * shift the window frame. The cursor field and direction derive from the PRIMARY sort
- * criterion.
+ * `CursorLoader` over the db-owned cursor-window machinery (`CursorWindowPager`): each window
+ * carries a lexicographic continuation past the anchor row — the primary sort axes plus a
+ * unique `id` tiebreak — and `paginate(0, windowSize)` on a fresh build of the base query, so
+ * rows created or removed while paging can never shift the window frame, and ties on the sort
+ * axis can never skip or duplicate boundary rows. Cursors are the pager's anchors encoded as
+ * strings (house `Serializer`, so dates/moments survive react-query page params).
  *
  * `dataKey` is the table name — table-level invalidation (`useTableMutation`) reaches every
  * cursor query over it; `dataQueryKey` is the serialized query + sort.
  */
 export class QueryCursorLoader<T extends Record> implements CursorLoader<T> {
   reactQueryKeys: ReactQueryKeys;
-  private sort: SortCriteria<T>[];
+  private pager: CursorWindowPager<T>;
 
   /**
    * @param table the table to load windows from
    * @param createQuery factory producing a FRESH conditions-only QueryBuilder per call —
-   *   builders are mutable, so every window builds its own to hang the cursor condition,
+   *   builders are mutable, so every window builds its own to hang the cursor conditions,
    *   sort, and pagination on
    * @param sort the sort criteria to apply to every window; the primary criterion is the
-   *   cursor axis
+   *   cursor axis (the pager appends the `id` tiebreak)
    * @param queryOptions query options passed through to every window query
    */
   constructor(
-    private table: Table<T>,
-    private createQuery: () => QueryBuilder<T>,
+    table: Table<T>,
+    createQuery: () => QueryBuilder<T>,
     sort?: SortCriteria<T>[],
-    private queryOptions?: QueryOptions<T>
+    queryOptions?: QueryOptions<T>
   ) {
-    this.sort = sort ? sort : [{ field: 'created' as keyof T, desc: true }];
+    const effectiveSort = sort ? sort : [{ field: 'created' as keyof T, desc: true }];
+    this.pager = new CursorWindowPager<T>(table, createQuery, effectiveSort, { queryOptions });
     this.reactQueryKeys = {
-      dataKey: this.table.name,
-      dataQueryKey: JSON.stringify({ query: this.createQuery(), sort: this.sort }),
+      dataKey: table.name,
+      dataQueryKey: JSON.stringify({ query: createQuery(), sort: effectiveSort }),
     };
   }
 
   async loadWindow(cursor: CursorValue | null, windowSize: number): Promise<CursorWindow<T>> {
-    const qb = this.buildWindowQuery(cursor, windowSize);
-    const rows = await getDb().query(this.table, qb, this.queryOptions);
-    return { rows, nextCursor: this.deriveNextCursor(rows, windowSize) };
-  }
-
-  private buildWindowQuery(cursor: CursorValue | null, windowSize: number): QueryBuilder<T> {
-    const qb = this.createQuery();
-    const primarySort = this.sort[0];
-    if (cursor !== null) {
-      qb.condition({
-        field: primarySort.field,
-        operator: primarySort.desc ? '<' : '>',
-        value: cursor as T[keyof T],
-      });
-    }
-    return qb.sort(this.sort).paginate({ start: 0, end: windowSize });
-  }
-
-  private deriveNextCursor(rows: T[], windowSize: number): CursorValue | null {
-    // A short window means the data set is exhausted; a full one implies more may exist —
-    // the next (short or empty) window settles it.
-    if (rows.length < windowSize) {
-      return null;
-    }
-    // NULL cursor-field rows collect at the tail under the sort, and a null tail can't
-    // anchor a cursor: the data set's dated rows are exhausted, so paging stops here.
-    const tail = rows[rows.length - 1][this.sort[0].field];
-    return tail == null ? null : (tail as unknown as CursorValue);
+    const anchor = cursor === null ? null : CursorWindowPager.decodeAnchor(cursor as string);
+    const window = await this.pager.loadWindow(anchor, windowSize);
+    return {
+      rows: window.rows,
+      nextCursor: window.nextAnchor ? CursorWindowPager.encodeAnchor(window.nextAnchor) : null,
+    };
   }
 }

package/test/QueryCursorLoader.test.ts

@@ -1,35 +1,24 @@
 /**
- * QueryCursorLoader (src/table/QueryCursorLoader.ts) at the pure level: react-query key
- * derivation, cursor threading into the window query, and next-cursor derivation — including
- * the null-tail exhaustion rule (NULL cursor-field rows collect at the tail under the sort;
- * a null tail can't anchor a cursor, so paging stops). Window queries are inspected through
- * the QueryBuilder graph; loadWindow's db round-trip is exercised with a stubbed getDb.
+ * QueryCursorLoader (src/table/QueryCursorLoader.ts) as the thin `CursorLoader` adapter over
+ * the db-owned `CursorWindowPager`: react-query key derivation, string-cursor encode/decode
+ * threading into the pager's lexicographic window queries (primary axis + `id` tiebreak), and
+ * exhaustion (short window, and the null-tail rule: NULL sort-value rows collect at the tail
+ * under the sort; a null can't anchor a continuation, so paging stops). The db round trip is
+ * injected through the pager's `options.db` seam via the house internals-cast pattern — no
+ * module mocking.
  */
 import moment from 'moment';
-
-const stagedRows: { rows: unknown[] } = { rows: [] };
-const queries: unknown[] = [];
-const stubDb = {
-  query: async (_table: unknown, qb: unknown) => {
-    queries.push(qb);
-    return stagedRows.rows;
-  },
-};
-
-jest.mock('@proteinjs/db', () => ({
-  ...jest.requireActual('@proteinjs/db'),
-  getDb: () => stubDb,
-}));
-
-import { QueryBuilder, SortCriteria, Table } from '@proteinjs/db';
-import { CursorValue } from '@proteinjs/ui';
+import { Db, QueryBuilder, SortCriteria, Table } from '@proteinjs/db';
 import { QueryCursorLoader } from '../src/table/QueryCursorLoader';
+// Load the reflection source graph so the house Serializer's custom serializers (moments)
+// are registered — cursor encode/decode fidelity rides them.
+import '../generated/index';
 
 type Row = {
   id: string;
   created: moment.Moment;
   updated: moment.Moment;
-  lastActivityAt?: moment.Moment;
+  lastActivityAt?: moment.Moment | null;
   isPinned?: boolean;
 };
 
@@ -37,13 +26,23 @@ const table = { name: 'test_content' } as Table<Row>;
 const sort: SortCriteria<Row>[] = [{ field: 'lastActivityAt', desc: true }];
 const createQuery = () => new QueryBuilder<Row>(table.name);
 
-/** House pattern: private helpers reachable via a typed cast on the instance. */
-type LoaderInternals = {
-  buildWindowQuery(cursor: CursorValue | null, windowSize: number): QueryBuilder<Row>;
-  deriveNextCursor(rows: Row[], windowSize: number): CursorValue | null;
-};
+const staged: { rows: Row[] } = { rows: [] };
+const executed: QueryBuilder<Row>[] = [];
+const stubDb = {
+  query: async (_table: unknown, qb: QueryBuilder<Row>) => {
+    executed.push(qb);
+    return staged.rows;
+  },
+} as unknown as Db;
+
+/** House pattern: private internals reachable via a typed cast on the instance. */
+type LoaderInternals = { pager: { options?: { db?: Db } } };
 
-const internals = (loader: QueryCursorLoader<Row>) => loader as unknown as LoaderInternals;
+const loaderWithStubDb = (sortCriteria?: SortCriteria<Row>[], query: () => QueryBuilder<Row> = createQuery) => {
+  const loader = new QueryCursorLoader<Row>(table, query, sortCriteria);
+  (loader as unknown as LoaderInternals).pager.options = { db: stubDb };
+  return loader;
+};
 
 const graphNodes = (qb: QueryBuilder<Row>): any[] => qb.graph.nodes().map((id: string) => qb.graph.node(id));
 const conditionNodes = (qb: QueryBuilder<Row>) => graphNodes(qb).filter((node) => node?.type === 'CONDITION');
@@ -54,12 +53,12 @@ const dated = (id: string, at: string | null): Row => ({
   id,
   created: moment(),
   updated: moment(),
-  lastActivityAt: at ? moment(at) : undefined,
+  lastActivityAt: at ? moment(at) : null,
 });
 
 beforeEach(() => {
-  stagedRows.rows = [];
-  queries.length = 0;
+  staged.rows = [];
+  executed.length = 0;
 });
 
 describe('reactQueryKeys', () => {
@@ -81,86 +80,80 @@ describe('reactQueryKeys', () => {
   });
 });
 
-describe('buildWindowQuery — cursor threading', () => {
-  it('the first window carries no cursor condition, only the sort and the window pagination', () => {
-    const loader = new QueryCursorLoader<Row>(table, createQuery, sort);
-    const qb = internals(loader).buildWindowQuery(null, 30);
+describe('loadWindow — cursor threading', () => {
+  it('the first window carries no cursor conditions — the sort (with id tiebreak) and the window pagination', async () => {
+    const loader = loaderWithStubDb(sort);
+    staged.rows = [];
+    await loader.loadWindow(null, 30);
+    expect(executed).toHaveLength(1);
+    const qb = executed[0];
     expect(conditionNodes(qb)).toHaveLength(0);
     expect(paginationNode(qb)).toMatchObject({ start: 0, end: 30 });
-    expect(sortNodes(qb)).toHaveLength(1);
-    expect(sortNodes(qb)[0].criteria).toMatchObject({ field: 'lastActivityAt', desc: true });
-  });
-
-  it('a cursor becomes `field < cursor` on the primary sort field for a descending sort', () => {
-    const loader = new QueryCursorLoader<Row>(table, createQuery, sort);
-    const cursor = moment('2026-08-10T12:00:00.000Z');
-    const qb = internals(loader).buildWindowQuery(cursor, 30);
-    const conditions = conditionNodes(qb);
-    expect(conditions).toHaveLength(1);
-    expect(conditions[0]).toMatchObject({ field: 'lastActivityAt', operator: '<' });
-    expect(conditions[0].value).toBe(cursor);
-    expect(paginationNode(qb)).toMatchObject({ start: 0, end: 30 });
+    expect(sortNodes(qb).map((node) => node.criteria)).toEqual([
+      { field: 'lastActivityAt', desc: true },
+      { field: 'id', desc: false },
+    ]);
   });
 
-  it('an ascending primary sort flips the cursor operator to `>`', () => {
-    const loader = new QueryCursorLoader<Row>(table, createQuery, [{ field: 'lastActivityAt', desc: false }]);
-    const qb = internals(loader).buildWindowQuery(5, 10);
-    expect(conditionNodes(qb)[0]).toMatchObject({ field: 'lastActivityAt', operator: '>', value: 5 });
-  });
-
-  it('every window builds on a FRESH query — cursor conditions never accumulate across windows', () => {
-    const loader = new QueryCursorLoader<Row>(table, createQuery, sort);
-    internals(loader).buildWindowQuery(moment('2026-08-10T12:00:00.000Z'), 30);
-    const second = internals(loader).buildWindowQuery(moment('2026-08-01T12:00:00.000Z'), 30);
-    expect(conditionNodes(second)).toHaveLength(1);
-  });
-});
-
-describe('deriveNextCursor — exhaustion', () => {
-  const loader = new QueryCursorLoader<Row>(table, createQuery, sort);
-
-  it('a short window is exhausted', () => {
-    expect(internals(loader).deriveNextCursor([dated('a', '2026-08-10T12:00:00.000Z')], 3)).toBeNull();
-    expect(internals(loader).deriveNextCursor([], 3)).toBeNull();
-  });
-
-  it('a full window anchors the next cursor at its tail', () => {
+  it('a full window returns a string cursor; feeding it back threads the lexicographic continuation', async () => {
+    const loader = loaderWithStubDb(sort);
     const rows = [
       dated('a', '2026-08-10T12:00:00.000Z'),
       dated('b', '2026-08-09T12:00:00.000Z'),
       dated('c', '2026-08-08T12:00:00.000Z'),
     ];
-    const next = internals(loader).deriveNextCursor(rows, 3);
-    expect(next).toBe(rows[2].lastActivityAt);
-  });
-
-  it('a full window with a NULL cursor-field tail is exhausted (null rows collect at the tail; no anchor)', () => {
-    const rows = [dated('a', '2026-08-10T12:00:00.000Z'), dated('b', '2026-08-09T12:00:00.000Z'), dated('c', null)];
-    expect(internals(loader).deriveNextCursor(rows, 3)).toBeNull();
+    staged.rows = rows;
+    const first = await loader.loadWindow(null, 3);
+    expect(first.rows).toBe(rows);
+    expect(typeof first.nextCursor).toBe('string');
+
+    staged.rows = [];
+    await loader.loadWindow(first.nextCursor, 3);
+    const qb = executed[1];
+    // Past-on-axis OR (equal-on-axis AND past-on-id), anchored at the tail row 'c' — with the
+    // moment surviving the string cursor round trip.
+    const conditions = conditionNodes(qb);
+    expect(conditions).toHaveLength(3);
+    const past = conditions.find((node) => node.operator === '<');
+    expect(past).toMatchObject({ field: 'lastActivityAt' });
+    expect(moment.isMoment(past.value)).toBe(true);
+    expect(past.value.toISOString()).toBe(rows[2].lastActivityAt!.toISOString());
+    expect(conditions.find((node) => node.operator === '=')).toMatchObject({ field: 'lastActivityAt' });
+    expect(conditions.find((node) => node.operator === '>')).toMatchObject({ field: 'id', value: 'c' });
   });
-});
 
-describe('loadWindow', () => {
-  it('returns the queried rows with the derived next cursor', async () => {
-    const loader = new QueryCursorLoader<Row>(table, createQuery, sort);
-    const rows = [
+  it('every window builds on a FRESH query — cursor conditions never accumulate across windows', async () => {
+    const loader = loaderWithStubDb(sort);
+    staged.rows = [
       dated('a', '2026-08-10T12:00:00.000Z'),
       dated('b', '2026-08-09T12:00:00.000Z'),
       dated('c', '2026-08-08T12:00:00.000Z'),
     ];
-    stagedRows.rows = rows;
+    const first = await loader.loadWindow(null, 3);
+    staged.rows = [
+      dated('d', '2026-08-07T12:00:00.000Z'),
+      dated('e', '2026-08-06T12:00:00.000Z'),
+      dated('f', '2026-08-05T12:00:00.000Z'),
+    ];
+    const second = await loader.loadWindow(first.nextCursor, 3);
+    staged.rows = [];
+    await loader.loadWindow(second.nextCursor, 3);
+    expect(conditionNodes(executed[2])).toHaveLength(3);
+  });
+});
+
+describe('loadWindow — exhaustion', () => {
+  it('a short window is exhausted (null cursor)', async () => {
+    const loader = loaderWithStubDb(sort);
+    staged.rows = [dated('a', '2026-08-10T12:00:00.000Z')];
     const window = await loader.loadWindow(null, 3);
-    expect(window.rows).toBe(rows);
-    expect(window.nextCursor).toBe(rows[2].lastActivityAt);
-    // The executed query is the built window query: pagination sized to the window.
-    expect(queries).toHaveLength(1);
-    expect(paginationNode(queries[0] as QueryBuilder<Row>)).toMatchObject({ start: 0, end: 3 });
+    expect(window.nextCursor).toBeNull();
   });
 
-  it('returns an exhausted window (null cursor) when the query comes back short', async () => {
-    const loader = new QueryCursorLoader<Row>(table, createQuery, sort);
-    stagedRows.rows = [dated('a', '2026-08-10T12:00:00.000Z')];
-    const window = await loader.loadWindow(moment('2026-08-11T12:00:00.000Z'), 3);
+  it('a full window with a NULL sort-value tail is exhausted (null rows collect at the tail; no anchor)', async () => {
+    const loader = loaderWithStubDb(sort);
+    staged.rows = [dated('a', '2026-08-10T12:00:00.000Z'), dated('b', '2026-08-09T12:00:00.000Z'), dated('c', null)];
+    const window = await loader.loadWindow(null, 3);
     expect(window.nextCursor).toBeNull();
   });
 });