@aglyn/aglyn 1.0.0-beta.146 → 1.0.0-beta.149

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/aglyn",
-  "version": "1.0.0-beta.146",
+  "version": "1.0.0-beta.149",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -33,15 +33,15 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/shared-data-enums": "1.0.0-beta.146",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.146",
-    "@aglyn/shared-data-types": "1.0.0-beta.146",
-    "@aglyn/shared-util-email": "1.0.0-beta.146",
-    "@aglyn/shared-util-http": "1.0.0-beta.146",
-    "@aglyn/shared-util-logger": "1.0.0-beta.146",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.146",
-    "@aglyn/shared-util-tools": "1.0.0-beta.146",
-    "@aglyn/shared-util-vendor": "1.0.0-beta.146",
+    "@aglyn/shared-data-enums": "1.0.0-beta.149",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.149",
+    "@aglyn/shared-data-types": "1.0.0-beta.149",
+    "@aglyn/shared-util-email": "1.0.0-beta.149",
+    "@aglyn/shared-util-http": "1.0.0-beta.149",
+    "@aglyn/shared-util-logger": "1.0.0-beta.149",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.149",
+    "@aglyn/shared-util-tools": "1.0.0-beta.149",
+    "@aglyn/shared-util-vendor": "1.0.0-beta.149",
     "@data-driven-forms/react-form-renderer": "^4.2.0",
     "@msgpack/msgpack": "^3.1.3",
     "@types/unist": "^3.0.3",

package/src/lib/app-utils/binding-token-catalog.js

