@teleporthq/teleport-plugin-next-data-source 0.43.57 → 0.43.60

package/dist/esm/infinite-scroll.d.ts

@@ -0,0 +1,65 @@
+import * as types from '@babel/types';
+/**
+ * Infinite scroll: the list APPENDS pages instead of replacing them.
+ *
+ * The accumulation lives inside the generated `fetchData` closure rather than
+ * around the provider. `DataProvider` renders whatever `fetchData` resolves
+ * with, so returning "every page fetched so far, in order" is enough to make it
+ * append — no change to the runtime component library, and the existing
+ * `persistDataDuringLoading` keeps the rows already on screen while the next
+ * page is in flight.
+ *
+ * A `useRef` holds the pages rather than a state, because writing accumulated
+ * rows into state from inside `fetchData` would re-render the provider mid-fetch
+ * and re-enter it. The ref is keyed by a SIGNATURE of every fetch param except
+ * the page, so a filter, sort or search change starts a fresh list instead of
+ * interleaving rows from two different queries.
+ */
+export interface InfiniteScrollVars {
+    accumRefVar: string;
+    hasMoreFlagVar: string;
+    setHasMoreFlagVar: string;
+    hasMoreVar: string;
+    sentinelRefVar: string;
+}
+export declare const getInfiniteScrollVars: (index: number) => InfiniteScrollVars;
+/**
+ * The three declarations behind an appending list:
+ *
+ *   const ds_0_accumRef = useRef({ sig: '', pages: {} })
+ *   const [ds_0_hasMoreFlag, setDs_0_hasMoreFlag] = useState(true)
+ *   const ds_0_hasMore = ds_0_hasMoreFlag && (ds_0_maxPages === 0 || <page> < ds_0_maxPages)
+ *
+ * Two independent signals for "is there more", because either can be missing.
+ * `hasMoreFlag` comes from the last response being a SHORT page, which is the
+ * only end-of-data signal available from a data source that cannot count.
+ * `maxPages` comes from the count endpoint and is the one that stops a request
+ * being made at all; it is `0` while unknown, hence the explicit escape.
+ */
+export declare const buildInfiniteScrollDeclarations: (vars: InfiniteScrollVars, maxPagesVar: string, currentPageExpr: types.Expression, includeSentinel: boolean) => types.Statement[];
+/**
+ * The `.then(...)` tail that accumulates a page and reports whether more exist.
+ *
+ * Returned as the resolved value of `fetchData`, so `DataProvider` stores the
+ * whole accumulated list as its data.
+ */
+export declare const buildAccumulatingResponseHandler: (vars: InfiniteScrollVars, perPage: number) => types.ArrowFunctionExpression;
+/**
+ * The IntersectionObserver that loads the next page when the sentinel scrolls
+ * into view. Emitted only in auto mode (no Load More button).
+ *
+ * `rootMargin` starts the fetch a screenful early so the list rarely shows a
+ * gap. The observer is rebuilt whenever `hasMore` or `maxPages` change and
+ * disconnected on cleanup; when there is nothing more to load the effect exits
+ * before observing, so a finished list costs nothing.
+ */
+export declare const buildSentinelObserverEffect: (vars: InfiniteScrollVars, maxPagesVar: string, buildAdvancePageStatement: () => types.Statement) => types.ExpressionStatement;
+/**
+ * `<div ref={ds_N_sentinelRef} aria-hidden="true" style={{ height: '1px' }} />`
+ *
+ * An invisible one-pixel row after the list. It is generated rather than
+ * authored because it is not a control — there is nothing to style or click,
+ * only a position in the document for the observer to watch.
+ */
+export declare const buildSentinelElement: (vars: InfiniteScrollVars) => types.JSXElement;
+//# sourceMappingURL=infinite-scroll.d.ts.map

package/dist/esm/infinite-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infinite-scroll.d.ts","sourceRoot":"","sources":["../../src/infinite-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,qBAAqB,UAAW,MAAM,KAAG,kBAMpD,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,+BAA+B,SACpC,kBAAkB,eACX,MAAM,mBACF,MAAM,UAAU,mBAChB,OAAO,KACvB,MAAM,SAAS,EAsDjB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,SACrC,kBAAkB,WACf,MAAM,KACd,MAAM,uBAoIR,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,SAChC,kBAAkB,eACX,MAAM,6BACQ,MAAM,MAAM,SAAS,KAC/C,MAAM,mBAoGN,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,SAAU,kBAAkB,KAAG,MAAM,UAwBnE,CAAA"}

