@teleporthq/teleport-plugin-next-data-source 0.44.0 → 0.44.4

package/dist/esm/pagination-plugin.js

@@ -47,24 +47,24 @@ import { ChunkType, FileType, } from '@teleporthq/teleport-types';
 import * as types from '@babel/types';
 import { parseExpression } from '@babel/parser';
 import { ASTStatementOrder, GenericUtils, StringUtils } from '@teleporthq/teleport-shared';
-import { ASTUtils, URLQueryWriter, URLSearchParamSync } from '@teleporthq/teleport-plugin-common';
+import { ASTUtils, RouteUtils, URLQueryWriter, URLSearchParamSync, } from '@teleporthq/teleport-plugin-common';
 import { collectFilterLeafConditions, generateSafeFileName, pruneFilterTree } from './utils';
 import { generateDataSourceFetcherWithCore } from './data-source-fetchers';
 import { buildProductTransformOptions } from './transformations';
-import { appendSortsParam, extractDynamicSort, readFixedSort } from './sort-utils';
+import { appendSortsParam, buildSortAtStartGuard, buildStartingSortsValue, readRepeaterSort, } from './sort-utils';
 import { appendFiltersParam, buildStaticFiltersStringifyCall, pushStateIdsAsDeps, pushPropIdsAsDeps, } from './filter-utils';
 import { appendItemsPathParam, extractItemsPath } from './items-path';
 import { resolveRepeaterPerPage } from './repeater-page-size';
 import { applyLoadingStateToDataProvider, buildLoadingStateDeclarations, getLoadingStateVars, } from './loading-state';
 import { mergeServerCacheOptions, resolveCacheFromRepeaterContent } from './cache/config';
-import { buildCacheHydrationEffect, buildCacheStoreThen, buildCachedFetchBody, buildCachedParamsDeclarations, registerCacheClientImports, } from './cache/ast';
+import { buildCacheHydrationEffect, buildCacheStoreThen, buildCachedFetchBody, buildCachedParamsDeclarations, paramsVarFor, registerCacheClientImports, } from './cache/ast';
 import { convertControlToButton, dropInactivePaginationControls, findAllPaginationControls, findPaginationControl, PAGINATION_FOR_ATTR, readJSXAttributeString, setJSXExpressionAttribute, } from './pagination-controls';
 import { findRangeControls, wireRangeControl } from './range-control';
 import { findAllSearchInputsInJSX, pairSearchInputs, wireSearchInput } from './search-input';
 import { buildCountFetchEffect, buildCountSeqDeclaration } from './count-effect';
 import { findAllSearchClearButtonsInJSX, findSiblingSearchInput, wireSearchClearButton, } from './search-clear';
 import { buildPageTokensDeclaration, wireNumberedPagination, } from './numbered-pagination';
-import { buildAccumulatingRequestMark, buildAccumulatingResponseHandler, buildInfiniteScrollDeclarations, buildSentinelElement, buildSentinelObserverEffect, getInfiniteScrollVars, } from './infinite-scroll';
+import { buildAccumulatingRequestMark, buildAccumulatingResponseHandler, buildAppendingRequestCheck, buildFirstPageDeclaration, buildFirstPageSeedEffect, buildInfiniteScrollDeclarations, buildSentinelElement, buildSentinelObserverEffect, buildServerRowsExpression, getInfiniteScrollVars, } from './infinite-scroll';
 import { buildFilterSortPageResetEffect, buildPageResetRefDeclaration, hasNoPageResetDeps, } from './page-reset';
 import { buildPageUrlRefDeclaration, buildPageUrlSyncEffect } from './page-url-sync';
 import { isLocalizedProject } from './content-localization';
@@ -275,7 +275,7 @@ function buildFilterDestinationExpression(destination) {
     return ASTUtils.convertFilterDestinationToExpression(destination);
 }
 // Scan UIDL to find all data source usages and build a registry