@@ -177,7 +177,11 @@ import { humanizeDatasetFieldId } from "./datasets.js";
     {
         token: '{{pagination.totalPages}}',
         label: 'Total pages',
-        description: 'Pages in the listing, after any category filter.'
+        // A listing bigger than one read cannot be counted honestly (AGL-3219):
+        // the count and the entries were read at two different moments, and the
+        // pager built from them disagreed with itself at the page boundary. It
+        // still resolves, so a template binding it keeps rendering.
+        description: 'Pages in the listing, after any category filter. Empty on a listing too large to count — bind the next link instead.'
     },
     {
         token: '{{pagination.prevUrl}}',
@@ -187,7 +191,10 @@ import { humanizeDatasetFieldId } from "./datasets.js";
     {
         token: '{{pagination.nextUrl}}',
         label: 'Next page link',
-        description: 'Keeps the category; empty on the last page.'
+        // The reliable "is there more" (AGL-3219): it is set from a read that
+        // asked for one entry more than the page needed, so empty means there was
+        // no such entry rather than that a total said so.
+        description: 'Keeps the category; empty when there is nothing older to show.'
     }
 ];
 /**

package/src/lib/app-utils/binding-token-catalog.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/binding-token-catalog.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  DATASET_FIELD_TYPE_LABELS,\n  type DatasetModel,\n} from './dataset-models'\nimport { humanizeDatasetFieldId } from './datasets'\n\n/**\n * Browsable data-placeholder catalogs for the designer's insert picker\n * (AGL-583). Hand-typing `{{entry.title}}` stays the advanced path; these\n * catalogs give every token a friendly label + description so editors can\n * browse and insert instead of memorizing the grammar.\n *\n * The token STRINGS are owned elsewhere — `collectionEntryTokens`\n * (collection-entries.ts) and the tenant compose pipeline resolve them —\n * this module only names them for pickers. The spec cross-checks the entry\n * catalog against the resolver so the two can never drift.\n */\nexport interface BindingTokenCatalogEntry {\n  /** The literal token inserted into the prop, e.g. `{{entry.title}}`. */\n  token: string\n  /** Friendly picker label, e.g. `Title`. */\n  label: string\n  /** One-line description shown as the option's secondary text. */\n  description?: string\n}\n\n/**\n * `{{entry.*}}` tokens (AGL-105/551/582) — resolve per entry inside a\n * Collection entries block and page-wide on entry-template screens.\n * Mirrors {@link collectionEntryTokens}; the spec enforces the mirror.\n */\nexport const ENTRY_TOKEN_CATALOG: readonly BindingTokenCatalogEntry[] = [\n  { token: '{{entry.title}}', label: 'Title', description: 'The entry headline.' },\n  {\n    token: '{{entry.excerpt}}',\n    label: 'Excerpt',\n    description: 'Short summary text.',\n  },\n  {\n    token: '{{entry.body}}',\n    label: 'Body',\n    description: 'The full entry body.',\n  },\n  {\n    token: '{{entry.url}}',\n    label: 'Link URL',\n    description: 'Auto-route to the entry page.',\n  },\n  {\n    token: '{{entry.date}}',\n    label: 'Published date',\n    description: 'Formatted publish date.',\n  },\n  /*\n    Beside the readable date on purpose: a designer reaching for \"the date\" in\n    a Video element's Publication date field has to see that the readable one\n    is the wrong pick there, and why.\n  */\n  {\n    token: '{{entry.publishedAt}}',\n    label: 'Publish timestamp',\n    description:\n      'The publish date and time in ISO 8601, for a field that needs a ' +\n      'machine-readable date, such as a Video element’s publication date.',\n  },\n  {\n    token: '{{entry.author}}',\n    label: 'Author',\n    description: 'The byline set on the entry.',\n  },\n  {\n    token: '{{entry.authorBio}}',\n    label: 'Author bio',\n    description: 'Blurb from the author’s record.',\n  },\n  {\n    token: '{{entry.authorImage}}',\n    label: 'Author portrait',\n    description: 'Portrait or logo from the author’s record.',\n  },\n  {\n    token: '{{entry.authorUrl}}',\n    label: 'Author link',\n    description: 'The author’s own page.',\n  },\n  {\n    token: '{{entry.authorPageUrl}}',\n    label: 'Author page',\n    description:\n      'This author’s page on this site — everything they wrote, across every ' +\n      'collection. Separate from Author link, which is their own site.',\n  },\n  {\n    token: '{{entry.slug}}',\n    label: 'Slug',\n    description: 'URL-safe entry identifier.',\n  },\n  /*\n    Named \"Its collection…\" rather than \"Collection…\", which is what these\n    describe and also exactly what the `{{collection.*}}` entries below are\n    called. The picker groups options by heading, so the two sets sit apart —\n    but a designer scanning it reads the LABEL, and two options reading\n    \"Collection name\" three lines apart is a choice made by guessing. The\n    pronoun is doing real work: on the one page where both resolve, they mean\n    different collections.\n  */\n  {\n    token: '{{entry.collection}}',\n    label: 'Its collection',\n    description:\n      'Which section this entry belongs to. Worth binding on a listing that ' +\n      'MIXES collections — an author page — where a card otherwise cannot ' +\n      'tell a release note from an essay.',\n  },\n  {\n    token: '{{entry.collectionSlug}}',\n    label: 'Its collection slug',\n    description: 'That collection’s URL segment.',\n  },\n  {\n    token: '{{entry.collectionUrl}}',\n    label: 'Its collection link',\n    description: 'The listing this entry belongs to.',\n  },\n  {\n    token: '{{entry.coverImage}}',\n    label: 'Cover image',\n    description: 'Cover image URL.',\n  },\n  {\n    token: '{{entry.coverVideo}}',\n    label: 'Featured video',\n    description:\n      'The featured video’s source — a library film, a video link or a ' +\n      'Wistia link — for a Video element.',\n  },\n  {\n    token: '{{entry.category}}',\n    label: 'Category',\n    description: 'The entry category.',\n  },\n  {\n    token: '{{entry.tags}}',\n    label: 'Tags',\n    description: 'Tags, comma separated.',\n  },\n  {\n    token: '{{entry.seoTitle}}',\n    label: 'SEO title',\n    description: 'Search title; falls back to Title.',\n  },\n  {\n    token: '{{entry.seoDescription}}',\n    label: 'SEO description',\n    description: 'Meta description; falls back to Excerpt.',\n  },\n]\n\n/**\n * `{{collection.*}}` and `{{pagination.*}}` tokens (AGL-551/1321/1386) —\n * resolve on collection list/entry template screens (see the tenant compose\n * pipeline's collection tokens).\n *\n * The category and pagination tokens all resolve to the empty string where\n * they do not apply, so they are safe to bind unconditionally: ONE list\n * screen serves the bare listing, every `/page/{n}` and every\n * `/category/{slug}`, and a template has no runtime conditional to vary\n * itself with.\n */\nexport const COLLECTION_TOKEN_CATALOG: readonly BindingTokenCatalogEntry[] = [\n  {\n    token: '{{collection.name}}',\n    label: 'Collection name',\n    description: 'Display name of the routed collection.',\n  },\n  {\n    token: '{{collection.slug}}',\n    label: 'Collection slug',\n    description: 'URL slug of the routed collection.',\n  },\n  {\n    token: '{{collection.category}}',\n    label: 'Filtered category',\n    description: 'Category the URL filtered on; empty when unfiltered.',\n  },\n  {\n    token: '{{collection.categorySlug}}',\n    label: 'Filtered category slug',\n    description: 'That category’s URL segment; empty when unfiltered.',\n  },\n  {\n    token: '{{pagination.page}}',\n    label: 'Current page',\n    description: 'Page number this URL is showing.',\n  },\n  {\n    token: '{{pagination.totalPages}}',\n    label: 'Total pages',\n    description: 'Pages in the listing, after any category filter.',\n  },\n  {\n    token: '{{pagination.prevUrl}}',\n    label: 'Previous page link',\n    description: 'Keeps the category; empty on the first page.',\n  },\n  {\n    token: '{{pagination.nextUrl}}',\n    label: 'Next page link',\n    description: 'Keeps the category; empty on the last page.',\n  },\n]\n\n/**\n * `{{author.*}}` tokens (AGL-2518) — resolve on an author's own page,\n * `/author/{slug}`.\n *\n * Empty everywhere else, like the category tokens above and for the same\n * reason: a template has no runtime conditional, so the tokens have to be the\n * thing that varies. A heading bound to `{{author.name}}` prints a name on an\n * author page and nothing anywhere else.\n *\n * The `{{pagination.*}}` tokens resolve HERE TOO, over this author's own\n * archive — deliberately the same four names a collection listing uses, so a\n * pager built once works on both.\n */\nexport const AUTHOR_TOKEN_CATALOG: readonly BindingTokenCatalogEntry[] = [\n  {\n    token: '{{author.name}}',\n    label: 'Name',\n    description: 'The byline this page collects.',\n  },\n  {\n    token: '{{author.bio}}',\n    label: 'Bio',\n    description: 'Their blurb, from the author record.',\n  },\n  {\n    token: '{{author.image}}',\n    label: 'Portrait',\n    description: 'Their portrait or logo, from the author record.',\n  },\n  {\n    token: '{{author.jobTitle}}',\n    label: 'Role',\n    description: 'Their job title; empty for an Organization author.',\n  },\n  {\n    token: '{{author.worksFor}}',\n    label: 'Organization',\n    description: 'Who they write for; empty for an Organization author.',\n  },\n  {\n    token: '{{author.url}}',\n    label: 'Their own site',\n    description:\n      'The url on their record — a personal site, not this page. Empty when ' +\n      'they have none.',\n  },\n  {\n    token: '{{author.pageUrl}}',\n    label: 'This page',\n    description: 'The canonical address of the page you are designing.',\n  },\n  {\n    token: '{{author.entryCount}}',\n    label: 'Post count',\n    description: 'How many entries they have published, across every collection.',\n  },\n  {\n    token: '{{author.entryCountLabel}}',\n    label: 'Post count, worded',\n    description:\n      '\"1 post\" or \"12 posts\" — pluralized for you, because a template has no ' +\n      'conditional to do it with.',\n  },\n]\n\n/**\n * Renders an `{{item.*}}` token for a dataset field, optionally hopping\n * one reference to a field of the referenced record (AGL-180). Always\n * takes the stable model field ID — display names are labels only.\n */\nexport function datasetItemToken(\n  fieldId: string,\n  targetFieldId?: string,\n): string {\n  return targetFieldId\n    ? `{{item.${fieldId}.${targetFieldId}}}`\n    : `{{item.${fieldId}}}`\n}\n\n/**\n * Dataset-item token entries for a repeatable container's model: one per\n * field in model order, labeled with the CURRENT display name while the\n * token carries the stable reference id (AGL-578 — renaming a label never\n * breaks bindings). Reference fields with a configured display field also\n * get their one-hop token (`{{item.author.name}}`).\n */\nexport function datasetItemTokens(\n  model: DatasetModel,\n): BindingTokenCatalogEntry[] {\n  const entries: BindingTokenCatalogEntry[] = []\n  for (const fieldId of model.order ?? []) {\n    const field = model.fields?.[fieldId]\n    if (!field) continue\n    const label = field.name?.trim() || humanizeDatasetFieldId(fieldId)\n    entries.push({\n      token: datasetItemToken(fieldId),\n      label,\n      description: DATASET_FIELD_TYPE_LABELS[field.type] ?? field.type,\n    })\n    // One reference hop (AGL-180): surface the configured display field of\n    // the referenced record — the hop editors reach for most.\n    const hopId =\n      field.type === 'reference' ? field.reference?.displayFieldId : undefined\n    if (hopId) {\n      entries.push({\n        token: datasetItemToken(fieldId, hopId),\n        label: `${label} → ${humanizeDatasetFieldId(hopId)}`,\n        description: 'Field from the referenced record.',\n      })\n    }\n  }\n  return entries\n}\n"],"names":["DATASET_FIELD_TYPE_LABELS","humanizeDatasetFieldId","ENTRY_TOKEN_CATALOG","token","label","description","COLLECTION_TOKEN_CATALOG","AUTHOR_TOKEN_CATALOG","datasetItemToken","fieldId","targetFieldId","datasetItemTokens","model","entries","order","field","fields","name","trim","push","type","hopId","reference","displayFieldId","undefined"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,yBAAyB,QAEpB,sBAAkB;AACzB,SAASC,sBAAsB,QAAQ,gBAAY;AAsBnD;;;;CAIC,GACD,OAAO,MAAMC,sBAA2D;IACtE;QAAEC,OAAO;QAAmBC,OAAO;QAASC,aAAa;IAAsB;IAC/E;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;;;;EAIA,GACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,qEACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,2EACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;;;;;;;;EAQA,GACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,0EACA,wEACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,qEACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;CACD,CAAA;AAED;;;;;;;;;;CAUC,GACD,OAAO,MAAMC,2BAAgE;IAC3E;QACEH,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;CACD,CAAA;AAED;;;;;;;;;;;;CAYC,GACD,OAAO,MAAME,uBAA4D;IACvE;QACEJ,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,0EACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,4EACA;IACJ;CACD,CAAA;AAED;;;;CAIC,GACD,OAAO,SAASG,iBACdC,OAAe,EACfC,aAAsB;IAEtB,OAAOA,gBACH,CAAC,OAAO,EAAED,QAAQ,CAAC,EAAEC,cAAc,EAAE,CAAC,GACtC,CAAC,OAAO,EAAED,QAAQ,EAAE,CAAC;AAC3B;AAEA;;;;;;CAMC,GACD,OAAO,SAASE,kBACdC,KAAmB;QAGGA;IADtB,MAAMC,UAAsC,EAAE;IAC9C,KAAK,MAAMJ,YAAWG,eAAAA,MAAME,KAAK,YAAXF,eAAe,EAAE,CAAE;YAOxBZ;YANDY,eAEAG,aASiBA;QAX/B,MAAMA,SAAQH,gBAAAA,MAAMI,MAAM,qBAAZJ,aAAc,CAACH,QAAQ;QACrC,IAAI,CAACM,OAAO;QACZ,MAAMX,QAAQW,EAAAA,cAAAA,MAAME,IAAI,qBAAVF,YAAYG,IAAI,OAAMjB,uBAAuBQ;QAC3DI,QAAQM,IAAI,CAAC;YACXhB,OAAOK,iBAAiBC;YACxBL;YACAC,WAAW,GAAEL,wCAAAA,yBAAyB,CAACe,MAAMK,IAAI,CAAC,YAArCpB,wCAAyCe,MAAMK,IAAI;QAClE;QACA,uEAAuE;QACvE,0DAA0D;QAC1D,MAAMC,QACJN,MAAMK,IAAI,KAAK,eAAcL,mBAAAA,MAAMO,SAAS,qBAAfP,iBAAiBQ,cAAc,GAAGC;QACjE,IAAIH,OAAO;YACTR,QAAQM,IAAI,CAAC;gBACXhB,OAAOK,iBAAiBC,SAASY;gBACjCjB,OAAO,GAAGA,MAAM,GAAG,EAAEH,uBAAuBoB,QAAQ;gBACpDhB,aAAa;YACf;QACF;IACF;IACA,OAAOQ;AACT"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/binding-token-catalog.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  DATASET_FIELD_TYPE_LABELS,\n  type DatasetModel,\n} from './dataset-models'\nimport { humanizeDatasetFieldId } from './datasets'\n\n/**\n * Browsable data-placeholder catalogs for the designer's insert picker\n * (AGL-583). Hand-typing `{{entry.title}}` stays the advanced path; these\n * catalogs give every token a friendly label + description so editors can\n * browse and insert instead of memorizing the grammar.\n *\n * The token STRINGS are owned elsewhere — `collectionEntryTokens`\n * (collection-entries.ts) and the tenant compose pipeline resolve them —\n * this module only names them for pickers. The spec cross-checks the entry\n * catalog against the resolver so the two can never drift.\n */\nexport interface BindingTokenCatalogEntry {\n  /** The literal token inserted into the prop, e.g. `{{entry.title}}`. */\n  token: string\n  /** Friendly picker label, e.g. `Title`. */\n  label: string\n  /** One-line description shown as the option's secondary text. */\n  description?: string\n}\n\n/**\n * `{{entry.*}}` tokens (AGL-105/551/582) — resolve per entry inside a\n * Collection entries block and page-wide on entry-template screens.\n * Mirrors {@link collectionEntryTokens}; the spec enforces the mirror.\n */\nexport const ENTRY_TOKEN_CATALOG: readonly BindingTokenCatalogEntry[] = [\n  { token: '{{entry.title}}', label: 'Title', description: 'The entry headline.' },\n  {\n    token: '{{entry.excerpt}}',\n    label: 'Excerpt',\n    description: 'Short summary text.',\n  },\n  {\n    token: '{{entry.body}}',\n    label: 'Body',\n    description: 'The full entry body.',\n  },\n  {\n    token: '{{entry.url}}',\n    label: 'Link URL',\n    description: 'Auto-route to the entry page.',\n  },\n  {\n    token: '{{entry.date}}',\n    label: 'Published date',\n    description: 'Formatted publish date.',\n  },\n  /*\n    Beside the readable date on purpose: a designer reaching for \"the date\" in\n    a Video element's Publication date field has to see that the readable one\n    is the wrong pick there, and why.\n  */\n  {\n    token: '{{entry.publishedAt}}',\n    label: 'Publish timestamp',\n    description:\n      'The publish date and time in ISO 8601, for a field that needs a ' +\n      'machine-readable date, such as a Video element’s publication date.',\n  },\n  {\n    token: '{{entry.author}}',\n    label: 'Author',\n    description: 'The byline set on the entry.',\n  },\n  {\n    token: '{{entry.authorBio}}',\n    label: 'Author bio',\n    description: 'Blurb from the author’s record.',\n  },\n  {\n    token: '{{entry.authorImage}}',\n    label: 'Author portrait',\n    description: 'Portrait or logo from the author’s record.',\n  },\n  {\n    token: '{{entry.authorUrl}}',\n    label: 'Author link',\n    description: 'The author’s own page.',\n  },\n  {\n    token: '{{entry.authorPageUrl}}',\n    label: 'Author page',\n    description:\n      'This author’s page on this site — everything they wrote, across every ' +\n      'collection. Separate from Author link, which is their own site.',\n  },\n  {\n    token: '{{entry.slug}}',\n    label: 'Slug',\n    description: 'URL-safe entry identifier.',\n  },\n  /*\n    Named \"Its collection…\" rather than \"Collection…\", which is what these\n    describe and also exactly what the `{{collection.*}}` entries below are\n    called. The picker groups options by heading, so the two sets sit apart —\n    but a designer scanning it reads the LABEL, and two options reading\n    \"Collection name\" three lines apart is a choice made by guessing. The\n    pronoun is doing real work: on the one page where both resolve, they mean\n    different collections.\n  */\n  {\n    token: '{{entry.collection}}',\n    label: 'Its collection',\n    description:\n      'Which section this entry belongs to. Worth binding on a listing that ' +\n      'MIXES collections — an author page — where a card otherwise cannot ' +\n      'tell a release note from an essay.',\n  },\n  {\n    token: '{{entry.collectionSlug}}',\n    label: 'Its collection slug',\n    description: 'That collection’s URL segment.',\n  },\n  {\n    token: '{{entry.collectionUrl}}',\n    label: 'Its collection link',\n    description: 'The listing this entry belongs to.',\n  },\n  {\n    token: '{{entry.coverImage}}',\n    label: 'Cover image',\n    description: 'Cover image URL.',\n  },\n  {\n    token: '{{entry.coverVideo}}',\n    label: 'Featured video',\n    description:\n      'The featured video’s source — a library film, a video link or a ' +\n      'Wistia link — for a Video element.',\n  },\n  {\n    token: '{{entry.category}}',\n    label: 'Category',\n    description: 'The entry category.',\n  },\n  {\n    token: '{{entry.tags}}',\n    label: 'Tags',\n    description: 'Tags, comma separated.',\n  },\n  {\n    token: '{{entry.seoTitle}}',\n    label: 'SEO title',\n    description: 'Search title; falls back to Title.',\n  },\n  {\n    token: '{{entry.seoDescription}}',\n    label: 'SEO description',\n    description: 'Meta description; falls back to Excerpt.',\n  },\n]\n\n/**\n * `{{collection.*}}` and `{{pagination.*}}` tokens (AGL-551/1321/1386) —\n * resolve on collection list/entry template screens (see the tenant compose\n * pipeline's collection tokens).\n *\n * The category and pagination tokens all resolve to the empty string where\n * they do not apply, so they are safe to bind unconditionally: ONE list\n * screen serves the bare listing, every `/page/{n}` and every\n * `/category/{slug}`, and a template has no runtime conditional to vary\n * itself with.\n */\nexport const COLLECTION_TOKEN_CATALOG: readonly BindingTokenCatalogEntry[] = [\n  {\n    token: '{{collection.name}}',\n    label: 'Collection name',\n    description: 'Display name of the routed collection.',\n  },\n  {\n    token: '{{collection.slug}}',\n    label: 'Collection slug',\n    description: 'URL slug of the routed collection.',\n  },\n  {\n    token: '{{collection.category}}',\n    label: 'Filtered category',\n    description: 'Category the URL filtered on; empty when unfiltered.',\n  },\n  {\n    token: '{{collection.categorySlug}}',\n    label: 'Filtered category slug',\n    description: 'That category’s URL segment; empty when unfiltered.',\n  },\n  {\n    token: '{{pagination.page}}',\n    label: 'Current page',\n    description: 'Page number this URL is showing.',\n  },\n  {\n    token: '{{pagination.totalPages}}',\n    label: 'Total pages',\n    // A listing bigger than one read cannot be counted honestly (AGL-3219):\n    // the count and the entries were read at two different moments, and the\n    // pager built from them disagreed with itself at the page boundary. It\n    // still resolves, so a template binding it keeps rendering.\n    description:\n      'Pages in the listing, after any category filter. Empty on a listing too large to count — bind the next link instead.',\n  },\n  {\n    token: '{{pagination.prevUrl}}',\n    label: 'Previous page link',\n    description: 'Keeps the category; empty on the first page.',\n  },\n  {\n    token: '{{pagination.nextUrl}}',\n    label: 'Next page link',\n    // The reliable \"is there more\" (AGL-3219): it is set from a read that\n    // asked for one entry more than the page needed, so empty means there was\n    // no such entry rather than that a total said so.\n    description:\n      'Keeps the category; empty when there is nothing older to show.',\n  },\n]\n\n/**\n * `{{author.*}}` tokens (AGL-2518) — resolve on an author's own page,\n * `/author/{slug}`.\n *\n * Empty everywhere else, like the category tokens above and for the same\n * reason: a template has no runtime conditional, so the tokens have to be the\n * thing that varies. A heading bound to `{{author.name}}` prints a name on an\n * author page and nothing anywhere else.\n *\n * The `{{pagination.*}}` tokens resolve HERE TOO, over this author's own\n * archive — deliberately the same four names a collection listing uses, so a\n * pager built once works on both.\n */\nexport const AUTHOR_TOKEN_CATALOG: readonly BindingTokenCatalogEntry[] = [\n  {\n    token: '{{author.name}}',\n    label: 'Name',\n    description: 'The byline this page collects.',\n  },\n  {\n    token: '{{author.bio}}',\n    label: 'Bio',\n    description: 'Their blurb, from the author record.',\n  },\n  {\n    token: '{{author.image}}',\n    label: 'Portrait',\n    description: 'Their portrait or logo, from the author record.',\n  },\n  {\n    token: '{{author.jobTitle}}',\n    label: 'Role',\n    description: 'Their job title; empty for an Organization author.',\n  },\n  {\n    token: '{{author.worksFor}}',\n    label: 'Organization',\n    description: 'Who they write for; empty for an Organization author.',\n  },\n  {\n    token: '{{author.url}}',\n    label: 'Their own site',\n    description:\n      'The url on their record — a personal site, not this page. Empty when ' +\n      'they have none.',\n  },\n  {\n    token: '{{author.pageUrl}}',\n    label: 'This page',\n    description: 'The canonical address of the page you are designing.',\n  },\n  {\n    token: '{{author.entryCount}}',\n    label: 'Post count',\n    description: 'How many entries they have published, across every collection.',\n  },\n  {\n    token: '{{author.entryCountLabel}}',\n    label: 'Post count, worded',\n    description:\n      '\"1 post\" or \"12 posts\" — pluralized for you, because a template has no ' +\n      'conditional to do it with.',\n  },\n]\n\n/**\n * Renders an `{{item.*}}` token for a dataset field, optionally hopping\n * one reference to a field of the referenced record (AGL-180). Always\n * takes the stable model field ID — display names are labels only.\n */\nexport function datasetItemToken(\n  fieldId: string,\n  targetFieldId?: string,\n): string {\n  return targetFieldId\n    ? `{{item.${fieldId}.${targetFieldId}}}`\n    : `{{item.${fieldId}}}`\n}\n\n/**\n * Dataset-item token entries for a repeatable container's model: one per\n * field in model order, labeled with the CURRENT display name while the\n * token carries the stable reference id (AGL-578 — renaming a label never\n * breaks bindings). Reference fields with a configured display field also\n * get their one-hop token (`{{item.author.name}}`).\n */\nexport function datasetItemTokens(\n  model: DatasetModel,\n): BindingTokenCatalogEntry[] {\n  const entries: BindingTokenCatalogEntry[] = []\n  for (const fieldId of model.order ?? []) {\n    const field = model.fields?.[fieldId]\n    if (!field) continue\n    const label = field.name?.trim() || humanizeDatasetFieldId(fieldId)\n    entries.push({\n      token: datasetItemToken(fieldId),\n      label,\n      description: DATASET_FIELD_TYPE_LABELS[field.type] ?? field.type,\n    })\n    // One reference hop (AGL-180): surface the configured display field of\n    // the referenced record — the hop editors reach for most.\n    const hopId =\n      field.type === 'reference' ? field.reference?.displayFieldId : undefined\n    if (hopId) {\n      entries.push({\n        token: datasetItemToken(fieldId, hopId),\n        label: `${label} → ${humanizeDatasetFieldId(hopId)}`,\n        description: 'Field from the referenced record.',\n      })\n    }\n  }\n  return entries\n}\n"],"names":["DATASET_FIELD_TYPE_LABELS","humanizeDatasetFieldId","ENTRY_TOKEN_CATALOG","token","label","description","COLLECTION_TOKEN_CATALOG","AUTHOR_TOKEN_CATALOG","datasetItemToken","fieldId","targetFieldId","datasetItemTokens","model","entries","order","field","fields","name","trim","push","type","hopId","reference","displayFieldId","undefined"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,yBAAyB,QAEpB,sBAAkB;AACzB,SAASC,sBAAsB,QAAQ,gBAAY;AAsBnD;;;;CAIC,GACD,OAAO,MAAMC,sBAA2D;IACtE;QAAEC,OAAO;QAAmBC,OAAO;QAASC,aAAa;IAAsB;IAC/E;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;;;;EAIA,GACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,qEACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,2EACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;;;;;;;;EAQA,GACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,0EACA,wEACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,qEACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;CACD,CAAA;AAED;;;;;;;;;;CAUC,GACD,OAAO,MAAMC,2BAAgE;IAC3E;QACEH,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACP,wEAAwE;QACxE,wEAAwE;QACxE,uEAAuE;QACvE,4DAA4D;QAC5DC,aACE;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACP,sEAAsE;QACtE,0EAA0E;QAC1E,kDAAkD;QAClDC,aACE;IACJ;CACD,CAAA;AAED;;;;;;;;;;;;CAYC,GACD,OAAO,MAAME,uBAA4D;IACvE;QACEJ,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,0EACA;IACJ;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aAAa;IACf;IACA;QACEF,OAAO;QACPC,OAAO;QACPC,aACE,4EACA;IACJ;CACD,CAAA;AAED;;;;CAIC,GACD,OAAO,SAASG,iBACdC,OAAe,EACfC,aAAsB;IAEtB,OAAOA,gBACH,CAAC,OAAO,EAAED,QAAQ,CAAC,EAAEC,cAAc,EAAE,CAAC,GACtC,CAAC,OAAO,EAAED,QAAQ,EAAE,CAAC;AAC3B;AAEA;;;;;;CAMC,GACD,OAAO,SAASE,kBACdC,KAAmB;QAGGA;IADtB,MAAMC,UAAsC,EAAE;IAC9C,KAAK,MAAMJ,YAAWG,eAAAA,MAAME,KAAK,YAAXF,eAAe,EAAE,CAAE;YAOxBZ;YANDY,eAEAG,aASiBA;QAX/B,MAAMA,SAAQH,gBAAAA,MAAMI,MAAM,qBAAZJ,aAAc,CAACH,QAAQ;QACrC,IAAI,CAACM,OAAO;QACZ,MAAMX,QAAQW,EAAAA,cAAAA,MAAME,IAAI,qBAAVF,YAAYG,IAAI,OAAMjB,uBAAuBQ;QAC3DI,QAAQM,IAAI,CAAC;YACXhB,OAAOK,iBAAiBC;YACxBL;YACAC,WAAW,GAAEL,wCAAAA,yBAAyB,CAACe,MAAMK,IAAI,CAAC,YAArCpB,wCAAyCe,MAAMK,IAAI;QAClE;QACA,uEAAuE;QACvE,0DAA0D;QAC1D,MAAMC,QACJN,MAAMK,IAAI,KAAK,eAAcL,mBAAAA,MAAMO,SAAS,qBAAfP,iBAAiBQ,cAAc,GAAGC;QACjE,IAAIH,OAAO;YACTR,QAAQM,IAAI,CAAC;gBACXhB,OAAOK,iBAAiBC,SAASY;gBACjCjB,OAAO,GAAGA,MAAM,GAAG,EAAEH,uBAAuBoB,QAAQ;gBACpDhB,aAAa;YACf;QACF;IACF;IACA,OAAOQ;AACT"}

package/src/lib/app-utils/collection-entries.d.ts

@@ -81,6 +81,24 @@ export declare const COLLECTION_SEARCH_COMPONENT_ID = "collectionSearch";
  */
 export declare const COLLECTION_PAGE_ROUTE_SEGMENT = "page";
 export declare const COLLECTION_CATEGORY_ROUTE_SEGMENT = "category";
+/**
+ * `/{collection}/after/{cursor}` — the older page (AGL-3219).
+ *
+ * ## Why a PATH segment and not `?after=`
+ *
+ * The tenant catch-all is statically rendered and ISR-cached with the URL
+ * PATH as its key (`revalidate = 3600`, AGL-1152). A query string is not part
+ * of that key, so every cursor address would share ONE cache entry and serve
+ * whichever of them rendered first to everybody — the same reason a routed
+ * category is `/{collection}/category/{slug}` rather than `?category=`. And
+ * reading `searchParams` at all opts the whole catch-all out of static
+ * rendering, which is the opposite of what that page is for.
+ *
+ * A path segment is cached per address, crawlable, and costs nothing.
+ */
+export declare const COLLECTION_AFTER_ROUTE_SEGMENT = "after";
+/** `/{collection}/before/{cursor}` — the newer page (AGL-3219). */
+export declare const COLLECTION_BEFORE_ROUTE_SEGMENT = "before";
 /** Namespaces cloned template ids per container/entry (cf. `rep__`). */
 export declare const COLLECTION_ENTRIES_NODE_ID_PREFIX = "centry__";
 /** Hard bound on entries a single block renders, before `entriesLimit`. */
@@ -140,6 +158,38 @@ export declare const COLLECTION_LIST_PAGE_SIZE = 10;
  * empty collection still has a page 1 (AGL-620).
  */
 export declare function collectionTotalPages(total: number, perPage: number): number;
+/**
+ * The slice of a listing's entries that the page named by `pagination`
+ * actually shows (AGL-3213).
+ *
+ * The loader hands the WHOLE narrowed set down to compose, because
+ * {@link expandCollectionEntries} does its own windowing off the block's
+ * props — a Collection entries block may carry its own `perPage`, its own
+ * pinned `page`, a `firstPageOnly` switch and its own filters, none of which
+ * this function can see. Slicing before compose would double-window and empty
+ * every page after the first.
+ *
+ * Everything the loader serializes into page PROPS is downstream of compose,
+ * and there the full set is not merely wasted bytes — it is a false
+ * statement. The `ItemList` JSON-LD numbers its items
+ * `(page - 1) * perPage + index + 1` on the premise that `entries` is the
+ * window; handed all one hundred, `/changelog/page/7` published
+ * `numberOfItems: 100` and positions 61 through 160, most of them past the
+ * end of the collection. The legacy fallback renderer read it the same way
+ * and rendered the whole list on every page.
+ *
+ * So: the loader keeps the full set until compose has had it, and narrows
+ * HERE on the way into props, where `pagination` is the route's own answer to
+ * which page this is.
+ *
+ * An unpaginated listing (an entry route, the RSS feed) passes no pagination
+ * and gets its entries back untouched.
+ */
+export declare function collectionEntriesPageWindow<T>(entries: readonly T[], pagination: {
+    page?: number;
+    perPage?: number;
+    windowStart?: number;
+} | null | undefined): T[];
 /** Default/most related posts a Related posts block renders (AGL-582). */
 export declare const COLLECTION_RELATED_DEFAULT_LIMIT = 3;
 export declare const COLLECTION_RELATED_MAX = 12;
@@ -334,6 +384,17 @@ export interface CollectionEntriesSource {
      * wins: that is a deliberately pinned window, not a paginated list.
      */
     page?: number;
+    /**
+     * The absolute index `entries[0]` holds in the collection's own order
+     * (AGL-3213). Zero everywhere except a listing page past the cached read's
+     * bound, which is served by a window read for that page alone.
+     *
+     * Without it a windowed source is silently empty: every consumer here
+     * slices `[(page - 1) * perPage, …)` on the premise that `entries` starts
+     * at the beginning of the collection, so page 11 of a windowed ten-entry
+     * source slices from 100 and renders nothing.
+     */
+    windowStart?: number;
 }
 /**
  * Display name of an entry's category (AGL-582): the `categoryId` lookup
@@ -432,16 +493,25 @@ export declare function collectionListUrl(options: {
     collectionSlug: string;
     categorySlug?: string | null;
     page?: number | null;
+    /** Continue after this entry's document id — the older direction. */
+    after?: string | null;
+    /** Continue before this entry's document id — the newer direction. */
+    before?: string | null;
 }): string;
 /** Where a listing's pager can go from here (AGL-1386). */
 export interface CollectionPaginationLinks {
     /** 1-based current page; 1 when the listing is unpaginated. */
     page: number;
-    /** Total pages in the CURRENT (possibly category-filtered) set. */
+    /**
+     * Total pages in the CURRENT set.
+     *
+     * @deprecated AGL-3219 — 0 when it cannot be known, which is any collection
+     * past one read's bound. See `CollectionPagination.totalPages`.
+     */
     totalPages: number;
     /** The previous page's URL, or `''` on the first page. */
     prevUrl: string;
-    /** The next page's URL, or `''` on the last page. */
+    /** The next page's URL, or `''` when nothing older follows. */
     nextUrl: string;
 }
 /**
@@ -468,8 +538,26 @@ export declare function collectionPaginationLinks(options: {
     categorySlug?: string | null;
     /** 1-based current page; anything unusable reads as page 1. */
     page?: number | null;