package/dist/esm/infinite-scroll.js

@@ -0,0 +1,159 @@
+import * as types from '@babel/types';
+export var getInfiniteScrollVars = function (index) { return ({
+    accumRefVar: "ds_".concat(index, "_accumRef"),
+    hasMoreFlagVar: "ds_".concat(index, "_hasMoreFlag"),
+    setHasMoreFlagVar: "setDs_".concat(index, "_hasMoreFlag"),
+    hasMoreVar: "ds_".concat(index, "_hasMore"),
+    sentinelRefVar: "ds_".concat(index, "_sentinelRef"),
+}); };
+/**
+ * The three declarations behind an appending list:
+ *
+ *   const ds_0_accumRef = useRef({ sig: '', pages: {} })
+ *   const [ds_0_hasMoreFlag, setDs_0_hasMoreFlag] = useState(true)
+ *   const ds_0_hasMore = ds_0_hasMoreFlag && (ds_0_maxPages === 0 || <page> < ds_0_maxPages)
+ *
+ * Two independent signals for "is there more", because either can be missing.
+ * `hasMoreFlag` comes from the last response being a SHORT page, which is the
+ * only end-of-data signal available from a data source that cannot count.
+ * `maxPages` comes from the count endpoint and is the one that stops a request
+ * being made at all; it is `0` while unknown, hence the explicit escape.
+ */
+export var buildInfiniteScrollDeclarations = function (vars, maxPagesVar, currentPageExpr, includeSentinel) {
+    var declarations = [
+        types.variableDeclaration('const', [
+            types.variableDeclarator(types.identifier(vars.accumRefVar), types.callExpression(types.identifier('useRef'), [
+                types.objectExpression([
+                    types.objectProperty(types.identifier('sig'), types.stringLiteral('')),
+                    types.objectProperty(types.identifier('pages'), types.objectExpression([])),
+                ]),
+            ])),
+        ]),
+        types.variableDeclaration('const', [
+            types.variableDeclarator(types.arrayPattern([
+                types.identifier(vars.hasMoreFlagVar),
+                types.identifier(vars.setHasMoreFlagVar),
+            ]), types.callExpression(types.identifier('useState'), [types.booleanLiteral(true)])),
+        ]),
+        types.variableDeclaration('const', [
+            types.variableDeclarator(types.identifier(vars.hasMoreVar), types.logicalExpression('&&', types.identifier(vars.hasMoreFlagVar), types.logicalExpression('||', types.binaryExpression('===', types.identifier(maxPagesVar), types.numericLiteral(0)), types.binaryExpression('<', types.cloneNode(currentPageExpr, true), types.identifier(maxPagesVar))))),
+        ]),
+    ];
+    if (includeSentinel) {
+        declarations.push(types.variableDeclaration('const', [
+            types.variableDeclarator(types.identifier(vars.sentinelRefVar), types.callExpression(types.identifier('useRef'), [types.nullLiteral()])),
+        ]));
+    }
+    return declarations;
+};
+/**
+ * The `.then(...)` tail that accumulates a page and reports whether more exist.
+ *
+ * Returned as the resolved value of `fetchData`, so `DataProvider` stores the
+ * whole accumulated list as its data.
+ */
+export var buildAccumulatingResponseHandler = function (vars, perPage) {
+    var accumCurrent = function () {
+        return types.memberExpression(types.identifier(vars.accumRefVar), types.identifier('current'));
+    };
+    var accumPages = function () {
+        return types.memberExpression(accumCurrent(), types.identifier('pages'));
+    };
+    return types.arrowFunctionExpression([types.identifier('response')], types.blockStatement([
+        types.variableDeclaration('const', [
+            types.variableDeclarator(types.identifier('rows'), types.logicalExpression('||', types.optionalMemberExpression(types.identifier('response'), types.identifier('data'), false, true), types.arrayExpression([]))),
+        ]),
+        types.variableDeclaration('const', [
+            types.variableDeclarator(types.identifier('page'), types.logicalExpression('||', types.callExpression(types.identifier('Number'), [
+                types.memberExpression(types.identifier('params'), types.identifier('page')),
+            ]), types.numericLiteral(1))),
+        ]),
+        // Everything that identifies the QUERY, with the page zeroed out: two
+        // fetches that differ only by page belong to the same accumulated list.
+        types.variableDeclaration('const', [
+            types.variableDeclarator(types.identifier('sig'), types.callExpression(types.memberExpression(types.identifier('JSON'), types.identifier('stringify')), [
+                types.objectExpression([
+                    types.spreadElement(types.identifier('params')),
+                    types.objectProperty(types.identifier('page'), types.numericLiteral(0)),
+                ]),
+            ])),
+        ]),
+        types.ifStatement(types.binaryExpression('!==', types.memberExpression(accumCurrent(), types.identifier('sig')), types.identifier('sig')), types.blockStatement([
+            types.expressionStatement(types.assignmentExpression('=', accumCurrent(), types.objectExpression([
+                types.objectProperty(types.identifier('sig'), types.identifier('sig'), false, true),
+                types.objectProperty(types.identifier('pages'), types.objectExpression([])),
+            ]))),
+        ])),
+        types.expressionStatement(types.assignmentExpression('=', types.memberExpression(accumPages(), types.identifier('page'), true), types.identifier('rows'))),
+        // A page that came back short is the last one. This is the only
+        // end-of-data signal a data source that cannot count ever gives.
+        types.expressionStatement(types.callExpression(types.identifier(vars.setHasMoreFlagVar), [
+            types.binaryExpression('>=', types.memberExpression(types.identifier('rows'), types.identifier('length')), types.numericLiteral(perPage)),
+        ])),
+        // Every page held so far, flattened in page order — a numeric sort, so
+        // page 10 does not land between 1 and 2. This is what DataProvider stores
+        // as its data, and so what the list renders.
+        types.returnStatement(types.callExpression(types.memberExpression(types.callExpression(types.memberExpression(types.callExpression(types.memberExpression(types.callExpression(types.memberExpression(types.identifier('Object'), types.identifier('keys')), [accumPages()]), types.identifier('map')), [types.identifier('Number')]), types.identifier('sort')), [
+            types.arrowFunctionExpression([types.identifier('a'), types.identifier('b')], types.binaryExpression('-', types.identifier('a'), types.identifier('b'))),
+        ]), types.identifier('reduce')), [
+            types.arrowFunctionExpression([types.identifier('acc'), types.identifier('p')], types.callExpression(types.memberExpression(types.identifier('acc'), types.identifier('concat')), [types.memberExpression(accumPages(), types.identifier('p'), true)])),
+            types.arrayExpression([]),
+        ])),
+    ]));
+};
+/**
+ * The IntersectionObserver that loads the next page when the sentinel scrolls
+ * into view. Emitted only in auto mode (no Load More button).
+ *
+ * `rootMargin` starts the fetch a screenful early so the list rarely shows a
+ * gap. The observer is rebuilt whenever `hasMore` or `maxPages` change and
+ * disconnected on cleanup; when there is nothing more to load the effect exits
+ * before observing, so a finished list costs nothing.
+ */
+export var buildSentinelObserverEffect = function (vars, maxPagesVar, buildAdvancePageStatement) {
+    return types.expressionStatement(types.callExpression(types.identifier('useEffect'), [
+        types.arrowFunctionExpression([], types.blockStatement([
+            types.variableDeclaration('const', [
+                types.variableDeclarator(types.identifier('el'), types.memberExpression(types.identifier(vars.sentinelRefVar), types.identifier('current'))),
+            ]),
+            // No element yet, no observer support (older browsers, jsdom), or
+            // nothing left to load.
+            types.ifStatement(types.logicalExpression('||', types.logicalExpression('||', types.unaryExpression('!', types.identifier('el'), true), types.binaryExpression('===', types.unaryExpression('typeof', types.identifier('IntersectionObserver')), types.stringLiteral('undefined'))), types.unaryExpression('!', types.identifier(vars.hasMoreVar), true)), types.returnStatement()),
+            types.variableDeclaration('const', [
+                types.variableDeclarator(types.identifier('observer'), types.newExpression(types.identifier('IntersectionObserver'), [
+                    types.arrowFunctionExpression([types.identifier('entries')], types.blockStatement([
+                        types.expressionStatement(types.callExpression(types.memberExpression(types.identifier('entries'), types.identifier('forEach')), [
+                            types.arrowFunctionExpression([types.identifier('entry')], types.blockStatement([
+                                types.ifStatement(types.unaryExpression('!', types.memberExpression(types.identifier('entry'), types.identifier('isIntersecting')), true), types.returnStatement()),
+                                buildAdvancePageStatement(),
+                            ])),
+                        ])),
+                    ])),
+                    types.objectExpression([
+                        types.objectProperty(types.identifier('rootMargin'), types.stringLiteral('200px')),
+                    ]),
+                ])),
+            ]),
+            types.expressionStatement(types.callExpression(types.memberExpression(types.identifier('observer'), types.identifier('observe')), [types.identifier('el')])),
+            types.returnStatement(types.arrowFunctionExpression([], types.callExpression(types.memberExpression(types.identifier('observer'), types.identifier('disconnect')), []))),
+        ])),
+        types.arrayExpression([types.identifier(vars.hasMoreVar), types.identifier(maxPagesVar)]),
+    ]));
+};
+/**
+ * `<div ref={ds_N_sentinelRef} aria-hidden="true" style={{ height: '1px' }} />`
+ *
+ * An invisible one-pixel row after the list. It is generated rather than
+ * authored because it is not a control — there is nothing to style or click,
+ * only a position in the document for the observer to watch.
+ */
+export var buildSentinelElement = function (vars) {
+    return types.jsxElement(types.jsxOpeningElement(types.jsxIdentifier('div'), [
+        types.jsxAttribute(types.jsxIdentifier('ref'), types.jsxExpressionContainer(types.identifier(vars.sentinelRefVar))),
+        types.jsxAttribute(types.jsxIdentifier('aria-hidden'), types.stringLiteral('true')),
+        types.jsxAttribute(types.jsxIdentifier('style'), types.jsxExpressionContainer(types.objectExpression([
+            types.objectProperty(types.identifier('height'), types.stringLiteral('1px')),
+        ]))),
+    ], true), null, [], true);
+};
+//# sourceMappingURL=infinite-scroll.js.map