-function buildStateRegistry(uidlNode) {
+function buildStateRegistry(uidlNode, stateDefinitions) {
     var usages = [];
     var byDataSourceId = new Map();
     var byArrayMapperRenderProp = new Map();
@@ -332,16 +332,19 @@ function buildStateRegistry(uidlNode) {
                 // is skipped for a dynamic sort) — the pre-rendered HTML carried no
                 // posts, and the browser fetched page 1 a second time. Only a sort
                 // bound to state (the admin panel's sortable columns) is dynamic.
-                var dynamicSort = void 0;
-                if ((!sorts || sorts.length === 0) && content.sort) {
-                    var fixedSort = readFixedSort(content.sort, content.sortDirection);
-                    if (fixedSort) {
-                        sorts = [fixedSort];
-                    }
-                    else {
-                        dynamicSort = extractDynamicSort(content.sort, content.sortDirection);
-                    }
+                //
+                // A sort the visitor picks still starts somewhere — the store's sort
+                // dropdown at "Name A-Z". Known at build time, it orders the
+                // server-side first page, which the list then shows while the visitor
+                // leaves the sort alone. Read as a plain list's page fetch reads it.
+                var repeaterSort = !sorts || sorts.length === 0
+                    ? readRepeaterSort(content.sort, content.sortDirection, stateDefinitions)
+                    : {};
+                if (repeaterSort.fixed) {
+                    sorts = [repeaterSort.fixed];
                 }
+                var dynamicSort = repeaterSort.dynamic;
+                var startingSort = repeaterSort.starting;
                 // Extract filters from parent's resource params, keeping the group tree
                 // the inspector authored (see `readFilterTree`).
                 var filters = [];
@@ -424,6 +427,7 @@ function buildStateRegistry(uidlNode) {
                     queryColumns: queryColumns,
                     sorts: sorts,
                     dynamicSort: dynamicSort,
+                    startingSort: startingSort,
                     filters: filters,
                     filterStateIds: filterStateIds,
                     filterPropIds: filterPropIds,
@@ -780,7 +784,7 @@ function pushFilterSortPageResetEffect(stateDeclarations, effectStatements, usag
 // ==================== MAIN PLUGIN ====================
 export var createNextArrayMapperPaginationPlugin = function () {
     var paginationPlugin = function (structure) { return __awaiter(void 0, void 0, void 0, function () {
-        var uidl, chunks, dependencies, options, componentChunk, variableDeclaration, declarator, arrowFunction, blockStatement, rangeControls, hasRangeControl, registry, getStaticPropsChunk, isPage, localized, stateDeclarations, effectStatements, needsUseRouter, returnIndex, insertIndex, dataProviders, dataProvidersWithRepeaters, usageIndexByDataSourceId, loadingStateDeclarations, usagesWithLoadingState, usageByProviderNode, cacheDeclarations, sharedOptions, cachedScopes, dataProvidersWithoutRepeaters, searchInputs, usageBySearchInput, _i, searchInputs_1, input, usage;
+        var uidl, chunks, dependencies, options, componentChunk, variableDeclaration, declarator, arrowFunction, blockStatement, rangeControls, hasRangeControl, registry, getStaticPropsChunk, isPage, localized, stateDeclarations, effectStatements, needsUseRouter, returnIndex, insertIndex, dataProviders, dataProvidersWithRepeaters, usageIndexByDataSourceId, loadingStateDeclarations, usagesWithLoadingState, usageByProviderNode, cacheDeclarations, firstPageDeclarations, sharedOptions, cachedScopes, dataProvidersWithoutRepeaters, searchInputs, usageBySearchInput, _i, searchInputs_1, input, usage;
         var _a, _b;
         return __generator(this, function (_c) {
             uidl = structure.uidl, chunks = structure.chunks, dependencies = structure.dependencies, options = structure.options;
@@ -806,7 +810,7 @@ export var createNextArrayMapperPaginationPlugin = function () {
             blockStatement = arrowFunction.body;
             rangeControls = findRangeControls(blockStatement);
             hasRangeControl = rangeControls.length > 0;
-            registry = buildStateRegistry(uidl.node);
+            registry = buildStateRegistry(uidl.node, uidl.stateDefinitions);
             if (registry.usages.length === 0) {
                 return [2 /*return*/, structure];
             }
@@ -1141,6 +1145,7 @@ export var createNextArrayMapperPaginationPlugin = function () {
             usagesWithLoadingState = new Set();
             usageByProviderNode = new Map();
             cacheDeclarations = [];
+            firstPageDeclarations = isPage ? [] : undefined;
             dataProvidersWithRepeaters.forEach(function (dp) {
                 var _a, _b;
                 var nameAttr = dp.openingElement.attributes.find(function (attr) { return attr.type === 'JSXAttribute' && attr.name.name === 'name'; });
@@ -1161,10 +1166,10 @@ export var createNextArrayMapperPaginationPlugin = function () {
                 var fileName = generateSafeFileName(usage.resourceDefinition.dataSourceType, usage.resourceDefinition.tableName, usage.resourceDefinition.dataSourceId);
                 // Update DataProvider based on category
                 if (usage.category === 'paginated+search') {
-                    updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDeclarations, localized);
+                    updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDeclarations, localized, firstPageDeclarations);
                 }
                 else if (usage.category === 'paginated-only') {
-                    updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDeclarations, localized);
+                    updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDeclarations, localized, firstPageDeclarations);
                 }
                 else if (usage.category === 'search-only') {
                     updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclarations, localized);
@@ -1176,9 +1181,14 @@ export var createNextArrayMapperPaginationPlugin = function () {
                 // change refetches, instead of leaving the previous rows on screen with
                 // no feedback. Runs last so it sees the `fetchData` and
                 // `persistDataDuringLoading` attributes the updaters above just wrote.
+                // An appending list keeps its rows on screen while its next page loads;
+                // only a list loading afresh falls through to the loading slot.
                 var loadingVars = getLoadingStateVars(usage.index);
-                if (applyLoadingStateToDataProvider(dp, loadingVars)) {
-                    loadingStateDeclarations.push.apply(loadingStateDeclarations, buildLoadingStateDeclarations(loadingVars));
+                var appendingRequest = usage.infiniteScroll && usage.paginated
+                    ? buildAppendingRequestCheck(getInfiniteScrollVars(usage.index))
+                    : undefined;
+                if (applyLoadingStateToDataProvider(dp, loadingVars, appendingRequest)) {
+                    loadingStateDeclarations.push.apply(loadingStateDeclarations, buildLoadingStateDeclarations(loadingVars, !!appendingRequest));
                     // Recorded because the loading state is only declared for a provider
                     // that HAS a loading slot; a Load More button wired later may only
                     // reference `ds_N_isFetching` if it actually exists.
@@ -1223,6 +1233,11 @@ export var createNextArrayMapperPaginationPlugin = function () {
                 ASTStatementOrder.insertStatementsAfterDependencies(blockStatement, cacheDeclarations);
                 registerCacheClientImports(dependencies, (_a = uidl.outputOptions) === null || _a === void 0 ? void 0 : _a.folderPath);
             }
+            // After the cache declarations: a cached list's first page reads the
+            // `ds_N_params` they hoisted.
+            if (firstPageDeclarations === null || firstPageDeclarations === void 0 ? void 0 : firstPageDeclarations.length) {
+                ASTStatementOrder.insertStatementsAfterDependencies(blockStatement, firstPageDeclarations);
+            }
             dataProvidersWithoutRepeaters = dataProviders.filter(function (dp) {
                 var hasRepeater = findArrayMapperRenderPropInDataProvider(dp) !== undefined;
                 return !hasRepeater;
@@ -1283,9 +1298,11 @@ export var createNextArrayMapperPaginationPlugin = function () {
                     wireRangeControlFor(control, owner, getStateVarsForUsage(owner));
                 }
             });
-            // STEP 6: Update getStaticProps if this is a page
+            // STEP 6: Update getStaticProps if this is a page. Its rows are what the
+            // page renders, so they are read as a visitor is served them — unless only
+            // the store's trusted readers can open the page (`pageDataReadArguments`).
             if (isPage) {
-                updateGetStaticProps(chunks, registry, dependencies, (_b = uidl.outputOptions) === null || _b === void 0 ? void 0 : _b.folderPath, localized);
+                updateGetStaticProps(chunks, registry, dependencies, (_b = uidl.outputOptions) === null || _b === void 0 ? void 0 : _b.folderPath, localized, function () { return RouteUtils.pageDataReadArguments(uidl, options.auth); });
             }
             return [2 /*return*/, structure];
         });
@@ -1544,34 +1561,97 @@ function findPaginationNodesWithOwners(blockStatement, usageByProviderNode) {
  *
  * An uncached mapper keeps the inline `params={useMemo(...)}` it has always had,
  * byte for byte. A cached one hoists that memo into a component const so the
- * peek can depend on the same object identity instead of rebuilding it.
+ * peek can depend on the same object identity instead of rebuilding it; so does
+ * an appending list that starts from its page's rows (`hoistInto`), whose first
+ * page is filed in the accumulator under those params.
  *
- * Returns the identifier holding the peeked rows, or `undefined` when this
- * mapper does not cache.
+ * Returns the identifier holding the params when they were hoisted, and the one
+ * holding the peeked rows when this mapper caches.
  */
 function pushParamsAttribute(
 // tslint:disable-next-line:no-any
-dp, usage, paramsProps, memoDeps, cacheDeclarations) {
+dp, usage, paramsProps, memoDeps, cacheDeclarations, hoistInto) {
     var _a;
     var paramsMemo = types.callExpression(types.identifier('useMemo'), [
         types.arrowFunctionExpression([], types.objectExpression(paramsProps)),
         types.arrayExpression(memoDeps),
     ]);
-    // A state-bound sort deliberately suppresses `initialData` (see the comment at
-    // the call site): the prefetch ran without sort params, so reusing anything on
-    // mount would mask the current sort. The cache peek is `initialData` by
-    // another name, so it has to be suppressed for exactly the same reason.
+    // A state-bound sort gets no cache peek. The peek is `initialData` by another
+    // name, and such a list takes the server's rows only while its sort is still
+    // where the visitor starts (`buildStartingSortGuard`); the peek was never
+    // extended to it.
     var cache = ((_a = usage.cache) === null || _a === void 0 ? void 0 : _a.client) && !usage.dynamicSort ? usage.cache : undefined;
     if (!cache) {
-        dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('params'), types.jsxExpressionContainer(paramsMemo)));
-        return undefined;
+        if (!hoistInto) {
+            dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('params'), types.jsxExpressionContainer(paramsMemo)));
+            return {};
+        }
+        var paramsIdentifier = paramsVarFor(usage.index);
+        hoistInto.push(types.variableDeclaration('const', [
+            types.variableDeclarator(types.identifier(paramsIdentifier), paramsMemo),
+        ]));
+        dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('params'), types.jsxExpressionContainer(types.identifier(paramsIdentifier))));
+        return { paramsIdentifier: paramsIdentifier };
     }
     var hoisted = buildCachedParamsDeclarations({ index: usage.index, paramsMemo: paramsMemo, cache: cache });
     cacheDeclarations.push.apply(cacheDeclarations, hoisted.declarations);
     dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('params'), types.jsxExpressionContainer(types.identifier(hoisted.paramsIdentifier))));
-    return hoisted.cachedIdentifier;
+    return { paramsIdentifier: hoisted.paramsIdentifier, cachedIdentifier: hoisted.cachedIdentifier };
+}
+// Whether the rows `getStaticProps` fetched can be this list's first page at
+// all. A sort bound to state can only be served them when the build knows the
+// sort the visitor starts with (`startingSort`) and fetched by it; otherwise
+// the fetch has no sort, and its rows are not the list's first page.
+function prefetchFollowsSort(usage) {
+    return !usage.dynamicSort || !!usage.startingSort;
+}
+// `sortBy === "name-asc"`: the visitor has not moved the sort from where it
+// starts, so the build-time rows are still its first page. `null` for a list
+// whose sort the visitor cannot pick, or one that reads no state.
+function buildStartingSortGuard(usage) {
+    return usage.dynamicSort && usage.startingSort ? buildSortAtStartGuard(usage.startingSort) : null;
+}
+// `<condition> && <starting-sort guard>`, or the condition alone.
+function withStartingSortGuard(condition, usage) {
+    var sortGuard = buildStartingSortGuard(usage);
+    return sortGuard ? types.logicalExpression('&&', condition, sortGuard) : condition;
+}
+// An appending list on a page starts from the rows its `getStaticProps`
+// fetched, when they can be its first page (`prefetchFollowsSort`).
+function startsFromServerRows(usage) {
+    return usage.infiniteScroll && usage.paginated && prefetchFollowsSort(usage);
 }
-function updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDeclarations, localized) {
+/**
+ * `initialData={ds_N_firstPage}` on an appending list, beside the frozen first
+ * page and the effect that files it as page 1 of the accumulator (see
+ * `infinite-scroll.ts`).
+ *
+ * The rows stand in for page 1 only while they answer the list's query: no
+ * search (`queryGuard`), the sort where the visitor starts, no filter set (the
+ * guards the paged lists use), and at least one row — an empty build-time
+ * answer, which a failed fetch also gives, leaves the browser to fetch page 1
+ * as before.
+ */
+function pushInfiniteScrollFirstPage(
+// tslint:disable-next-line:no-any
+dp, usage, vars, paramsIdentifier, declarations, queryGuard, instanceDeps) {
+    var infiniteVars = getInfiniteScrollVars(usage.index);
+    var serverPayload = function () {
+        return types.optionalMemberExpression(types.identifier('props'), types.identifier(vars.propsPrefix), false, true);
+    };
+    var hasServerRows = types.binaryExpression('>', types.optionalMemberExpression(buildServerRowsExpression(serverPayload(), usage.itemsPath), types.identifier('length'), false, true), types.numericLiteral(0));
+    var startsFromServer = [
+        queryGuard,
+        buildStartingSortGuard(usage),
+        buildNoUrlFilterGuard(usage),
+        hasServerRows,
+    ]
+        .filter(function (guard) { return guard !== null; })
+        .reduce(function (all, guard) { return types.logicalExpression('&&', all, guard); });
+    declarations.push(buildFirstPageDeclaration(infiniteVars, startsFromServer, serverPayload(), instanceDeps), buildFirstPageSeedEffect(infiniteVars, paramsIdentifier, usage.perPage, usage.itemsPath));
+    dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('initialData'), types.jsxExpressionContainer(types.identifier(infiniteVars.firstPageVar))));
+}
+function updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDeclarations, localized, firstPageDeclarations) {
     var attrs = dp.openingElement.attributes;
     // Remove existing params, key, initialData, fetchData, persistDataDuringLoading
     dp.openingElement.attributes = attrs.filter(function (attr) {
@@ -1604,20 +1684,29 @@ function updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDe
     if (localized) {
         appendClientLocaleParam(paramsProps, memoDeps);
     }
-    var cachedInitialData = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations);
-    // Add initialData. Skip the server-prefetched data entirely when a dynamic
-    // state-bound sort is active — the prefetch ran without sort parameters, so
-    // reusing it would mask the current sort state AND cause DataProvider to skip
-    // the first client fetch (its internal guard only skips when initialData is
-    // defined on mount). Without that skip, toggling sort correctly triggers a
-    // refetch via the useMemo params dependency chain.
+    var seedInto = startsFromServerRows(usage) ? firstPageDeclarations : undefined;
+    var _a = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations, seedInto), paramsIdentifier = _a.paramsIdentifier, cachedInitialData = _a.cachedIdentifier;
+    // Add initialData: the server-prefetched page 1 while it is the page on show
+    // — page 1, no search, no filter set, and a sort the visitor picks still where
+    // they start (the prefetch ran by that sort). A list whose starting sort the
+    // build cannot know never takes it: that prefetch ran without a sort, so
+    // reusing it would mask the current sort AND make DataProvider skip its first
+    // client fetch (its internal guard only skips when initialData is defined on
+    // mount). Any other sort is fetched fresh, through the useMemo params.
     //
-    // An appending list skips it for a second reason: `initialData` makes
-    // DataProvider skip its first fetch, so page 1 would render from the prefetch
-    // and never enter the accumulator — appending page 2 would then REPLACE the
-    // visible rows with page 2 alone.
-    if (!usage.dynamicSort && !usage.infiniteScroll) {
-        var initialDataCondition = wrapInitialDataWithUrlFilterGuard(types.logicalExpression('&&', types.binaryExpression('===', types.memberExpression(types.identifier(vars.combinedStateVar), types.identifier('page')), types.numericLiteral(1)), types.unaryExpression('!', types.memberExpression(types.identifier(vars.combinedStateVar), types.identifier('debouncedQuery')), true)), usage);
+    // An appending list takes its own: `initialData` makes DataProvider skip its
+    // first fetch, so the prefetched page 1 has to be filed in the accumulator
+    // too, or appending page 2 would REPLACE the visible rows with page 2 alone.
+    // The provider remounts per query (its `key`), so the first page is frozen
+    // per query.
+    if (seedInto && paramsIdentifier) {
+        var appliedQuery = function () {
+            return types.memberExpression(types.identifier(vars.combinedStateVar), types.identifier('debouncedQuery'));
+        };
+        pushInfiniteScrollFirstPage(dp, usage, vars, paramsIdentifier, seedInto, types.unaryExpression('!', appliedQuery(), true), [appliedQuery()]);
+    }
+    else if (prefetchFollowsSort(usage) && !usage.infiniteScroll) {
+        var initialDataCondition = wrapInitialDataWithUrlFilterGuard(withStartingSortGuard(types.logicalExpression('&&', types.binaryExpression('===', types.memberExpression(types.identifier(vars.combinedStateVar), types.identifier('page')), types.numericLiteral(1)), types.unaryExpression('!', types.memberExpression(types.identifier(vars.combinedStateVar), types.identifier('debouncedQuery')), true)), usage), usage);
         dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('initialData'), types.jsxExpressionContainer(types.conditionalExpression(initialDataCondition, types.optionalMemberExpression(types.identifier('props'), types.identifier(vars.propsPrefix), false, true), cachedInitialData ? types.identifier(cachedInitialData) : types.identifier('undefined')))));
     }
     // Add key. Sort is intentionally NOT part of the key — a key change would
@@ -1655,7 +1744,7 @@ function updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDe
     // Add persistDataDuringLoading
     dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('persistDataDuringLoading'), types.jsxExpressionContainer(types.booleanLiteral(true))));
 }
-function updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDeclarations, localized) {
+function updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDeclarations, localized, firstPageDeclarations) {
     var attrs = dp.openingElement.attributes;
     dp.openingElement.attributes = attrs.filter(function (attr) {
         var _a;
@@ -1684,12 +1773,17 @@ function updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDec
         appendClientLocaleParam(paramsProps, memoDeps);
     }
     // Add params
-    var cachedInitialData = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations);
-    // Add initialData. See paginated+search updater for why we skip prefetch
-    // reuse when a dynamic state-bound sort is active, and why an appending list
-    // skips it too.
-    if (!usage.dynamicSort && !usage.infiniteScroll) {
-        dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('initialData'), types.jsxExpressionContainer(types.conditionalExpression(wrapInitialDataWithUrlFilterGuard(types.binaryExpression('===', types.identifier(vars.pageStateVar), types.numericLiteral(1)), usage), types.optionalMemberExpression(types.identifier('props'), types.identifier(vars.propsPrefix), false, true), cachedInitialData ? types.identifier(cachedInitialData) : types.identifier('undefined')))));
+    var seedInto = startsFromServerRows(usage) ? firstPageDeclarations : undefined;
+    var _a = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations, seedInto), paramsIdentifier = _a.paramsIdentifier, cachedInitialData = _a.cachedIdentifier;
+    // Add initialData. See paginated+search updater for when a sort the visitor
+    // picks may reuse the prefetch, and how an appending list takes its own. This
+    // provider never remounts (no `key`), so its first page is frozen for the
+    // page's lifetime.
+    if (seedInto && paramsIdentifier) {
+        pushInfiniteScrollFirstPage(dp, usage, vars, paramsIdentifier, seedInto, null, []);
+    }
+    else if (prefetchFollowsSort(usage) && !usage.infiniteScroll) {
+        dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('initialData'), types.jsxExpressionContainer(types.conditionalExpression(wrapInitialDataWithUrlFilterGuard(withStartingSortGuard(types.binaryExpression('===', types.identifier(vars.pageStateVar), types.numericLiteral(1)), usage), usage), types.optionalMemberExpression(types.identifier('props'), types.identifier(vars.propsPrefix), false, true), cachedInitialData ? types.identifier(cachedInitialData) : types.identifier('undefined')))));
     }
     // Add key — sort is intentionally NOT included; see paginated+search updater,
     // which also explains why an appending list keys on nothing at all (there is