-    /** Total pages; anything unusable reads as a single page. */
+    /**
+     * Total pages.
+     *
+     * @deprecated AGL-3219 — no longer consulted for whether a next link
+     * exists; {@link collectionPaginationLinks} asks `nextCursor` instead.
+     */
     totalPages?: number | null;
+    /**
+     * The document id the older page continues from, or `''` when there is no
+     * older page (AGL-3219).
+     *
+     * This is the ONLY thing that decides whether `nextUrl` is a link. It comes
+     * from a `limit(perPage + 1)` probe, so an empty string means the read
+     * looked for an eleventh entry and there was not one — which is a fact
+     * about the collection, unlike a total that two differently-cached reads
+     * could disagree about.
+     */
+    nextCursor?: string | null;
+    /** The document id the newer page continues before, or `''`. */
+    prevCursor?: string | null;
 }): CollectionPaginationLinks;
 /** A content-collection path resolved to what it addresses (AGL-1321). */
 export interface CollectionRoute {
@@ -480,6 +568,10 @@ export interface CollectionRoute {
     categorySlug?: string;
     /** 1-based list page; always 1 for entry routes. */
     page: number;
+    /** Set only for `/{collection}/after/{cursor}` (AGL-3219). */
+    after?: string;
+    /** Set only for `/{collection}/before/{cursor}` (AGL-3219). */
+    before?: string;
 }
 /**
  * Parses a non-screen path against the content-collection route shapes

package/src/lib/app-utils/collection-entries.js

@@ -72,6 +72,22 @@ export * from "./collection-entry-date.js";
  * slugged `page` or `category` keeps serving at `/{collection}/{entry}`.
  */ export const COLLECTION_PAGE_ROUTE_SEGMENT = 'page';
 export const COLLECTION_CATEGORY_ROUTE_SEGMENT = 'category';
+/**
+ * `/{collection}/after/{cursor}` — the older page (AGL-3219).
+ *
+ * ## Why a PATH segment and not `?after=`
+ *
+ * The tenant catch-all is statically rendered and ISR-cached with the URL
+ * PATH as its key (`revalidate = 3600`, AGL-1152). A query string is not part
+ * of that key, so every cursor address would share ONE cache entry and serve
+ * whichever of them rendered first to everybody — the same reason a routed
+ * category is `/{collection}/category/{slug}` rather than `?category=`. And
+ * reading `searchParams` at all opts the whole catch-all out of static
+ * rendering, which is the opposite of what that page is for.
+ *
+ * A path segment is cached per address, crawlable, and costs nothing.
+ */ export const COLLECTION_AFTER_ROUTE_SEGMENT = 'after';
+/** `/{collection}/before/{cursor}` — the newer page (AGL-3219). */ export const COLLECTION_BEFORE_ROUTE_SEGMENT = 'before';
 /** Namespaces cloned template ids per container/entry (cf. `rep__`). */ export const COLLECTION_ENTRIES_NODE_ID_PREFIX = 'centry__';
 /** Hard bound on entries a single block renders, before `entriesLimit`. */ export const COLLECTION_ENTRIES_MAX = 100;
 /**
@@ -133,6 +149,48 @@ export const COLLECTION_CATEGORY_ROUTE_SEGMENT = 'category';
     if (perPage <= 0) return 1;
     return Math.max(1, Math.ceil(total / perPage));
 }
+/**
+ * The slice of a listing's entries that the page named by `pagination`
+ * actually shows (AGL-3213).
+ *
+ * The loader hands the WHOLE narrowed set down to compose, because
+ * {@link expandCollectionEntries} does its own windowing off the block's
+ * props — a Collection entries block may carry its own `perPage`, its own
+ * pinned `page`, a `firstPageOnly` switch and its own filters, none of which
+ * this function can see. Slicing before compose would double-window and empty
+ * every page after the first.
+ *
+ * Everything the loader serializes into page PROPS is downstream of compose,
+ * and there the full set is not merely wasted bytes — it is a false
+ * statement. The `ItemList` JSON-LD numbers its items
+ * `(page - 1) * perPage + index + 1` on the premise that `entries` is the
+ * window; handed all one hundred, `/changelog/page/7` published
+ * `numberOfItems: 100` and positions 61 through 160, most of them past the
+ * end of the collection. The legacy fallback renderer read it the same way
+ * and rendered the whole list on every page.
+ *
+ * So: the loader keeps the full set until compose has had it, and narrows
+ * HERE on the way into props, where `pagination` is the route's own answer to
+ * which page this is.
+ *
+ * An unpaginated listing (an entry route, the RSS feed) passes no pagination
+ * and gets its entries back untouched.
+ */ export function collectionEntriesPageWindow(entries, pagination) {
+    const perPage = Number(pagination == null ? void 0 : pagination.perPage);
+    if (!Number.isFinite(perPage) || perPage <= 0) return [
+        ...entries
+    ];
+    const pageRaw = Number(pagination == null ? void 0 : pagination.page);
+    const page = Number.isFinite(pageRaw) && pageRaw >= 1 ? Math.floor(pageRaw) : 1;
+    // `windowStart` is where `entries` begins in the collection's own order
+    // (AGL-3213). A listing past the cached read's bound is served by a window
+    // read for that page alone, and slicing it from the page's absolute offset
+    // would return nothing.
+    const startRaw = Number(pagination == null ? void 0 : pagination.windowStart);
+    const windowStart = Number.isFinite(startRaw) && startRaw > 0 ? Math.floor(startRaw) : 0;
+    const start = Math.max(0, (page - 1) * Math.floor(perPage) - windowStart);
+    return entries.slice(start, start + Math.floor(perPage));
+}
 /** Default/most related posts a Related posts block renders (AGL-582). */ export const COLLECTION_RELATED_DEFAULT_LIMIT = 3;
 export const COLLECTION_RELATED_MAX = 12;
 /** Most categories a collection's taxonomy holds (AGL-582). */ export const COLLECTION_CATEGORIES_MAX = 50;
@@ -404,7 +462,23 @@ categories) {
  * a second address for the page that already exists.
  */ export function collectionListUrl(options) {
     const scoped = options.categorySlug ? `/${options.collectionSlug}/${COLLECTION_CATEGORY_ROUTE_SEGMENT}/` + collectionCategorySlug(options.categorySlug) : `/${options.collectionSlug}`;
-    const page = Number(options.page);
+    /*
+   * A cursor address (AGL-3219) wins over a page number when both are given,
+   * because it is the one that survives a publish at the head of the list.
+   */ const cursor = (options.before || options.after || '').trim();
+    if (cursor) {
+        const segment = options.before ? COLLECTION_BEFORE_ROUTE_SEGMENT : COLLECTION_AFTER_ROUTE_SEGMENT;
+        return `${scoped}/${segment}/${encodeURIComponent(cursor)}`;
+    }
+    /*
+   * `/{collection}/page/{n}` is still MINTED for a collection that fits
+   * inside one read, where it is exactly as stable as it ever was: every one
+   * of those pages is sliced out of a single cached snapshot, so no publish
+   * can move one page's entries relative to another's. It is past the bound —
+   * where the head and the tail were two different reads of a moving list —
+   * that a number stopped being an address, and there the pager mints
+   * cursors instead.
+   */ const page = Number(options.page);
     return Number.isFinite(page) && page > 1 ? `${scoped}/${COLLECTION_PAGE_ROUTE_SEGMENT}/${Math.floor(page)}` : scoped;
 }
 /**
@@ -426,24 +500,59 @@ categories) {
  * template binds. A second derivation is how a fallback and a template start
  * disagreeing about which page they are on.
  */ export function collectionPaginationLinks(options) {
+    var _options_nextCursor, _options_prevCursor;
     const positive = (value)=>{
         const parsed = Math.floor(Number(value));
         return Number.isFinite(parsed) && parsed > 0 ? parsed : 1;
     };
     const page = positive(options.page);
-    const totalPages = positive(options.totalPages);
-    const href = (n)=>collectionListUrl(_extends({
-            collectionSlug: options.collectionSlug
-        }, options.categorySlug ? {
-            categorySlug: options.categorySlug
-        } : {}, {
+    const totalPagesRaw = Math.floor(Number(options.totalPages));
+    /*
+   * Zero means UNKNOWN, and only a caller that deals in cursors can mean it
+   * (AGL-3219).
+   *
+   * A listing past the bound passes cursors and no total, and 0 is how it
+   * says the number cannot be had. A caller that passes neither — an entry
+   * route, which has no listing at all — is the inert case the tokens have
+   * always answered with "page 1 of 1", and it keeps that answer rather than
+   * telling an entry template it is on page 1 of 0.
+   */ const knowsCursors = options.nextCursor !== undefined || options.prevCursor !== undefined;
+    const totalPages = Number.isFinite(totalPagesRaw) && totalPagesRaw > 0 ? totalPagesRaw : knowsCursors ? 0 : 1;
+    const scope = _extends({
+        collectionSlug: options.collectionSlug
+    }, options.categorySlug ? {
+        categorySlug: options.categorySlug
+    } : {});
+    const next = ((_options_nextCursor = options.nextCursor) != null ? _options_nextCursor : '').trim();
+    const prev = ((_options_prevCursor = options.prevCursor) != null ? _options_prevCursor : '').trim();
+    /*
+   * Numbered while the whole set fits inside ONE read, cursors once it does
+   * not (AGL-3219).
+   *
+   * A total is only ever stated for a collection the shared read holds
+   * entirely, and there every page is sliced out of that one cached snapshot:
+   * no publish can move one page's entries relative to another's, so a number
+   * is a perfectly good address and stays the one readers and crawlers
+   * already have. Past the bound the head and the tail were two reads of a
+   * moving list, a number stopped naming the same ten entries from one render
+   * to the next, and the pager mints the cursor its own page proves instead.
+   */ const numbered = totalPages > 0;
+    const numberedHref = (n)=>collectionListUrl(_extends({}, scope, {
             page: n
         }));
     return {
         page,
         totalPages,
-        prevUrl: page > 1 ? href(page - 1) : '',
-        nextUrl: page < totalPages ? href(page + 1) : ''
+        /*
+     * Page 2 going back lands on the bare listing either way: it is the head
+     * of the collection, and `/{collection}` is its address — there is no
+     * cursor for "the beginning".
+     */ prevUrl: page === 2 ? collectionListUrl(scope) : page > 2 ? numbered ? numberedHref(page - 1) : prev ? collectionListUrl(_extends({}, scope, {
+            before: prev
+        })) : '' : '',
+        nextUrl: numbered ? page < totalPages ? numberedHref(page + 1) : '' : next ? collectionListUrl(_extends({}, scope, {
+            after: next
+        })) : ''
     };
 }
 const POSITIVE_INTEGER = /^[1-9]\d*$/;
@@ -483,6 +592,28 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
             page: Number(rest[1])
         } : null;
     }
+    /*
+   * `/{collection}/after/{cursor}` and its `before` twin (AGL-3219).
+   *
+   * Checked BEFORE the category shape and after the one-segment entry shape,
+   * so an entry whose slug happens to be `after` still answers at
+   * `/{collection}/after` — that is one segment, and this is two.
+   *
+   * `page` stays 1: nothing counts a cursor address, and it is the display
+   * label rather than a position anything reads back.
+   */ if (rest.length === 2 && (rest[0] === COLLECTION_AFTER_ROUTE_SEGMENT || rest[0] === COLLECTION_BEFORE_ROUTE_SEGMENT) && rest[1]) {
+        const cursor = decodeURIComponent(rest[1]).trim();
+        if (!cursor) return null;
+        return rest[0] === COLLECTION_AFTER_ROUTE_SEGMENT ? {
+            collectionSlug,
+            after: cursor,
+            page: 1
+        } : {
+            collectionSlug,
+            before: cursor,
+            page: 1
+        };
+    }
     if (rest.length === 2 && rest[0] === COLLECTION_CATEGORY_ROUTE_SEGMENT) {
         const categorySlug = collectionCategorySlug(rest[1]);
         return categorySlug ? {
@@ -779,7 +910,12 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
         // counting it, because the count cannot see a read that came back full
         // and was then thinned by the liveness gate.
         const sourceCapped = collectionSourceIsBounded(source);
-        const windowed = suppressedBeyondFirstPage ? [] : perPage ? filtered.slice((page - 1) * perPage, (page - 1) * perPage + perPage) : filtered.slice(0, limit);
+        // Where this source's first entry sits in the collection (AGL-3213):
+        // zero for a whole read, and the page's own offset for a windowed one.
+        const windowStartRaw = Number(source.windowStart);
+        const windowStart = Number.isFinite(windowStartRaw) && windowStartRaw > 0 ? Math.floor(windowStartRaw) : 0;
+        const pageStart = perPage ? Math.max(0, (page - 1) * perPage - windowStart) : 0;
+        const windowed = suppressedBeyondFirstPage ? [] : perPage ? filtered.slice(pageStart, pageStart + perPage) : filtered.slice(0, limit);
         const childIds = [];
         windowed.forEach((entry, index)=>{
             const prefix = `${COLLECTION_ENTRIES_NODE_ID_PREFIX}${containerId}__${index}__`;