package/dist/esm/infinite-scroll.js.map

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

package/dist/esm/numbered-pagination.d.ts

@@ -0,0 +1,42 @@
+import * as types from '@babel/types';
+/**
+ * Numbered pagination: First / Prev / 1 … 4 5 6 … 12 / Next / Last.
+ *
+ * The builder authors ONE page-number button and a container to repeat it into;
+ * this module turns that template into a `.map` over a windowed token list, so
+ * every number the visitor sees is the author's own styled node rather than
+ * something the generator invented.
+ */
+/** `ds_N_pageTokens` — the windowed list of page numbers and ellipsis markers. */
+export declare const getPageTokensVar: (index: number) => string;
+/**
+ * Builds the `useMemo` that decides which page numbers are visible.
+ *
+ * The window is deliberately small and fixed (first, last, and one neighbour
+ * either side of the current page, so at most seven entries): an unbounded
+ * strip is unusable at 300 pages and wraps the layout the author styled. The
+ * two ellipsis markers are distinct strings because React needs unique keys and
+ * a list can legitimately need a gap on both sides.
+ *
+ * ⛔ Keep this in step with `computePageWindow` in the editor's renderer — the
+ * canvas and the published page must agree on which numbers are shown, or the
+ * author styles a strip they will never see.
+ */
+export declare const buildPageTokensDeclaration: (index: number, maxPagesVar: string, currentPageExpr: types.Expression) => types.VariableDeclaration;
+export interface NumberedPaginationVars {
+    index: number;
+    maxPagesVar: string;
+    /** How this usage reads its current page (`ds_N_state.page` or `ds_N_page`). */
+    currentPageExpr: () => types.Expression;
+    /** How it writes a page number back. */
+    buildSetPageStatement: (pageExpr: types.Expression) => types.Expression;
+}
+/**
+ * Wires the First / Last buttons and expands the page-number template.
+ *
+ * Prev / Next are left to `wirePaginationButtons`, which already emits them and
+ * whose output must stay byte-identical for every project that never switches
+ * mode.
+ */
+export declare const wireNumberedPagination: (paginationNode: any, vars: NumberedPaginationVars) => void;
+//# sourceMappingURL=numbered-pagination.d.ts.map