@@ -1739,11 +1833,11 @@ function updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclara
     if (localized) {
         appendClientLocaleParam(paramsProps, memoDeps);
     }
-    var cachedInitialData = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations);
-    // Add initialData. See paginated+search updater for why we skip prefetch
-    // reuse when a dynamic state-bound sort is active.
-    if (!usage.dynamicSort) {
-        dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('initialData'), types.jsxExpressionContainer(types.conditionalExpression(wrapInitialDataWithUrlFilterGuard(types.unaryExpression('!', types.identifier(vars.debouncedSearchQueryVar), true), usage), types.optionalMemberExpression(types.identifier('props'), types.identifier(vars.propsPrefix), false, true), cachedInitialData ? types.identifier(cachedInitialData) : types.identifier('undefined')))));
+    var cachedInitialData = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations).cachedIdentifier;
+    // Add initialData. See paginated+search updater for when a sort the visitor
+    // picks may reuse the prefetch.
+    if (prefetchFollowsSort(usage)) {
+        dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('initialData'), types.jsxExpressionContainer(types.conditionalExpression(wrapInitialDataWithUrlFilterGuard(withStartingSortGuard(types.unaryExpression('!', types.identifier(vars.debouncedSearchQueryVar), true), usage), usage), types.optionalMemberExpression(types.identifier('props'), types.identifier(vars.propsPrefix), false, true), cachedInitialData ? types.identifier(cachedInitialData) : types.identifier('undefined')))));
     }
     // Add key — sort is intentionally NOT included; see paginated+search updater.
     dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('key'), types.jsxExpressionContainer(types.templateLiteral([
@@ -1754,14 +1848,42 @@ function updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclara
     dp.openingElement.attributes.push(createFetchDataAttribute(fileName, ((_a = usage.cache) === null || _a === void 0 ? void 0 : _a.client) ? usage.cache : undefined));
     dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('persistDataDuringLoading'), types.jsxExpressionContainer(types.booleanLiteral(true))));
 }
+/**
+ * A plain list on a page is seeded with the rows its `getStaticProps` fetched
+ * (`extractDataSourceIntoGetStaticProps`), and a seeded provider skips its first
+ * fetch. With a sort the visitor picks, those rows are the list's only while the
+ * sort is where a visitor starts — the build fetched them by it:
+ *
+ *   initialData={sortBy === "name-asc" ? props.items_products : undefined}
+ *
+ * — and any other sort is fetched fresh, through the params it changes. When the
+ * build cannot know where the sort starts (`prefetchFollowsSort`), it fetched
+ * the rows unsorted, and the list is never seeded with them. A plain list has no
+ * search, and is only seeded without a filter a visitor sets.
+ */
+function seedPlainListWhileSortStarts(dp, usage) {
+    if (!usage.dynamicSort) {
+        return;
+    }
+    var attrs = dp.openingElement.attributes;
+    var index = attrs.findIndex(function (attr) { var _a; return attr.type === 'JSXAttribute' && ((_a = attr.name) === null || _a === void 0 ? void 0 : _a.name) === 'initialData'; });
+    if (index === -1) {
+        return;
+    }
+    if (!prefetchFollowsSort(usage)) {
+        attrs.splice(index, 1);
+        return;
+    }
+    var sortGuard = buildStartingSortGuard(usage);
+    var seeded = attrs[index].value;
+    if (!sortGuard || (seeded === null || seeded === void 0 ? void 0 : seeded.type) !== 'JSXExpressionContainer') {
+        return;
+    }
+    attrs[index] = types.jsxAttribute(types.jsxIdentifier('initialData'), types.jsxExpressionContainer(types.conditionalExpression(sortGuard, seeded.expression, types.identifier('undefined'))));
+}
 function updateDataProviderForPlain(dp, fileName, usage, localized) {
     var _a, _b, _c, _d, _e, _f;
-    // A sort bound to state is the visitor's, which the server cannot know: rows
-    // pre-rendered in the table's order would stand in for it, since a seeded
-    // provider skips its first fetch — the paginated lists drop them the same way.
-    if (usage.dynamicSort) {
-        dp.openingElement.attributes = dp.openingElement.attributes.filter(function (attr) { var _a; return !(attr.type === 'JSXAttribute' && ((_a = attr.name) === null || _a === void 0 ? void 0 : _a.name) === 'initialData'); });
-    }
+    seedPlainListWhileSortStarts(dp, usage);
     var attrs = dp.openingElement.attributes;
     var clientCache = ((_a = usage.cache) === null || _a === void 0 ? void 0 : _a.client) ? usage.cache : undefined;
     // Check if fetchData already exists
@@ -2215,7 +2337,15 @@ function ensureAPIRouteExists(extractedResources, usage, dataSources, transformO
         };
     }
 }