package/dist/esm/numbered-pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbered-pagination.d.ts","sourceRoot":"","sources":["../../src/numbered-pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAOrC;;;;;;;GAOG;AAIH,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,MAAkC,CAAA;AAEnF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,UAC9B,MAAM,eACA,MAAM,mBACF,MAAM,UAAU,KAChC,MAAM,mBA2GR,CAAA;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,eAAe,EAAE,MAAM,KAAK,CAAC,UAAU,CAAA;IACvC,wCAAwC;IACxC,qBAAqB,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CAAA;CACxE;AAQD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,mBAAoB,GAAG,QAAQ,sBAAsB,KAAG,IA0H1F,CAAA"}

package/dist/esm/numbered-pagination.js

@@ -0,0 +1,138 @@
+import * as types from '@babel/types';
+import { convertControlToButton, findPaginationControl, setJSXExpressionAttribute, } from './pagination-controls';
+/**
+ * Numbered pagination: First / Prev / 1 … 4 5 6 … 12 / Next / Last.
+ *
+ * The builder authors ONE page-number button and a container to repeat it into;
+ * this module turns that template into a `.map` over a windowed token list, so
+ * every number the visitor sees is the author's own styled node rather than
+ * something the generator invented.
+ */
+// tslint:disable:no-any
+/** `ds_N_pageTokens` — the windowed list of page numbers and ellipsis markers. */
+export var getPageTokensVar = function (index) { return "ds_".concat(index, "_pageTokens"); };
+/**
+ * Builds the `useMemo` that decides which page numbers are visible.
+ *
+ * The window is deliberately small and fixed (first, last, and one neighbour
+ * either side of the current page, so at most seven entries): an unbounded
+ * strip is unusable at 300 pages and wraps the layout the author styled. The
+ * two ellipsis markers are distinct strings because React needs unique keys and
+ * a list can legitimately need a gap on both sides.
+ *
+ * ⛔ Keep this in step with `computePageWindow` in the editor's renderer — the
+ * canvas and the published page must agree on which numbers are shown, or the
+ * author styles a strip they will never see.
+ */
+export var buildPageTokensDeclaration = function (index, maxPagesVar, currentPageExpr) {
+    var total = types.identifier('total');
+    var current = types.identifier('current');
+    var tokens = types.identifier('tokens');
+    var start = types.identifier('start');
+    var end = types.identifier('end');
+    var pageVar = types.identifier('p');
+    var body = types.blockStatement([
+        types.variableDeclaration('const', [
+            types.variableDeclarator(total, types.identifier(maxPagesVar)),
+        ]),
+        types.variableDeclaration('const', [
+            types.variableDeclarator(current, types.cloneNode(currentPageExpr, true)),
+        ]),
+        // Nothing matched at all — the empty branch of the list is what renders.
+        types.ifStatement(types.binaryExpression('<=', types.cloneNode(total, true), types.numericLiteral(0)), types.returnStatement(types.arrayExpression([]))),
+        types.ifStatement(types.binaryExpression('===', types.cloneNode(total, true), types.numericLiteral(1)), types.returnStatement(types.arrayExpression([types.numericLiteral(1)]))),
+        types.variableDeclaration('const', [
+            types.variableDeclarator(tokens, types.arrayExpression([types.numericLiteral(1)])),
+        ]),
+        types.variableDeclaration('const', [
+            types.variableDeclarator(start, types.callExpression(types.memberExpression(types.identifier('Math'), types.identifier('max')), [
+                types.numericLiteral(2),
+                types.binaryExpression('-', types.cloneNode(current, true), types.numericLiteral(1)),
+            ])),
+        ]),
+        types.variableDeclaration('const', [
+            types.variableDeclarator(end, types.callExpression(types.memberExpression(types.identifier('Math'), types.identifier('min')), [
+                types.binaryExpression('-', types.cloneNode(total, true), types.numericLiteral(1)),
+                types.binaryExpression('+', types.cloneNode(current, true), types.numericLiteral(1)),
+            ])),
+        ]),
+        types.ifStatement(types.binaryExpression('>', types.cloneNode(start, true), types.numericLiteral(2)), types.expressionStatement(types.callExpression(types.memberExpression(types.cloneNode(tokens, true), types.identifier('push')), [types.stringLiteral('start-ellipsis')]))),
+        types.forStatement(types.variableDeclaration('let', [
+            types.variableDeclarator(pageVar, types.cloneNode(start, true)),
+        ]), types.binaryExpression('<=', types.cloneNode(pageVar, true), types.cloneNode(end, true)), types.assignmentExpression('+=', types.cloneNode(pageVar, true), types.numericLiteral(1)), types.expressionStatement(types.callExpression(types.memberExpression(types.cloneNode(tokens, true), types.identifier('push')), [types.cloneNode(pageVar, true)]))),
+        types.ifStatement(types.binaryExpression('<', types.cloneNode(end, true), types.binaryExpression('-', types.cloneNode(total, true), types.numericLiteral(1))), types.expressionStatement(types.callExpression(types.memberExpression(types.cloneNode(tokens, true), types.identifier('push')), [types.stringLiteral('end-ellipsis')]))),
+        types.expressionStatement(types.callExpression(types.memberExpression(types.cloneNode(tokens, true), types.identifier('push')), [types.cloneNode(total, true)])),
+        types.returnStatement(types.cloneNode(tokens, true)),
+    ]);
+    return types.variableDeclaration('const', [
+        types.variableDeclarator(types.identifier(getPageTokensVar(index)), types.callExpression(types.identifier('useMemo'), [
+            types.arrowFunctionExpression([], body),
+            types.arrayExpression([
+                types.identifier(maxPagesVar),
+                types.cloneNode(currentPageExpr, true),
+            ]),
+        ])),
+    ]);
+};
+/** `<setter>(<page>)` wrapped so an already-current page does not re-render. */
+var buildJumpHandler = function (vars, targetExpr) { return types.arrowFunctionExpression([], vars.buildSetPageStatement(targetExpr)); };
+/**
+ * Wires the First / Last buttons and expands the page-number template.
+ *
+ * Prev / Next are left to `wirePaginationButtons`, which already emits them and
+ * whose output must stay byte-identical for every project that never switches
+ * mode.
+ */
+export var wireNumberedPagination = function (paginationNode, vars) {
+    var firstButton = findPaginationControl(paginationNode, 'first');
+    var lastButton = findPaginationControl(paginationNode, 'last');
+    var pagesContainer = findPaginationControl(paginationNode, 'pages');
+    if (firstButton) {
+        convertControlToButton(firstButton);
+        setJSXExpressionAttribute(firstButton, 'onClick', buildJumpHandler(vars, types.numericLiteral(1)));
+        setJSXExpressionAttribute(firstButton, 'disabled', types.binaryExpression('<=', vars.currentPageExpr(), types.numericLiteral(1)));
+    }
+    if (lastButton) {
+        convertControlToButton(lastButton);
+        setJSXExpressionAttribute(lastButton, 'onClick', buildJumpHandler(vars, types.identifier(vars.maxPagesVar)));
+        // `maxPages === 0` is "no results", where jumping to the last page would
+        // mean jumping to page 0.
+        setJSXExpressionAttribute(lastButton, 'disabled', types.logicalExpression('||', types.binaryExpression('===', types.identifier(vars.maxPagesVar), types.numericLiteral(0)), types.binaryExpression('>=', vars.currentPageExpr(), types.identifier(vars.maxPagesVar))));
+    }
+    if (!pagesContainer) {
+        return;
+    }
+    var template = findPaginationControl(pagesContainer, 'page');
+    if (!template) {
+        // A container with no template to repeat: leave whatever the author put
+        // there alone rather than inventing an unstyled strip.
+        return;
+    }
+    var ellipsisTemplate = findPaginationControl(pagesContainer, 'ellipsis');
+    var tokenId = types.identifier('token');
+    // The author's own button, cloned per visible page: their class name (and so
+    // every style they applied) rides along.
+    var numberButton = types.cloneNode(template, true);
+    convertControlToButton(numberButton);
+    setJSXExpressionAttribute(numberButton, 'onClick', buildJumpHandler(vars, types.cloneNode(tokenId, true)));
+    // The current page is marked, not disabled: `[aria-current='page']` is
+    // styleable and keeps the button reachable for screen readers.
+    setJSXExpressionAttribute(numberButton, 'aria-current', types.conditionalExpression(types.binaryExpression('===', vars.currentPageExpr(), types.cloneNode(tokenId, true)), types.stringLiteral('page'), types.identifier('undefined')));
+    setJSXExpressionAttribute(numberButton, 'key', types.templateLiteral([
+        types.templateElement({ raw: 'page-', cooked: 'page-' }),
+        types.templateElement({ raw: '', cooked: '' }, true),
+    ], [types.cloneNode(tokenId, true)]));
+    // Whatever label the template carried ('1') is replaced by the real number.
+    numberButton.children = [types.jsxExpressionContainer(types.cloneNode(tokenId, true))];
+    var gapNode = ellipsisTemplate
+        ? types.cloneNode(ellipsisTemplate, true)
+        : types.jsxElement(types.jsxOpeningElement(types.jsxIdentifier('span'), [], false), types.jsxClosingElement(types.jsxIdentifier('span')), [types.jsxText('…')], false);
+    setJSXExpressionAttribute(gapNode, 'key', types.cloneNode(tokenId, true));
+    // {ds_N_pageTokens.map(token => typeof token === 'number' ? <button…> : <span…>)}
+    pagesContainer.children = [
+        types.jsxExpressionContainer(types.callExpression(types.memberExpression(types.identifier(getPageTokensVar(vars.index)), types.identifier('map')), [
+            types.arrowFunctionExpression([types.cloneNode(tokenId, true)], types.conditionalExpression(types.binaryExpression('===', types.unaryExpression('typeof', types.cloneNode(tokenId, true)), types.stringLiteral('number')), numberButton, gapNode)),
+        ])),
+    ];
+};
+//# sourceMappingURL=numbered-pagination.js.map