-function updateGetStaticProps(chunks, registry, dependencies, folderPath, localized) {
+// `fetchCount(<params>, <read arguments>)`: the params may be left out only
+// when nothing follows them.
+var countReadArguments = function (countParams, readArguments) {
+    return countParams.length > 0 || readArguments.length > 0
+        ? __spreadArray([types.objectExpression(countParams)], readArguments, true) : [];
+};
+function updateGetStaticProps(chunks, registry, dependencies, folderPath, localized, 
+// The arguments every read hands the module after its params (fresh nodes per call).
+readArguments) {
     var _a;
     var getStaticPropsChunk = chunks.find(function (c) { return c.name === 'getStaticProps'; });
     if (!getStaticPropsChunk || getStaticPropsChunk.type !== ChunkType.AST) {
@@ -2296,6 +2426,12 @@ function updateGetStaticProps(chunks, registry, dependencies, folderPath, locali
                 })),
             ])));
         }
+        else if (usage.dynamicSort && usage.startingSort) {
+            // A sort the visitor picks: page 1 by the sort they start with, sent
+            // as the very string the browser sends for it, so page 2 continues
+            // this page exactly (see `buildStartingSortsValue`).
+            fetchParams.push(types.objectProperty(types.identifier('sorts'), buildStartingSortsValue(usage.dynamicSort, usage.startingSort)));
+        }
         // Add filters if present
         // Filter out dynamic destinations for getStaticProps (they can't be resolved at build time)
         var staticFilters = staticFiltersOf(usage);
@@ -2311,7 +2447,7 @@ function updateGetStaticProps(chunks, registry, dependencies, folderPath, locali
         var existingFetchIndex = arrayPattern.elements.findIndex(function (el) { return (el === null || el === void 0 ? void 0 : el.type) === 'Identifier' && el.name === vars.propsPrefix; });
         if (existingFetchIndex === -1) {
             arrayPattern.elements.push(types.identifier(vars.propsPrefix));
-            fetchesArray.elements.push(types.callExpression(types.memberExpression(types.callExpression(types.memberExpression(types.identifier(fetcherImportName), types.identifier('fetchData')), [types.objectExpression(fetchParams)]), types.identifier('catch')), [
+            fetchesArray.elements.push(types.callExpression(types.memberExpression(types.callExpression(types.memberExpression(types.identifier(fetcherImportName), types.identifier('fetchData')), __spreadArray([types.objectExpression(fetchParams)], readArguments(), true)), types.identifier('catch')), [
                 types.arrowFunctionExpression([types.identifier('error')], types.blockStatement([
                     types.expressionStatement(types.callExpression(types.memberExpression(types.identifier('console'), types.identifier('error')), [
                         types.stringLiteral("Error fetching ".concat(vars.propsPrefix, ":")),
@@ -2414,7 +2550,7 @@ function updateGetStaticProps(chunks, registry, dependencies, folderPath, locali
                     countParams.push(types.objectProperty(types.identifier('filters'), buildStaticFiltersStringifyCall(staticFiltersForCount)));
                 }
                 appendItemsPathParam(countParams, firstUsage.itemsPath, 'collectionPath');
-                fetchesArray.elements.push(types.callExpression(types.memberExpression(types.callExpression(types.memberExpression(types.identifier(fetcherImportName), types.identifier('fetchCount')), countParams.length > 0 ? [types.objectExpression(countParams)] : []), types.identifier('catch')), [
+                fetchesArray.elements.push(types.callExpression(types.memberExpression(types.callExpression(types.memberExpression(types.identifier(fetcherImportName), types.identifier('fetchCount')), countReadArguments(countParams, readArguments())), types.identifier('catch')), [
                     types.arrowFunctionExpression([types.identifier('error')], types.blockStatement([
                         types.expressionStatement(types.callExpression(types.memberExpression(types.identifier('console'), types.identifier('error')), [
                             types.stringLiteral("Error fetching ".concat(countVarName, ":")),