package/dist/esm/numbered-pagination.js.map

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

package/dist/esm/page-reset.d.ts

@@ -0,0 +1,42 @@
+import * as types from '@babel/types';
+/**
+ * Resetting a paginated list back to page 1 when its FILTER or SORT changes.
+ *
+ * Without this a visitor on page 5 who picks a category with twelve results
+ * fetches page 5 of twelve rows and is shown an empty grid, with only
+ * "Previous" to get out of it. The search input never had this bug: its
+ * debounce effect REPLACES the whole `{ page, debouncedQuery }` state, and so
+ * has always dropped the page back to 1 as a side effect.
+ *
+ * ⛔ Why the guard is a signature and not the usual `useRef(true)` skip-first:
+ * URL-driven dependencies (`router.query.categoryFilter`) are `undefined` on
+ * the first render and only take their real value once the router hydrates.
+ * A skip-first guard would treat that hydration as a change and reset the page
+ * of a deep link like `?page=3&categoryFilter=Rings` back to 1 — the very
+ * sharing case the page-in-URL feature exists to support. Comparing a
+ * serialised signature instead means the first OBSERVED value is recorded
+ * rather than acted on, whatever render it arrives in, and any later genuine
+ * change resets exactly once.
+ */
+export interface PageResetDeps {
+    /** Bare identifiers: state-bound filter destinations and dynamic-sort deps. */
+    stateIds: string[];
+    /** Emitted as `props.<id>` — props are never destructured into scope. */
+    propIds: string[];
+    /** Emitted as `router.query.<key>`. */
+    urlSearchParamKeys: string[];
+}
+/** True when there is nothing that could ever change the filtering of this list. */
+export declare const hasNoPageResetDeps: (deps: PageResetDeps) => boolean;
+/**
+ * Builds the reset effect.
+ *
+ * @param refVar          name of the `useRef` holding the last seen signature
+ * @param buildResetStatement  how this usage writes page 1 — the combined
+ *                        `{ page, debouncedQuery }` state and the standalone
+ *                        page state need different setters
+ */
+export declare const buildFilterSortPageResetEffect: (refVar: string, deps: PageResetDeps, buildResetStatement: () => types.Statement) => types.ExpressionStatement;
+/** `const <refVar> = useRef(null)` — the signature store for the effect above. */
+export declare const buildPageResetRefDeclaration: (refVar: string) => types.VariableDeclaration;
+//# sourceMappingURL=page-reset.d.ts.map

package/dist/esm/page-reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-reset.d.ts","sourceRoot":"","sources":["../../src/page-reset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,uCAAuC;IACvC,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAC7B;AAED,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,SAAU,aAAa,KAAG,OACwC,CAAA;AAuCjG;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,WACjC,MAAM,QACR,aAAa,uBACE,MAAM,MAAM,SAAS,KACzC,MAAM,mBAoER,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,WAAY,MAAM,KAAG,MAAM,mBAMhE,CAAA"}

package/dist/esm/page-reset.js

@@ -0,0 +1,87 @@
+import * as types from '@babel/types';
+/** True when there is nothing that could ever change the filtering of this list. */
+export var hasNoPageResetDeps = function (deps) {
+    return deps.stateIds.length === 0 && deps.propIds.length === 0 && deps.urlSearchParamKeys.length === 0;
+};
+var routerQueryAccess = function (key) {
+    return types.memberExpression(types.memberExpression(types.identifier('router'), types.identifier('query')), types.identifier(key));
+};
+/**
+ * The expressions the effect both depends on and hashes into its signature.
+ *
+ * Kept in one place so the two can never drift: a value in the signature but
+ * not the deps would be read stale, and one in the deps but not the signature
+ * would re-run the effect without being able to explain why it changed.
+ */
+var buildTrackedExpressions = function (deps) {
+    var tracked = [];
+    var seen = new Set();
+    for (var _i = 0, _a = deps.stateIds; _i < _a.length; _i++) {
+        var id = _a[_i];
+        if (seen.has(id)) {
+            continue;
+        }
+        seen.add(id);
+        tracked.push(types.identifier(id));
+    }
+    for (var _b = 0, _c = deps.propIds; _b < _c.length; _b++) {
+        var id = _c[_b];
+        var key = "props.".concat(id);
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        tracked.push(types.memberExpression(types.identifier('props'), types.identifier(id)));
+    }
+    for (var _d = 0, _e = deps.urlSearchParamKeys; _d < _e.length; _d++) {
+        var key = _e[_d];
+        tracked.push(routerQueryAccess(key));
+    }
+    return tracked;
+};
+/**
+ * Builds the reset effect.
+ *
+ * @param refVar          name of the `useRef` holding the last seen signature
+ * @param buildResetStatement  how this usage writes page 1 — the combined
+ *                        `{ page, debouncedQuery }` state and the standalone
+ *                        page state need different setters
+ */
+export var buildFilterSortPageResetEffect = function (refVar, deps, buildResetStatement) {
+    var body = [];
+    var hasRouterDeps = deps.urlSearchParamKeys.length > 0;
+    // Reading `router.query` before the router is ready would hash `undefined`
+    // for every URL-driven filter and record a signature that is about to change
+    // on its own.
+    if (hasRouterDeps) {
+        body.push(types.ifStatement(types.unaryExpression('!', types.memberExpression(types.identifier('router'), types.identifier('isReady')), true), types.returnStatement()));
+    }
+    var refCurrent = types.memberExpression(types.identifier(refVar), types.identifier('current'));
+    // `?? null` so a missing URL param serialises as `null` rather than dropping
+    // out of the array and shifting every later entry.
+    var signatureEntries = buildTrackedExpressions(deps).map(function (expr) {
+        return expr.type === 'MemberExpression' && expr.object.type === 'MemberExpression'
+            ? types.logicalExpression('??', expr, types.nullLiteral())
+            : expr;
+    });
+    body.push(types.variableDeclaration('const', [
+        types.variableDeclarator(types.identifier('__sig'), types.callExpression(types.memberExpression(types.identifier('JSON'), types.identifier('stringify')), [types.arrayExpression(signatureEntries)])),
+    ]), types.ifStatement(types.binaryExpression('===', types.cloneNode(refCurrent, true), types.identifier('__sig')), types.returnStatement()), types.variableDeclaration('const', [
+        types.variableDeclarator(types.identifier('__first'), types.binaryExpression('===', types.cloneNode(refCurrent, true), types.nullLiteral())),
+    ]), types.expressionStatement(types.assignmentExpression('=', types.cloneNode(refCurrent, true), types.identifier('__sig'))), types.ifStatement(types.identifier('__first'), types.returnStatement()), buildResetStatement());
+    var effectDeps = buildTrackedExpressions(deps);
+    if (hasRouterDeps) {
+        effectDeps.push(types.memberExpression(types.identifier('router'), types.identifier('isReady')));
+    }
+    return types.expressionStatement(types.callExpression(types.identifier('useEffect'), [
+        types.arrowFunctionExpression([], types.blockStatement(body)),
+        types.arrayExpression(effectDeps),
+    ]));
+};
+/** `const <refVar> = useRef(null)` — the signature store for the effect above. */
+export var buildPageResetRefDeclaration = function (refVar) {
+    return types.variableDeclaration('const', [
+        types.variableDeclarator(types.identifier(refVar), types.callExpression(types.identifier('useRef'), [types.nullLiteral()])),
+    ]);
+};
+//# sourceMappingURL=page-reset.js.map

package/dist/esm/page-reset.js.map

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