@aglyn/aglyn 1.0.0-beta.143

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/collection-entries.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 type { AglynNodeSchema, NodeId } from '../foundation'\nimport {\n  COLLECTION_ENTRY_DATE_FORMAT_DEFAULT,\n  type CollectionEntryDateFormat,\n  collectionEntryPublishedAtIso,\n  formatCollectionEntryDate,\n  normalizeCollectionEntryDateFormat,\n} from './collection-entry-date'\nimport {\n  type ContentAuthorLink,\n  type ContentAuthorRecord,\n  contentAuthorPageUrl,\n  normalizeContentAuthorLinks,\n} from './content-authors'\nimport { resolveNamedTokens } from './resolve-named-tokens'\n\nexport * from './collection-entry-date'\n\n/**\n * Persisted component id of the \"Collection entries\" repeater block\n * (plugins-mui). Like `layoutSlot`, the id lives here so the tenant compose\n * pipeline can find the block without importing the component bundle.\n */\nexport const COLLECTION_ENTRIES_COMPONENT_ID = 'collectionEntries'\n\n/** Persisted component id of the markdown \"Entry body\" block (plugins-mui). */\nexport const COLLECTION_ENTRY_BODY_COMPONENT_ID = 'collectionEntryBody'\n\n/**\n * Persisted component id of the \"Related posts\" block (plugins-mui,\n * AGL-582). The compose pipeline stamps the related entries onto the node,\n * so the id lives here like the entries/body blocks.\n */\nexport const COLLECTION_RELATED_COMPONENT_ID = 'collectionRelated'\n\n/** Persisted component id of the share-bar block (plugins-mui, AGL-582). */\nexport const COLLECTION_SHARE_COMPONENT_ID = 'collectionShare'\n\n/** Persisted component id of the entry-meta block (plugins-mui, AGL-582). */\nexport const COLLECTION_ENTRY_META_COMPONENT_ID = 'collectionEntryMeta'\n\n/**\n * Persisted component id of the author card that closes an article\n * (plugins-mui, AGL-2486).\n *\n * Entry Meta prints the byline — a NAME, on one line, beside the date. The\n * author record it now resolves against carries a portrait, a bio, a job\n * title and a url, and none of those have anywhere to render: a template that\n * wanted the card the article frame draws had to type the name and the blurb\n * as literal text, which then said \"The Aglyn Team\" under a post somebody\n * else wrote and went stale the moment the author record was edited. The id\n * lives here, with the other collection blocks, so the compose pipeline can\n * fill the card without importing the bundle.\n */\nexport const COLLECTION_ENTRY_AUTHOR_COMPONENT_ID = 'collectionEntryAuthor'\n\n/**\n * Persisted component id of the \"Category Pills\" block (plugins-mui,\n * AGL-1321). Like the entries repeater, the id lives here so the tenant\n * compose pipeline can stamp the block's links without importing the bundle.\n */\nexport const COLLECTION_CATEGORIES_COMPONENT_ID = 'collectionCategories'\n\n/**\n * Persisted component id of the standalone \"Collection Search\" block\n * (plugins-mui, AGL-1516).\n *\n * The Collection Entries block grew its own search box first, and it renders\n * INSIDE that block — first child of the block's own stack. Figma 494:1220\n * puts the field in the listing's toolbar row instead, beside the RSS button\n * with the category pills opposite it, and no amount of authoring can lift a\n * block's own child out of it. The pills cannot move the other way either:\n * every child of an entries block is cloned once per entry.\n *\n * So the field became a block an author can put where the frame draws it.\n * Suggestion-panel only, by construction rather than by omission — a\n * standalone box has no clones to hide, so `filter` is a thing it genuinely\n * cannot do, and the one behaviour it does have is the toolbar behaviour the\n * frame asks for.\n */\nexport const COLLECTION_SEARCH_COMPONENT_ID = 'collectionSearch'\n\n/**\n * Reserved list sub-paths (AGL-620 `page`, AGL-1321 `category`). Both are\n * only reserved as the HEAD of a longer path, so an entry legitimately\n * slugged `page` or `category` keeps serving at `/{collection}/{entry}`.\n */\nexport const COLLECTION_PAGE_ROUTE_SEGMENT = 'page'\nexport const COLLECTION_CATEGORY_ROUTE_SEGMENT = 'category'\n\n/** Namespaces cloned template ids per container/entry (cf. `rep__`). */\nexport const COLLECTION_ENTRIES_NODE_ID_PREFIX = 'centry__'\n\n/** Hard bound on entries a single block renders, before `entriesLimit`. */\nexport const COLLECTION_ENTRIES_MAX = 100\n\n/**\n * Hard bound on the entries one READ of a collection returns (AGL-1516) — the\n * `.limit()` the tenant's live-entries query carries.\n *\n * Named here, beside the render bound it has always silently matched, because\n * a search index has to know the difference. The render bound is a choice\n * about a block; this one is a choice about the DATA, and a set that reaches\n * it is a set nobody has seen all of. Two 100s that happened to agree meant\n * `entries.length === 100` could be read either as \"this collection has 100\n * entries\" or \"this read stopped at 100\", and the honest empty state turns on\n * exactly that distinction.\n */\nexport const COLLECTION_SOURCE_MAX = 100\n\n/**\n * Whether a collection source is a COMPLETE read or a bounded one\n * (AGL-1516) — true when the read came back holding its own limit, which is\n * the only signal a limited query without a count leaves behind.\n *\n * Deliberately errs toward \"bounded\": a collection of exactly\n * {@link COLLECTION_SOURCE_MAX} entries answers true and gets described one\n * notch more cautiously than it needed. Overstating what a search covered is\n * the failure that renders as a confident \"nothing matched\".\n */\nexport function collectionSourceReachedBound(\n  entries: readonly unknown[] | undefined,\n): boolean {\n  return (entries?.length ?? 0) >= COLLECTION_SOURCE_MAX\n}\n\n/**\n * Whether the read behind a collection source was a bounded one (AGL-1516),\n * asking the READER first and only then falling back to counting.\n *\n * The count is a proxy, and it under-reports in two ways that both landed\n * after `collectionSourceReachedBound` was written:\n *\n * 1. The query takes `status in ['published', 'scheduled']` and the loader\n *    then drops what is not live yet — a future `publishAt`, or since AGL-471\n *    a due schedule the plan does not carry. A read that came back holding\n *    its full 100 docs can therefore hand over 96 entries, and 96 does not\n *    look like a ceiling. A blog with a scheduling queue is exactly the site\n *    that hits this.\n * 2. A category route filters `entries` before compose ever sees them, so the\n *    \"raw set\" the entries block is careful to measure is already narrowed.\n *\n * Both make the flag read FALSE on a read that really did stop at its bound,\n * and false is the direction that produces the confident \"nothing matched\"\n * this signal exists to prevent. So `reachedBound` is threaded down from the\n * query that owns the fact, and the count survives only as the fallback for a\n * source that predates it — a payload cached before this shipped, or a caller\n * that assembles a source by hand.\n */\nexport function collectionSourceIsBounded(\n  source: Pick<CollectionEntriesSource, 'entries' | 'reachedBound'> | undefined,\n): boolean {\n  if (source?.reachedBound) return true\n  return collectionSourceReachedBound(source?.entries)\n}\n\n/** Default entries per page for a paginated collection list (AGL-620). */\nexport const COLLECTION_LIST_PAGE_SIZE = 10\n\n/**\n * Total pages for `total` entries at `perPage` per page — at least 1 so an\n * empty collection still has a page 1 (AGL-620).\n */\nexport function collectionTotalPages(total: number, perPage: number): number {\n  if (perPage <= 0) return 1\n  return Math.max(1, Math.ceil(total / perPage))\n}\n\n/** Default/most related posts a Related posts block renders (AGL-582). */\nexport const COLLECTION_RELATED_DEFAULT_LIMIT = 3\nexport const COLLECTION_RELATED_MAX = 12\n\n/** Most categories a collection's taxonomy holds (AGL-582). */\nexport const COLLECTION_CATEGORIES_MAX = 50\n\n/**\n * One taxonomy category on a COLLECTION doc (AGL-582): `id` is the stable\n * slug-like key entries reference (`categoryId`), generated once from the\n * initial name and never changed; `name` is the display label and freely\n * renameable. Stored as an array to preserve author-defined ordering.\n */\nexport interface CollectionCategory {\n  id: string\n  name: string\n  /**\n   * What this category's listing is about, for the `<meta name=\"description\">`\n   * of `/{collection}/category/{slug}`.\n   *\n   * Without one every filtered listing on a site inherits the list template\n   * screen's description — six `/blog/category/*` URLs all described as \"the\n   * blog\", which is the same duplicate-result problem the composed category\n   * TITLE was introduced to solve (AGL-1321), one tag over. Optional, and the\n   * template's description remains the fallback: a category nobody has\n   * described is better summarized by the list it filters than by nothing.\n   */\n  description?: string\n}\n\n/**\n * How many LIVE entries one content collection may hold (AGL-2266).\n *\n * `hosts/{hostId}/collections/{cid}/entries/{eid}` had a DEDICATED rules block\n * re-granting `create` to any editor, client-direct — deliberately, because the\n * name-based exclusions on the host catch-all must not reach entries — so it\n * was the one quota-governed shape under a host with no quota at all. A free\n * org could mint unbounded Firestore documents from the browser.\n *\n * This is a flat PLATFORM cap, not a plan dimension. AGL-1387 declined\n * `collectionsPerHost` and this does not re-open it: nothing here is priced,\n * no `OrgEntitlements` key is added, and every plan gets the same number. It is\n * the `WEBHOOK_MAX_PER_HOST` (AGL-1360) / `NON_PAGE_SCREEN_MAX_PER_HOST`\n * (AGL-1399) shape, which both issues invented for exactly this: uncapped\n * infrastructure behind a $0 subscription.\n *\n * ## Per COLLECTION, paired with {@link COLLECTIONS_MAX_PER_HOST}\n *\n * A per-HOST entry cap would need a count across every collection the host\n * holds, which is a collection-group read the entry documents carry no `hostId`\n * to scope. Per collection is one `count()` on the collection the create is\n * addressed to — the same read every other cap on `/api/hosts/resources`\n * already pays — and the host is bounded by the PRODUCT of the two numbers,\n * which is why the sibling cap had to land in the same change. One of the two\n * alone bounds nothing: unbounded collections each holding 10,000 entries is\n * the same unbounded store, spelled differently.\n *\n * ## Why 10,000\n *\n * A blog publishing daily reaches it after twenty-seven years; the largest\n * content collection in production holds double digits. The failure mode of a\n * flat cap set too low is blocking real authoring with an error the price list\n * cannot explain, so it is sized to the heaviest plausible library rather than\n * to today's data. It also bounds the cost of the console's own listing, which\n * reads entries with `limit(200)` and would otherwise page through a store with\n * no ceiling.\n */\nexport const ENTRIES_MAX_PER_COLLECTION = 10000\n\n/**\n * How many LIVE content collections one host may hold (AGL-2266).\n *\n * The other half of the entry bound above, and the reason it means anything.\n * Collection creation was already server-owned — the rules deny client `create`\n * and `/api/hosts/collections` claims the slug transactionally (AGL-978) — so\n * the collection had a WRITER with authority and simply no number to enforce.\n *\n * Again a platform cap and not `collectionsPerHost`: AGL-1387 decided\n * collections are not a thing customers are charged for, and that decision is\n * untouched. 100 is far past any real site's taxonomy — production's busiest\n * host has a handful — and short enough that the entries ceiling above\n * multiplies out to a bounded store rather than an unbounded one.\n */\nexport const COLLECTIONS_MAX_PER_HOST = 100\n\n/**\n * One published content-collection entry as the compose pipeline sees it\n * (AGL-551). Mirrors the tenant's `CollectionEntrySummary` without the\n * Firestore dependency so the expansion stays pure.\n */\nexport interface CollectionEntryRecord {\n  $id?: string\n  title?: string\n  slug?: string\n  excerpt?: string\n  /**\n   * Per-entry byline (AGL-686); falls back to the site as author.\n   *\n   * Since AGL-2486 this is either the legacy free-typed string or the NAME of\n   * the author record `authorId` points at, denormalized by the tenant runtime\n   * so the byline block, the `{{entry.author}}` token and the RSS feed all\n   * keep reading one field.\n   */\n  authorName?: string\n  /**\n   * Reference into `hosts/{hostId}/authors` (AGL-2486) — the custom author\n   * this entry publishes under. Absent on every entry written before it, and\n   * on any entry whose editor chose a one-off byline instead of a record.\n   */\n  authorId?: string\n  /**\n   * The resolved author record, attached by the tenant runtime alongside the\n   * `authorName` it denormalizes (`get-collection-content.ts`). Carries the\n   * portrait, which is why the byline can show the author's own face rather\n   * than the site's mark — see {@link expandCollectionEntryMeta}.\n   */\n  author?: ContentAuthorRecord | null\n  body?: string\n  coverImage?: string\n  /**\n   * The entry's featured video (AGL-2956), stored in the shape\n   * {@link coverImage} is: a `media:{scope}/{id}` reference or a URL, a Wistia\n   * media link included. Raw here for the reason every image field in this\n   * file is raw — the resolver needs the rendering host, which this record\n   * does not carry.\n   *\n   * An entry of a video collection is an article whose featured video sits\n   * where a post's cover image would, which is what makes its page a watch\n   * page. `{{entry.coverVideo}}` binds it into a template's Video element, and\n   * the built-in entry page plays it with no template at all.\n   */\n  coverVideo?: string\n  /** Search-result title override (AGL-582); falls back to `title`. */\n  seoTitle?: string\n  /** Meta description override (AGL-582); falls back to `excerpt`. */\n  seoDescription?: string\n  /**\n   * Stable reference into the collection's `categories` taxonomy\n   * (AGL-582): the ID survives renames, so display names resolve at\n   * render via {@link resolveEntryCategoryName}.\n   */\n  categoryId?: string\n  /**\n   * Legacy free-typed bucket (AGL-582), e.g. \"Engineering\". Still READ\n   * as a fallback everywhere; the editor writes `categoryId` going\n   * forward.\n   */\n  category?: string\n  /** Free-form labels (AGL-582), e.g. [\"nextjs\", \"seo\"]. */\n  tags?: string[]\n  publishedAt?: { seconds: number } | null\n  /**\n   * The collection this entry came OUT of, stamped where the read happened\n   * (AGL-2518).\n   *\n   * Absent everywhere the routed collection already answers the question,\n   * which is every listing the platform had until now: a `/blog` page renders\n   * blog entries, so `entry.url` is built from the one slug the route\n   * resolved and no entry needs to carry its own.\n   *\n   * The author page breaks that assumption — it lists a blog post, a\n   * changelog note and a press release side by side, and building all three\n   * URLs from a single routed slug would produce two links to pages that do\n   * not exist. So the reader that mixes collections stamps each entry with\n   * where it came from, and {@link collectionEntryTokens} prefers it. Every\n   * other caller keeps passing one slug and keeps behaving identically.\n   */\n  collectionSlug?: string\n  /**\n   * The display name of {@link collectionSlug} — \"Changelog\", not\n   * \"changelog\" — so a card on a mixed listing can label which section a\n   * post belongs to. Stamped by the same reader, for the same reason.\n   */\n  collectionName?: string\n}\n\n/** A collection's published entries, keyed for expansion by its slug. */\nexport interface CollectionEntriesSource {\n  slug: string\n  entries: CollectionEntryRecord[]\n  /** The collection's category taxonomy (AGL-582), for name resolution. */\n  categories?: CollectionCategory[]\n  /**\n   * Whether the READ that produced `entries` came back holding its own\n   * `.limit()` (AGL-1516) — a fact recorded where the query ran, because by\n   * the time `entries` gets here it has been through a liveness filter and\n   * possibly a route's category filter, and its length no longer answers the\n   * question. See {@link collectionSourceIsBounded}.\n   */\n  reachedBound?: boolean\n  /**\n   * The page the ROUTE asked for (AGL-1321), set only for the collection the\n   * URL resolved. Fills in a block that declares `perPage` but no `page` —\n   * which is every block a designer can author, since design time cannot\n   * know which page a visitor is on. A block that names its own `page` still\n   * wins: that is a deliberately pinned window, not a paginated list.\n   */\n  page?: number\n}\n\n/**\n * Display name of an entry's category (AGL-582): the `categoryId` lookup\n * into the collection's taxonomy wins; the legacy free-typed\n * `entry.category` string is the fallback so existing data keeps\n * rendering. An ID referencing a deleted category resolves to nothing —\n * by design the entry simply shows no category.\n */\nexport function resolveEntryCategoryName(\n  entry: Pick<CollectionEntryRecord, 'categoryId' | 'category'>,\n  // `readonly` because this only reads (AGL-1321): the route helpers hold\n  // the taxonomy as readonly and would otherwise have to copy it to ask.\n  categories?: readonly CollectionCategory[],\n): string | undefined {\n  const categoryId = (entry.categoryId ?? '').trim()\n  if (categoryId) {\n    const match = (categories ?? []).find(\n      (category) => category.id === categoryId,\n    )\n    if (match?.name) return match.name\n  }\n  const legacy = (entry.category ?? '').trim()\n  return legacy || undefined\n}\n\n/* ── Published-date formats (AGL-1459) ──────────────────────────────────── */\n\n\n/**\n * The values an Entry Meta block shows, in the exact spellings the\n * `{{entry.date}}` / `{{entry.author}}` / `{{entry.category}}` /\n * `{{entry.tags}}` tokens produce (AGL-1385, author added AGL-1459).\n *\n * Extracted so the token map and {@link expandCollectionEntryMeta} cannot\n * drift: the same entry has to read the same way whether the author bound the\n * tokens by hand or let the server fill the block in.\n */\nexport function collectionEntryMetaValues(\n  entry: CollectionEntryRecord,\n  categories?: readonly CollectionCategory[],\n  dateFormat?: CollectionEntryDateFormat,\n): { date: string; author: string; category: string; tags: string } {\n  return {\n    date: formatCollectionEntryDate(entry.publishedAt, dateFormat),\n    // The per-entry byline the editor already collects (AGL-686). It was\n    // reachable in the entry's JSON-LD and nowhere on the page, which is what\n    // made the frame's byline unauthorable (AGL-1459).\n    //\n    // The resolved RECORD first, then the legacy string (AGL-2486) — the\n    // precedence `resolveEntryAuthor` applies, spelled the same way here. The\n    // tenant denormalizes the record's name onto `authorName` before this\n    // runs, so on a live render the two agree; reading the record directly is\n    // what makes that a convenience rather than the only thing holding the\n    // byline up.\n    author: (entry.author?.name || entry.authorName || '').trim(),\n    // Entry model v2 (AGL-582): category resolves by stable ID against the\n    // collection's taxonomy, falling back to the legacy free-typed string.\n    category: resolveEntryCategoryName(entry, categories) ?? '',\n    tags: (entry.tags ?? []).join(', '),\n  }\n}\n\n/**\n * The values an Entry Author card shows (AGL-2486) — the fields of the\n * resolved author RECORD, in the spellings the `{{entry.author*}}` tokens\n * produce.\n *\n * Extracted for the reason {@link collectionEntryMetaValues} was: the card,\n * the token map and {@link expandCollectionEntryAuthor} have to agree, and\n * three copies of \"name, falling back to the legacy string\" would not.\n *\n * `image` stays RAW — a `media:` reference or a plain url, whichever the\n * author saved — because the resolver that turns one into a fetchable src\n * needs the rendering host and this function has no host (`resolveMediaSrc`,\n * AGL-1215). Every other consumer of an image field in this file does the\n * same.\n */\nexport function collectionEntryAuthorValues(entry: CollectionEntryRecord): {\n  name: string\n  bio: string\n  image: string\n  url: string\n  pageUrl: string\n  links: ContentAuthorLink[]\n} {\n  const author = entry.author\n  return {\n    // Their page on THIS site (AGL-2518/2519) — a different destination from\n    // `url`, which is their own. Empty when nothing addresses them, so the\n    // byline renders as plain text rather than as a link to `/author/`.\n    pageUrl: contentAuthorPageUrl({\n      ...(author ? { author } : {}),\n      ...(entry.authorId ? { authorId: entry.authorId } : {}),\n      ...(entry.authorName ? { authorName: entry.authorName } : {}),\n    }),\n    // The rows the card PRINTS (AGL-2516). Normalized here rather than\n    // trusted, because this is the boundary a stored document crosses to\n    // become props: the renderer guards the href too, but only one of the two\n    // sits on the path a hand-written document would take.\n    links: normalizeContentAuthorLinks(author?.links),\n    // The record wins, then the legacy free-typed byline (AGL-686), which is\n    // the same precedence `resolveEntryAuthor` applies — an entry written\n    // before custom authors still fills a card, with the one field it has.\n    name: (author?.name ?? entry.authorName ?? '').trim(),\n    bio: (author?.bio ?? '').trim(),\n    image: (author?.image ?? '').trim(),\n    url: (author?.url ?? '').trim(),\n  }\n}\n\n/**\n * The `{{entry.*}}` token map for one entry (AGL-105/551): substituted\n * globally on entry-template screens and per-clone inside the Collection\n * entries block. `entry.url` resolves to the entry's auto-route so links\n * (`Read more`, titles) work without hardcoding the collection slug.\n */\nexport function collectionEntryTokens(\n  entry: CollectionEntryRecord,\n  collectionSlug: string,\n  categories?: CollectionCategory[],\n): Record<string, string> {\n  const meta = collectionEntryMetaValues(entry, categories)\n  const author = collectionEntryAuthorValues(entry)\n  // The entry's OWN collection wins over the routed one (AGL-2518) — see\n  // `CollectionEntryRecord.collectionSlug`. Unset on every single-collection\n  // listing, which is why this changes nothing for them.\n  const slug = (entry.collectionSlug ?? '').trim() || collectionSlug\n  return {\n    'entry.title': entry.title ?? '',\n    'entry.excerpt': entry.excerpt ?? '',\n    'entry.body': entry.body ?? '',\n    'entry.coverImage': entry.coverImage ?? '',\n    // The featured video (AGL-2956), raw like the cover: a template binds it\n    // into a Video element's source, and the element resolves a reference\n    // against the site rendering it.\n    'entry.coverVideo': entry.coverVideo ?? '',\n    'entry.slug': entry.slug ?? '',\n    'entry.url': `/${slug}/${entry.slug ?? ''}`,\n    // Which section this entry belongs to (AGL-2518). Worth binding only on a\n    // listing that MIXES collections — the author page — where a card\n    // otherwise gives a reader no way to tell a release note from an essay.\n    'entry.collection': (entry.collectionName ?? '').trim(),\n    'entry.collectionSlug': slug,\n    'entry.collectionUrl': slug ? `/${slug}` : '',\n    'entry.date': meta.date,\n    // The same instant for a parser (AGL-2956). `entry.date` is written for a\n    // reader, so a Video element's publication date bound to it publishes an\n    // `uploadDate` no crawler can read; this one is an ISO date-time.\n    'entry.publishedAt': collectionEntryPublishedAtIso(entry.publishedAt),\n    // The byline (AGL-1459). Bindable by hand for the same reason every other\n    // field is: a template that wants it somewhere Entry Meta does not reach.\n    'entry.author': meta.author,\n    // The rest of the author RECORD (AGL-2486). Bindable by hand for the\n    // same reason `entry.author` is: a card laid out by the designer rather\n    // than dropped as the Entry Author block still has to say who wrote the\n    // piece, and typing the blurb in as literal text is how a byline starts\n    // naming the wrong person.\n    'entry.authorBio': author.bio,\n    'entry.authorImage': author.image,\n    'entry.authorUrl': author.url,\n    /**\n     * This author's page on this site (AGL-2518) — \"more from the person who\n     * wrote this\".\n     *\n     * A separate token from `entry.authorUrl`, which is the author's own site,\n     * because they are different destinations and a template should be able to\n     * offer either or both. Empty when there is nothing addressable, so a\n     * binding renders no link rather than one pointing at `/author/`.\n     */\n    'entry.authorPageUrl': contentAuthorPageUrl({\n      ...(entry.author ? { author: entry.author } : {}),\n      ...(entry.authorId ? { authorId: entry.authorId } : {}),\n      ...(entry.authorName ? { authorName: entry.authorName } : {}),\n    }),\n    // Entry model v2 (AGL-582): taxonomy + SEO tokens. The SEO pair falls\n    // back to title/excerpt so templates can bind them unconditionally.\n    'entry.category': meta.category,\n    'entry.tags': meta.tags,\n    'entry.seoTitle': entry.seoTitle || entry.title || '',\n    'entry.seoDescription': entry.seoDescription || entry.excerpt || '',\n  }\n}\n\n/**\n * Category/tag membership check (AGL-582), shared by the Collection entries\n * filter props and the query-less list surfaces. Matching is trimmed and\n * case-insensitive — editors type these by hand. A category filter matches\n * either the entry's stable `categoryId` or its RESOLVED display name (id\n * lookup first, legacy string fallback), so filters written against either\n * spelling keep working across the taxonomy migration.\n */\nexport function entryMatchesFilter(\n  entry: CollectionEntryRecord,\n  filter: { category?: string; tag?: string },\n  categories?: CollectionCategory[],\n): boolean {\n  const normalize = (value: string) => value.trim().toLowerCase()\n  if (filter.category) {\n    const wanted = normalize(filter.category)\n    const matchesId =\n      Boolean((entry.categoryId ?? '').trim()) &&\n      normalize(entry.categoryId ?? '') === wanted\n    const matchesName =\n      normalize(resolveEntryCategoryName(entry, categories) ?? '') === wanted\n    if (!matchesId && !matchesName) return false\n  }\n  if (filter.tag) {\n    const wanted = normalize(filter.tag)\n    if (!(entry.tags ?? []).some((tag) => normalize(tag) === wanted)) {\n      return false\n    }\n  }\n  return true\n}\n\n/* ── Category routes (AGL-1321) ─────────────────────────────────────────── */\n\n/**\n * URL form of a category id or display name (AGL-1321): lowercase, runs of\n * non-alphanumerics collapsed to a single `-`, no leading/trailing dash.\n *\n * Deliberately lossy and idempotent, so the same category addresses the same\n * URL whether the author typed the taxonomy id, the display name, or the URL\n * segment itself. `Open source` → `open-source` → `open-source`.\n */\nexport function collectionCategorySlug(value: string | undefined): string {\n  return String(value ?? '')\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n}\n\n/**\n * The taxonomy category a URL segment addresses (AGL-1321), matched on the\n * stable `id` OR the slugified display name — an author linking\n * `/blog/category/open-source` should not have to know which of the two the\n * data happens to store, and an `id` that survives a rename is exactly why\n * the taxonomy has one. `undefined` = the segment names no known category;\n * the caller renders an empty listing rather than crashing.\n */\nexport function resolveCollectionCategoryBySlug(\n  categories: readonly CollectionCategory[] | undefined,\n  slug: string | undefined,\n): CollectionCategory | undefined {\n  const wanted = collectionCategorySlug(slug)\n  if (!wanted) return undefined\n  return (categories ?? []).find(\n    (category) =>\n      collectionCategorySlug(category.id) === wanted ||\n      collectionCategorySlug(category.name) === wanted,\n  )\n}\n\n/**\n * The canonical URL of a collection listing (AGL-1321). ONE builder, because\n * the pills, the pager, the `<link rel=\"canonical\">`, the JSON-LD and the\n * sitemap must all agree on the shape or the filter quietly becomes a\n * duplicate-content generator.\n *\n * The unfiltered page-1 listing is the bare `/{collection}` — there is no\n * `/{collection}/category/all` and no `?category=all`, so \"All\" cannot become\n * a second address for the page that already exists.\n */\nexport function collectionListUrl(options: {\n  collectionSlug: string\n  categorySlug?: string | null\n  page?: number | null\n}): string {\n  const scoped = options.categorySlug\n    ? `/${options.collectionSlug}/${COLLECTION_CATEGORY_ROUTE_SEGMENT}/` +\n      collectionCategorySlug(options.categorySlug)\n    : `/${options.collectionSlug}`\n  const page = Number(options.page)\n  return Number.isFinite(page) && page > 1\n    ? `${scoped}/${COLLECTION_PAGE_ROUTE_SEGMENT}/${Math.floor(page)}`\n    : scoped\n}\n\n/** Where a listing's pager can go from here (AGL-1386). */\nexport interface CollectionPaginationLinks {\n  /** 1-based current page; 1 when the listing is unpaginated. */\n  page: number\n  /** Total pages in the CURRENT (possibly category-filtered) set. */\n  totalPages: number\n  /** The previous page's URL, or `''` on the first page. */\n  prevUrl: string\n  /** The next page's URL, or `''` on the last page. */\n  nextUrl: string\n}\n\n/**\n * Everything a pager needs for one listing (AGL-1386): which page it is on,\n * how many there are, and where prev/next go — through\n * {@link collectionListUrl}, so both links stay inside the category they are\n * paging rather than dumping the reader back onto the unfiltered list.\n *\n * **The edges resolve to the empty string, never to a URL.** No previous page\n * means `prevUrl` is `''`; no next page means `nextUrl` is `''`. That is what\n * lets an authored template bind these unconditionally: one static list screen\n * serves the bare listing, every `/page/{n}`, and every\n * `/category/{slug}` — and there is no runtime conditional to hide a link\n * with. A link whose href resolves to `''` renders as an inert placeholder of\n * the same element (AGL-1268/1357), which is the correct pager on page 1 of 1.\n *\n * ONE computation, because it has two consumers that must agree: the built-in\n * fallback pager's nodes and the `{{pagination.*}}` tokens an authored\n * template binds. A second derivation is how a fallback and a template start\n * disagreeing about which page they are on.\n */\nexport function collectionPaginationLinks(options: {\n  collectionSlug: string\n  categorySlug?: string | null\n  /** 1-based current page; anything unusable reads as page 1. */\n  page?: number | null\n  /** Total pages; anything unusable reads as a single page. */\n  totalPages?: number | null\n}): CollectionPaginationLinks {\n  const positive = (value: number | null | undefined): number => {\n    const parsed = Math.floor(Number(value))\n    return Number.isFinite(parsed) && parsed > 0 ? parsed : 1\n  }\n  const page = positive(options.page)\n  const totalPages = positive(options.totalPages)\n  const href = (n: number) =>\n    collectionListUrl({\n      collectionSlug: options.collectionSlug,\n      ...(options.categorySlug ? { categorySlug: options.categorySlug } : {}),\n      page: n,\n    })\n  return {\n    page,\n    totalPages,\n    prevUrl: page > 1 ? href(page - 1) : '',\n    nextUrl: page < totalPages ? href(page + 1) : '',\n  }\n}\n\n/** A content-collection path resolved to what it addresses (AGL-1321). */\nexport interface CollectionRoute {\n  collectionSlug: string\n  /** Set only for `/{collection}/{entry}`. */\n  entrySlug?: string\n  /** Set only for `/{collection}/category/{slug}[/page/{n}]`. */\n  categorySlug?: string\n  /** 1-based list page; always 1 for entry routes. */\n  page: number\n}\n\nconst POSITIVE_INTEGER = /^[1-9]\\d*$/\n\n/**\n * Parses a non-screen path against the content-collection route shapes\n * (AGL-81/620/1321), or `null` when it is none of them and the caller should\n * fall through to the 404 chain:\n *\n * ```\n * /{collection}                                list, page 1, all categories\n * /{collection}/{entry}                        one entry\n * /{collection}/page/{n}                       list page n\n * /{collection}/category/{slug}                filtered list, page 1\n * /{collection}/category/{slug}/page/{n}       filtered list, page n\n * ```\n *\n * Pure, and shared by the tenant loader and its tests, because the route\n * table IS the ISR cache key here: the tenant catch-all caches by PATH, so a\n * listing variant that lives in the path gets its own cache entry for free,\n * while one that lived in a query string would share `/blog`'s entry and\n * serve one category's HTML for another.\n */\nexport function parseCollectionRoute(\n  segments: readonly string[],\n): CollectionRoute | null {\n  const [collectionSlug, ...rest] = segments\n  if (!collectionSlug) return null\n  if (!rest.length) return { collectionSlug, page: 1 }\n  if (rest.length === 1) return { collectionSlug, entrySlug: rest[0], page: 1 }\n  if (rest.length === 2 && rest[0] === COLLECTION_PAGE_ROUTE_SEGMENT) {\n    return POSITIVE_INTEGER.test(rest[1])\n      ? { collectionSlug, page: Number(rest[1]) }\n      : null\n  }\n  if (rest.length === 2 && rest[0] === COLLECTION_CATEGORY_ROUTE_SEGMENT) {\n    const categorySlug = collectionCategorySlug(rest[1])\n    return categorySlug ? { collectionSlug, categorySlug, page: 1 } : null\n  }\n  if (\n    rest.length === 4 &&\n    rest[0] === COLLECTION_CATEGORY_ROUTE_SEGMENT &&\n    rest[2] === COLLECTION_PAGE_ROUTE_SEGMENT &&\n    POSITIVE_INTEGER.test(rest[3])\n  ) {\n    const categorySlug = collectionCategorySlug(rest[1])\n    return categorySlug\n      ? { collectionSlug, categorySlug, page: Number(rest[3]) }\n      : null\n  }\n  return null\n}\n\n/**\n * Does this entry belong to the category a URL segment addresses (AGL-1321)?\n *\n * Every spelling the route could plausibly mean is slugified into one set and\n * checked against both of the entry's own spellings — the stable `categoryId`\n * and the RESOLVED display name. So `/blog/category/open-source` answers for\n * a taxonomy whose id is `opensource`, for one whose id is opaque but whose\n * name is \"Open source\", and for a legacy free-typed entry that predates the\n * taxonomy entirely. `entryMatchesFilter` cannot stand in: it compares raw\n * trimmed strings, so it would miss every multi-word category name.\n */\nexport function entryMatchesCategoryRoute(\n  entry: CollectionEntryRecord,\n  route: { slug: string; category?: CollectionCategory },\n  categories?: readonly CollectionCategory[],\n): boolean {\n  const wanted = new Set(\n    [route.slug, route.category?.id, route.category?.name]\n      .map((value) => collectionCategorySlug(value))\n      .filter(Boolean),\n  )\n  if (!wanted.size) return false\n  const entryId = collectionCategorySlug(entry.categoryId)\n  if (entryId && wanted.has(entryId)) return true\n  const entryName = collectionCategorySlug(\n    resolveEntryCategoryName(entry, categories),\n  )\n  return Boolean(entryName) && wanted.has(entryName)\n}\n\n/** One category pill as stamped onto a Category Pills block (AGL-1321). */\nexport interface CollectionCategoryLink {\n  label: string\n  href: string\n  /** The pill for the listing currently being rendered. */\n  active: boolean\n}\n\n/** Label the unfiltered pill carries when the author never named one. */\nexport const COLLECTION_ALL_PILL_DEFAULT = 'All'\n\n/**\n * The value that persists \"no All pill\" (AGL-1336).\n *\n * The attribute documented \"clear it to omit that pill\" and could not do it:\n * the attributes form strips an emptied text field's KEY (ddf maps an\n * emptied field to its `clearedValue`, final-form's default parse turns\n * `''` into `undefined`, and `updateNodeProps` replaces the props object),\n * so the absent key took {@link COLLECTION_ALL_PILL_DEFAULT} and the pill\n * came straight back. `''` is therefore not a value this field can hold —\n * the same AGL-1191 trap that made the App Bar's \"Default\" unpersistable.\n *\n * So the field carries this as its `clearedValue`: clearing the box writes\n * the word `none`, which survives the round trip and is honoured here.\n * Deliberately a readable word rather than a magic character — an author who\n * reopens the panel sees `none` in the All-label box and can read what it\n * did. Removing the prop entirely (the ✕ affordance) still means \"unset\",\n * and restores the default.\n */\nexport const COLLECTION_ALL_PILL_NONE = 'none'\n\n/**\n * What the unfiltered pill should be labelled, or `''` to omit it — the ONE\n * place the {@link COLLECTION_ALL_PILL_NONE} sentinel is interpreted\n * (AGL-1336). Matched case-insensitively on the trimmed value, because the\n * sentinel is typed by a human only when they are re-entering it by hand.\n *\n * `undefined` is UNSET and takes the default. `null` is CLEARED and omits —\n * it reaches here only from a hand-edited or imported document, but the two\n * are different questions and must not collapse into one answer.\n */\nexport function resolveCollectionAllLabel(value?: string | null): string {\n  if (value === undefined) return COLLECTION_ALL_PILL_DEFAULT\n  if (value === null) return ''\n  const text = `${value}`.trim()\n  if (!text) return ''\n  return text.toLowerCase() === COLLECTION_ALL_PILL_NONE ? '' : text\n}\n\n/**\n * The pill row for a collection (AGL-1321): \"All\" pointing at the canonical\n * unfiltered listing, then one pill per taxonomy category.\n *\n * Each pill addresses its category by the STABLE id where there is one, so a\n * rename moves the label without breaking the link. Active state is decided\n * through the same resolver the route used, not by string equality, because\n * the URL may legitimately have named the category by either spelling.\n */\nexport function buildCollectionCategoryLinks(options: {\n  collectionSlug: string\n  categories?: readonly CollectionCategory[]\n  activeCategorySlug?: string\n  /**\n   * Label for the unfiltered pill. Absent takes the default; `''` or the\n   * {@link COLLECTION_ALL_PILL_NONE} sentinel omits the pill.\n   */\n  allLabel?: string | null\n}): CollectionCategoryLink[] {\n  const { collectionSlug } = options\n  const active = collectionCategorySlug(options.activeCategorySlug)\n  const links: CollectionCategoryLink[] = []\n  for (const category of options.categories ?? []) {\n    const idSlug = collectionCategorySlug(category.id)\n    const nameSlug = collectionCategorySlug(category.name)\n    const slug = idSlug || nameSlug\n    if (!slug) continue\n    links.push({\n      label: category.name,\n      href: collectionListUrl({ collectionSlug, categorySlug: slug }),\n      active: Boolean(active) && (idSlug === active || nameSlug === active),\n    })\n  }\n  // A lone \"All\" pill is not a filter, it is decoration — a collection with\n  // no taxonomy gets no row at all.\n  if (!links.length) return []\n  const allLabel = resolveCollectionAllLabel(options.allLabel)\n  return allLabel\n    ? [\n        {\n          label: allLabel,\n          href: collectionListUrl({ collectionSlug }),\n          active: !active,\n        },\n        ...links,\n      ]\n    : links\n}\n\n/**\n * The matchable text a search box holds for a set of entries (AGL-1516),\n * built ONCE for both blocks that carry one — the entries block's in-place\n * filter and the standalone toolbar box (AGL-1516, Figma 494:1220).\n *\n * Shared rather than copied for the same reason\n * {@link COLLECTION_SEARCH_FUSE_OPTIONS} is: the two boxes can sit on the\n * same page, over the same collection, and a reader who sees a suggestion in\n * one and a miss in the other has been told the site is broken. Two builders\n * is how the row's date, chip and link drift apart.\n *\n * The row's link, date and category are resolved HERE, where the entry still\n * exists — a component only holds rendered markup by the time it runs, and\n * the suggestion panel draws its rows from this index rather than from the\n * clones. Through the same three resolvers Related posts uses (AGL-1926 for\n * the date especially): a suggestion for a post is the same post as the card\n * below it and must not be able to disagree with it about its date.\n */\nexport function buildCollectionSearchIndex(\n  entries: readonly CollectionEntryRecord[],\n  collectionSlug: string,\n  categories?: readonly CollectionCategory[],\n): CollectionEntrySearchItem[] {\n  return entries.map((entry): CollectionEntrySearchItem => {\n    const categoryName = resolveEntryCategoryName(entry, categories)\n    return {\n      title: entry.title ?? '',\n      excerpt: entry.excerpt ?? '',\n      // Absent keys rather than empty strings, so the row asks one question\n      // per field instead of two — the shape Related posts settled on\n      // (AGL-1457).\n      // The entry's own collection wins over the passed one, as in\n      // `collectionEntryTokens` and for the same reason (AGL-2518): a mixed\n      // listing's search index must not send every hit to one collection.\n      ...(entry.slug\n        ? {\n            url: `/${(entry.collectionSlug ?? '').trim() || collectionSlug}/${\n              entry.slug\n            }`,\n          }\n        : {}),\n      ...(entry.publishedAt?.seconds\n        ? { date: formatCollectionEntryDate(entry.publishedAt) }\n        : {}),\n      ...(categoryName ? { category: categoryName } : {}),\n    }\n  })\n}\n\n/**\n * The collection blocks that can be BOUND to a collection by name, rather\n * than inheriting the routed one.\n *\n * The same three `scanCollectionBlocks` resolves a source for, and the same\n * three that can therefore put a collection's entries on a page that is not\n * one of the collection's own routes — a \"Latest posts\" rail on the home\n * page, a category pill strip in a layout's chrome, a search box in a header.\n *\n * Related posts is deliberately absent. It resolves against the routed\n * collection and renders nothing without a current entry in context, so it\n * only ever appears on an entry page, which the entry's own address already\n * covers.\n */\nconst COLLECTION_BOUND_COMPONENT_IDS: readonly string[] = [\n  COLLECTION_ENTRIES_COMPONENT_ID,\n  COLLECTION_CATEGORIES_COMPONENT_ID,\n  COLLECTION_SEARCH_COMPONENT_ID,\n]\n\n/**\n * Does this tree render the collection `collectionSlug` away from the\n * collection's own routes?\n *\n * The content twin of {@link nodesPlaceForm}, and it exists for the same\n * reason: an entry edit changes every page that renders the collection, and\n * those pages are found by SEARCHING node trees rather than by matching a\n * pointer. A collection's own addresses are derivable from its slug; a rail\n * on the home page is not derivable from anything.\n *\n * Matches only an EXPLICIT `collectionSlug`. A block that names none inherits\n * the routed collection — which means it renders nothing at all off-route\n * (`scanCollectionBlocks` adds no slug, so the block is left untouched) and\n * renders the routed collection on-route, where the collection's own list and\n * entry addresses already reach it. Treating an unbound block as a dependent\n * of every collection on the site would make every entry save drop every page\n * that carries one.\n *\n * The comparison is against the slug rather than the document id because that\n * is what the binding stores, and what `scanCollectionBlocks` resolves. A\n * collection whose slug was just changed is a different question, and one the\n * slug change itself has to answer.\n */\nexport function nodesRenderCollection(\n  nodes: Record<NodeId, AglynNodeSchema | undefined> | undefined | null,\n  collectionSlug: string,\n): boolean {\n  const wanted = String(collectionSlug ?? '').trim()\n  if (!wanted) return false\n  for (const node of Object.values(nodes ?? {})) {\n    if (!node) continue\n    if (!COLLECTION_BOUND_COMPONENT_IDS.includes(String(node.componentId))) {\n      continue\n    }\n    const bound = (node.props as Record<string, unknown> | undefined)?.[\n      'collectionSlug'\n    ]\n    if (typeof bound === 'string' && bound.trim() === wanted) return true\n  }\n  return false\n}\n\n/**\n * Collection entries blocks (AGL-551): a `collectionEntries` container\n * treats its children as the item template and renders them once per\n * published entry, with `{{entry.*}}` tokens in cloned string props replaced\n * per entry — the content-collection sibling of {@link expandRepeatables}.\n *\n * - The block's collection resolves from its `collectionSlug` prop, falling\n *   back to `defaultSlug` (the routed collection on list-template screens).\n * - Clone ids are namespaced `centry__{containerId}__{index}__…` so repeats\n *   never collide; run AFTER grafting and BEFORE binding resolution.\n * - Rows are bounded by `props.entriesLimit` and\n *   {@link COLLECTION_ENTRIES_MAX}.\n * - `props.firstPageOnly` renders zero rows past page 1 of the ROUTED\n *   listing (AGL-1871), so a lead card does not repeat down the pagination.\n * - An UNKNOWN collection leaves the node untouched (fail-open: a renamed\n *   collection must never take a screen down). A known collection with no\n *   matching entries renders zero rows — never the unsubstituted template.\n * - Inputs are never mutated; template nodes stay in the map unreferenced.\n */\nexport function expandCollectionEntries<\n  N extends AglynNodeSchema = AglynNodeSchema,\n>(\n  nodes: Record<NodeId, N>,\n  sourcesBySlug: Record<string, CollectionEntriesSource | undefined>,\n  defaultSlug?: string,\n): Record<NodeId, N> {\n  const containers = Object.entries(nodes).filter(\n    ([, node]) => node?.componentId === COLLECTION_ENTRIES_COMPONENT_ID,\n  )\n  if (!containers.length) return nodes\n\n  const next: Record<NodeId, N> = { ...nodes }\n  for (const [containerId, container] of containers) {\n    const slug =\n      String((container.props as any)?.collectionSlug ?? '').trim() ||\n      defaultSlug\n    const source = slug ? sourcesBySlug[slug] : undefined\n    // An UNKNOWN collection leaves the node untouched — fail-open, so a\n    // renamed collection never takes a published screen down.\n    //\n    // A KNOWN collection with nothing to show is a different question, and\n    // used to get the same answer (AGL-1321). Leaving the template in place\n    // renders it once, with its `{{entry.title}}` / `{{entry.url}}` tokens\n    // never substituted, so the page shipped a ghost row of literal braces.\n    // That was rare while the only way to empty a list was to publish an\n    // empty collection; a category filter makes it reachable from any pill\n    // whose category has no posts yet. Zero entries now means zero rows.\n    if (!source) continue\n    const limitRaw = Number((container.props as any)?.entriesLimit)\n    const limit =\n      Number.isFinite(limitRaw) && limitRaw > 0\n        ? Math.min(limitRaw, COLLECTION_ENTRIES_MAX)\n        : COLLECTION_ENTRIES_MAX\n\n    // Pagination (AGL-620): when `perPage` is set the block renders one page\n    // window `[(page-1)*perPage, page*perPage)`; without it, the legacy\n    // `entriesLimit` slice from the top applies unchanged.\n    const perPageRaw = Number((container.props as any)?.perPage)\n    const perPage =\n      Number.isFinite(perPageRaw) && perPageRaw > 0\n        ? Math.min(Math.floor(perPageRaw), COLLECTION_ENTRIES_MAX)\n        : undefined\n    // The block's own `page` wins; otherwise the ROUTE's page applies, so\n    // `/blog/page/2` and `/blog/category/guides/page/2` render page 2 of a\n    // template listing instead of silently re-serving page 1 at a second URL\n    // (AGL-1321). Only ever the routed collection: `source.page` is set\n    // nowhere else.\n    const pageRaw = Number((container.props as any)?.page)\n    const routedPage = Number(source.page)\n    const page =\n      Number.isFinite(pageRaw) && pageRaw >= 1\n        ? Math.floor(pageRaw)\n        : Number.isFinite(routedPage) && routedPage >= 1\n          ? Math.floor(routedPage)\n          : 1\n    // \"Only on page 1\" (AGL-1871): a LEAD block takes the top of the set and\n    // has no page window of its own, so on `/blog/page/2` it repeats exactly\n    // what page 1 led with — same cover, same title, same excerpt — above a\n    // page of different posts, under an eyebrow that reads \"Latest\". True on\n    // page 1, false everywhere after it.\n    //\n    // Opt-in and default off. The alternative reading — \"a block with no\n    // `perPage` on a paginated route is a lead block\" — is wrong: a \"popular\n    // posts\" rail is the same shape and belongs on every page of the listing.\n    // Only the author knows which one they built, so the author says so.\n    //\n    // Gated on the ROUTE's page, never on the block's own pinned `page`. A\n    // block that names its own page is a deliberately fixed window (\"the\n    // entries page 3 would show, here\"), which says nothing about which page\n    // of the listing the reader is on; and off a routed listing entirely\n    // (a blog rail on the homepage) `source.page` is unset, so the switch\n    // correctly hides nothing.\n    const firstPageOnly = Boolean((container.props as any)?.firstPageOnly)\n    const suppressedBeyondFirstPage =\n      firstPageOnly && Number.isFinite(routedPage) && routedPage > 1\n\n    const templateIds = Array.isArray(container.nodes)\n      ? (container.nodes as NodeId[])\n      : []\n    if (!templateIds.length) continue\n\n    // Category/tag filter props (AGL-582): the block-level answer to\n    // /blog?tag=x — query params never reach the ISR-cached loader, so\n    // filtered lists are designed as filtered BLOCKS instead.\n    const filterCategory = String(\n      (container.props as any)?.filterCategory ?? '',\n    ).trim()\n    const filterTag = String(\n      (container.props as any)?.filterTag ?? '',\n    ).trim()\n    const filtered =\n      filterCategory || filterTag\n        ? source.entries.filter((entry) =>\n            entryMatchesFilter(\n              entry,\n              {\n                category: filterCategory || undefined,\n                tag: filterTag || undefined,\n              },\n              source.categories,\n            ),\n          )\n        : source.entries\n    // Whether the READ behind `source.entries` reached its own bound\n    // (AGL-1516). Taken off the raw set, never off `filtered`: a block-level\n    // category filter legitimately narrows a complete read, and a narrowed\n    // set is not a bounded one. The source's own `reachedBound` wins over\n    // counting it, because the count cannot see a read that came back full\n    // and was then thinned by the liveness gate.\n    const sourceCapped = collectionSourceIsBounded(source)\n\n    const windowed = suppressedBeyondFirstPage\n      ? []\n      : perPage\n        ? filtered.slice((page - 1) * perPage, (page - 1) * perPage + perPage)\n        : filtered.slice(0, limit)\n\n    const childIds: NodeId[] = []\n    windowed.forEach((entry, index) => {\n      const prefix = `${COLLECTION_ENTRIES_NODE_ID_PREFIX}${containerId}__${index}__`\n      const prefixId = (id: NodeId) => `${prefix}${id}`\n      const cloned: Record<NodeId, N> = {}\n      const cloneSubtree = (id: NodeId, parentId: NodeId) => {\n        const node = nodes[id]\n        if (!node) return\n        const clonedChildren = Array.isArray(node.nodes)\n          ? (node.nodes as NodeId[])\n          : undefined\n        cloned[prefixId(id)] = {\n          ...node,\n          $id: prefixId(id),\n          parentId,\n          ...(clonedChildren && {\n            nodes: clonedChildren.map((childId) => prefixId(childId)),\n          }),\n        }\n        clonedChildren?.forEach((childId) =>\n          cloneSubtree(childId, prefixId(id)),\n        )\n      }\n      for (const templateId of templateIds) {\n        cloneSubtree(templateId, containerId)\n        childIds.push(prefixId(templateId))\n      }\n      // Fill the entry blocks in THIS card from THIS card's entry (AGL-2486).\n      //\n      // The routed-entry passes (`expandCollectionEntryMeta`,\n      // `expandCollectionEntryAuthor`) skip clones deliberately: stamping the\n      // routed entry into a listing would date every card the same. That left\n      // a cloned block with only its `{{entry.*}}` bindings, and a binding\n      // carries no FORMAT — so an Entry Meta inside a card rendered the locale\n      // default whatever its Date format said, while the identical block on\n      // the article above it obeyed the picker. A field that cannot move the\n      // thing it names is worse than a missing one.\n      //\n      // The fill runs against each clone's own entry, so every card dates\n      // itself, and it runs BEFORE substitution so a filled value is already\n      // a literal by the time the tokens resolve. The precedence is the\n      // shared one: an authored value wins, except the `{{entry.date}}`\n      // binding under a chosen format, which is the case this exists for.\n      for (const [cloneId, cloneNode] of Object.entries(cloned)) {\n        const fill =\n          cloneNode?.componentId === COLLECTION_ENTRY_META_COMPONENT_ID\n            ? entryMetaFill(cloneNode, entry, source.categories)\n            : cloneNode?.componentId === COLLECTION_ENTRY_AUTHOR_COMPONENT_ID\n              ? entryAuthorFill(cloneNode, entry)\n              : undefined\n        if (!fill || !Object.keys(fill).length) continue\n        cloned[cloneId] = {\n          ...cloneNode,\n          props: { ...(cloneNode.props ?? {}), ...fill },\n        } as N\n      }\n      Object.assign(\n        next,\n        resolveNamedTokens(\n          cloned,\n          collectionEntryTokens(entry, source.slug, source.categories),\n        ),\n      )\n    })\n    // Search (AGL-1516): the block's search box filters CLIENT-SIDE over the\n    // entries this expansion just rendered — the ISR-cached page is the whole\n    // data set, so no query ever goes back to Firestore. The component only\n    // holds cloned markup by render time, so the matchable text is stamped\n    // here, where the entries still exist, index-aligned with the clone\n    // groups. Stamped ONLY when the author enabled it: an untouched block's\n    // node — and its serialized payload — stays byte-identical.\n    const searchEnabled = Boolean((container.props as any)?.search)\n    next[containerId] = searchEnabled\n      ? {\n          ...container,\n          props: {\n            ...(container.props as any),\n            searchIndex: buildCollectionSearchIndex(\n              windowed,\n              source.slug,\n              source.categories,\n            ),\n            // How many entries the window above was drawn FROM (AGL-1516).\n            //\n            // The component has to tell the reader whether a miss means \"not\n            // here\" or \"not anywhere\", and it cannot work that out for\n            // itself: it sees `perPage`, but `perPage` is only one of three\n            // ways this block gets truncated. `entriesLimit` slices too, and\n            // so does COLLECTION_ENTRIES_MAX at 100. A block set to \"latest 6\n            // posts\" indexes 6 of 40 and, keyed off `perPage` alone, told the\n            // reader flatly that their post does not exist.\n            //\n            // Stamped as the COUNT rather than as a `truncated` verdict, so\n            // the component decides the wording and this stays a fact. It is\n            // the post-filter total — a category-filtered block searches its\n            // category, and \"the rest of the collection\" means the rest of\n            // what this block would otherwise show.\n            searchTotal: filtered.length,\n            // And whether `searchTotal` is itself a ceiling (AGL-1516).\n            //\n            // `source.entries` is a READ, and that read is bounded — the\n            // tenant fetches a collection's live entries with a hard\n            // `.limit(100)` and no `orderBy`. On a collection past that bound\n            // `filtered.length` reports the bound, not the collection, so\n            // `searchIndex.length === searchTotal` — the test the component\n            // reads as \"this block holds the whole set\" — is satisfied by a\n            // block that holds 100 of 400 posts. The completeness claim is\n            // the one thing a truncated read must never be allowed to make:\n            // \"no matches\" over a quarter of a collection is a confident lie\n            // about the other three quarters.\n            //\n            // A fact, like the count beside it: \"the read that produced this\n            // index reached its bound\". A collection of exactly 100 sets it\n            // too, and is described one notch more cautiously than it needed\n            // to be — which is the safe direction, and the only one available\n            // without a second count query.\n            ...(sourceCapped ? { searchCapped: true } : {}),\n          },\n          nodes: childIds,\n        }\n      : { ...container, nodes: childIds }\n  }\n  return next\n}\n\n/**\n * Category Pills blocks (AGL-1321): stamps each `collectionCategories` node\n * with its collection's pill row as a serializable `items` prop the component\n * renders as real anchors — the same server-stamped shape Related posts uses,\n * and for the same reason: the block owns its markup, so there is no template\n * to clone.\n *\n * `activeCategorySlug` marks a pill only on the ROUTED collection. A pills\n * block pointing at some other collection is not what this URL filters, so\n * marking one of its pills current would be a lie in the HTML.\n *\n * A collection with no taxonomy leaves its block untouched, so the component's\n * besigner affordance / empty site render applies. Inputs are never mutated.\n */\nexport function expandCollectionCategories<\n  N extends AglynNodeSchema = AglynNodeSchema,\n>(\n  nodes: Record<NodeId, N>,\n  sourcesBySlug: Record<string, CollectionEntriesSource | undefined>,\n  defaultSlug?: string,\n  activeCategorySlug?: string,\n): Record<NodeId, N> {\n  const containers = Object.entries(nodes).filter(\n    ([, node]) => node?.componentId === COLLECTION_CATEGORIES_COMPONENT_ID,\n  )\n  if (!containers.length) return nodes\n\n  const next: Record<NodeId, N> = { ...nodes }\n  for (const [containerId, container] of containers) {\n    const slug =\n      String((container.props as any)?.collectionSlug ?? '').trim() ||\n      defaultSlug\n    const source = slug ? sourcesBySlug[slug] : undefined\n    if (!source) continue\n    const allLabel = (container.props as any)?.allLabel\n    const items = buildCollectionCategoryLinks({\n      collectionSlug: source.slug,\n      categories: source.categories,\n      ...(slug === defaultSlug ? { activeCategorySlug } : {}),\n      // Absent means \"never set\" and takes the default; `null` is a cleared\n      // value and is forwarded AS null, because `String(null)` would have\n      // labelled the pill \"null\" (AGL-1336).\n      ...(allLabel === undefined\n        ? {}\n        : { allLabel: allLabel === null ? null : String(allLabel) }),\n    })\n    if (!items.length) continue\n    next[containerId] = {\n      ...container,\n      props: { ...(container.props as any), items },\n    }\n  }\n  return next\n}\n\n/**\n * Collection Search blocks (AGL-1516): stamps each `collectionSearch` node\n * with its collection's search index, the size of the set that index was\n * drawn from, and whether that set was a bounded read — the same\n * server-stamped shape Category Pills and Related posts use, and for the same\n * reason: the block owns its markup, so there is no template to clone.\n *\n * Indexes the WHOLE source rather than a page window. The entries block's box\n * searches the entries that block rendered because it filters them in place;\n * a toolbar box filters nothing and suggests, so scoping it to one page of a\n * listing would be an arbitrary cut nobody asked for. What it can honestly\n * cover is the set the page's listing is drawn from — which on a category\n * route is that category, because `source.entries` arrives filtered.\n *\n * Clones are SKIPPED by their `centry__` prefix: a search box inside an entry\n * template would otherwise be stamped once per card. Nodes are never mutated,\n * and a collection with no entries leaves its block untouched, so the\n * component's besigner affordance and its empty site render both stand.\n */\nexport function expandCollectionSearch<\n  N extends AglynNodeSchema = AglynNodeSchema,\n>(\n  nodes: Record<NodeId, N>,\n  sourcesBySlug: Record<string, CollectionEntriesSource | undefined>,\n  defaultSlug?: string,\n): Record<NodeId, N> {\n  const containers = Object.entries(nodes).filter(\n    ([id, node]) =>\n      node?.componentId === COLLECTION_SEARCH_COMPONENT_ID &&\n      !id.startsWith(COLLECTION_ENTRIES_NODE_ID_PREFIX),\n  )\n  if (!containers.length) return nodes\n\n  const next: Record<NodeId, N> = { ...nodes }\n  for (const [containerId, container] of containers) {\n    const slug =\n      String((container.props as any)?.collectionSlug ?? '').trim() ||\n      defaultSlug\n    const source = slug ? sourcesBySlug[slug] : undefined\n    // An unknown collection leaves the node untouched — fail-open, exactly as\n    // the entries and pills blocks do, so a rename never takes a screen down.\n    if (!source) continue\n    // A collection with nothing published gets no box. A search field over an\n    // empty index can only ever answer \"no matches\", which reads as a fact\n    // about the reader's query rather than about the empty collection it\n    // really describes.\n    if (!source.entries.length) continue\n    next[containerId] = {\n      ...container,\n      props: {\n        ...(container.props as any),\n        searchIndex: buildCollectionSearchIndex(\n          source.entries,\n          source.slug,\n          source.categories,\n        ),\n        searchTotal: source.entries.length,\n        ...(collectionSourceIsBounded(source) ? { searchCapped: true } : {}),\n      },\n    }\n  }\n  return next\n}\n\n/**\n * Entry Meta blocks (AGL-1385): stamps each `collectionEntryMeta` node with\n * the routed entry's date, category and tags — the same server-stamped shape\n * Category Pills and Related posts already use.\n *\n * MEASURED on the live marketing blog, which is what this fixes. The block was\n * on `blogEntryTmpl` carrying props `{showDate: true, showCategory: true,\n * showTags: true}` and NOTHING else, and rendered as an empty `<div>` at height\n * 0 — while the very same entry's `<pubDate>` and `Guides` category appeared in\n * its feed item, its JSON-LD, and a heading two nodes above it. So the data was\n * never missing; the block simply had nothing bound to it.\n *\n * The design is what made that reachable. Every other collection block sources\n * itself; this one required the author to type `{{entry.date}}` into a text\n * field. Only the PRESET seeds those tokens — drag the bare component out of\n * the palette and you get three switches labelled \"Show date / Show category /\n * Show tags\", all defaulting to on, gating values that can never exist. That is\n * an affordance promising something the component cannot deliver, so this is a\n * defect in the block and not in anyone's content, and it hits every collection\n * that uses it, not just blog.\n *\n * Deliberately narrow:\n *\n *  - An AUTHORED value always wins. Only an absent or blank prop is filled, so\n *    a hand-typed byline, a pinned string, or a `{{entry.*}}` token still\n *    awaiting substitution is never overwritten. (Blank counts as unset\n *    because a cleared text field cannot persist `''` anyway — AGL-1336. The\n *    way to hide a value is the switch that exists for it.)\n *  - Nodes cloned per entry by {@link expandCollectionEntries} are SKIPPED by\n *    their `centry__` id prefix. Their tokens resolve per clone; stamping the\n *    routed entry into them would date every card in a listing the same.\n *  - Without a routed entry — a list route, a plain screen — nothing is\n *    stamped, so the besigner affordance and the empty site render stand.\n *\n * `dateFormat` (AGL-1459) is answered here, where the timestamp still exists,\n * and is the ONE exception to \"an authored value always wins\" — narrowly, and\n * only for the literal `{{entry.date}}` binding. That binding is what the\n * block's own preset seeds, so a format that filled blanks only would do\n * nothing on the exact surface it was built for. The token is not a hand-typed\n * override; it NAMES the value being reformatted. A literal string an author\n * typed still wins, unchanged.\n *\n * Inputs are never mutated.\n */\nexport function expandCollectionEntryMeta<\n  N extends AglynNodeSchema = AglynNodeSchema,\n>(\n  nodes: Record<NodeId, N>,\n  entry: CollectionEntryRecord | null | undefined,\n  categories?: readonly CollectionCategory[],\n): Record<NodeId, N> {\n  if (!entry) return nodes\n  const containers = Object.entries(nodes).filter(\n    ([id, node]) =>\n      node?.componentId === COLLECTION_ENTRY_META_COMPONENT_ID &&\n      !id.startsWith(COLLECTION_ENTRIES_NODE_ID_PREFIX),\n  )\n  if (!containers.length) return nodes\n\n  const next: Record<NodeId, N> = { ...nodes }\n  for (const [containerId, container] of containers) {\n    const filled = entryMetaFill(container, entry, categories)\n    if (!Object.keys(filled).length) continue\n    next[containerId] = {\n      ...container,\n      props: { ...(container.props ?? {}), ...filled } as any,\n    }\n  }\n  return next\n}\n\n/**\n * The values ONE Entry Meta node takes from ONE entry (AGL-2486).\n *\n * Extracted so a node inside a listing's card can be filled from the entry\n * that card is for, which is a different entry per clone and therefore\n * cannot come from the routed-entry pass above. Both callers apply the same\n * precedence, because the same block cannot mean two things depending on\n * where an author dropped it.\n *\n * Returns only the keys that change; an empty object means \"leave this node\n * exactly as authored\".\n */\nfunction entryMetaFill(\n  container: { props?: unknown },\n  entry: CollectionEntryRecord,\n  categories?: readonly CollectionCategory[],\n): Record<string, string> {\n  {\n    const props = (container.props ?? {}) as Record<string, unknown>\n    // Per node: the format is a prop, so two blocks on one template can read\n    // their dates differently.\n    const dateFormat = normalizeCollectionEntryDateFormat(props['dateFormat'])\n    const values = collectionEntryMetaValues(entry, categories, dateFormat)\n    const filled: Record<string, string> = {}\n    for (const key of ['date', 'author', 'category', 'tags'] as const) {\n      const authored = String(props[key] ?? '').trim()\n      if (authored && !reformattableEntryDate(key, authored, dateFormat)) {\n        continue\n      }\n      if (!values[key]) continue\n      filled[key] = values[key]\n    }\n    // The byline avatar follows the BYLINE, and is the second narrow\n    // exception to \"an authored value always wins\" (after `dateFormat`).\n    //\n    // `avatarImage` was introduced as a block-level pick because entries then\n    // carried a byline STRING and no portrait anywhere, so the site's brand\n    // mark chosen once on the template was the only answer available. Custom\n    // authors changed that: an entry resolves to a record, and a record has\n    // an `image`. Keeping the authored mark in front of it would print the\n    // company logo beside a named person — the wrong face, on every post that\n    // person wrote, which is worse than the generic mark it was standing in\n    // for.\n    //\n    // Deliberately narrow, so nothing else moves: only a resolved author\n    // RECORD that actually carries an image displaces the authored value. A\n    // legacy string byline, an author with no portrait, and an entry with no\n    // author at all all leave the template's mark exactly where it was.\n    //\n    // And only where a byline is actually PRINTED. This block is also the\n    // product's tag row — the article frame ends on one with `Show author`,\n    // `Show date` and `Show category` off and nothing but chips left — so a\n    // portrait filled in unconditionally lands beside the tags, halfway down\n    // the page from the byline it belongs to. The avatar is `alt=\"\"` on the\n    // grounds that \"the byline names the author in text right beside it\",\n    // which is exactly the thing a chips-only block does not have.\n    const authorImage = String(entry.author?.image ?? '').trim()\n    const bylineShown =\n      props['showAuthor'] !== false &&\n      Boolean(filled['author'] || String(props['author'] ?? '').trim())\n    if (authorImage && bylineShown && props['showAvatar'] !== false) {\n      filled['avatarImage'] = authorImage\n    }\n    /*\n      Where the byline GOES (AGL-2519).\n\n      Filled on the same terms as the avatar and for the same reason: it\n      belongs to the byline, so it is only filled where a byline is actually\n      printed. This block doubles as the product's tag row — the article frame\n      ends on one with the author, date and category all switched off — and a\n      link stamped there would have nothing to attach to.\n\n      An authored value still wins, which is what `Link author` off leaves\n      behind once the switch has written an explicit `false`: the switch is\n      read by the renderer, and this only supplies the destination.\n    */\n    if (bylineShown) {\n      const pageUrl = collectionEntryAuthorValues(entry).pageUrl\n      if (pageUrl && !String(props['authorPageUrl'] ?? '').trim()) {\n        filled['authorPageUrl'] = pageUrl\n      }\n    }\n    return filled\n  }\n}\n\n/**\n * Fill Entry Author cards from the routed entry's author record (AGL-2486),\n * on the same terms {@link expandCollectionEntryMeta} fills the byline:\n *\n *  - an authored value always wins, and a blank one is a blank, not a\n *    request for the default — the way to hide a field is its Show switch;\n *  - per-entry clones (`centry__`) are skipped, so a listing's cards keep\n *    resolving their own tokens rather than every card naming the routed\n *    entry's author;\n *  - without a routed entry nothing is stamped, which leaves the besigner's\n *    placeholder card visible on the canvas.\n *\n * Inputs are never mutated.\n */\nexport function expandCollectionEntryAuthor<\n  N extends AglynNodeSchema = AglynNodeSchema,\n>(\n  nodes: Record<NodeId, N>,\n  entry: CollectionEntryRecord | null | undefined,\n): Record<NodeId, N> {\n  if (!entry) return nodes\n  const containers = Object.entries(nodes).filter(\n    ([id, node]) =>\n      node?.componentId === COLLECTION_ENTRY_AUTHOR_COMPONENT_ID &&\n      !id.startsWith(COLLECTION_ENTRIES_NODE_ID_PREFIX),\n  )\n  if (!containers.length) return nodes\n\n  const next: Record<NodeId, N> = { ...nodes }\n  for (const [containerId, container] of containers) {\n    const filled = entryAuthorFill(container, entry)\n    if (!Object.keys(filled).length) continue\n    next[containerId] = {\n      ...container,\n      props: { ...(container.props ?? {}), ...filled } as any,\n    }\n  }\n  return next\n}\n\n/**\n * The values ONE Entry Author node takes from ONE entry (AGL-2486) — the\n * companion to {@link entryMetaFill}, extracted for the same reason: a card\n * inside a listing is filled from the entry that card is for.\n */\nfunction entryAuthorFill(\n  container: { props?: unknown },\n  entry: CollectionEntryRecord,\n): Record<string, unknown> {\n  const values = collectionEntryAuthorValues(entry)\n  const props = (container.props ?? {}) as Record<string, unknown>\n  const filled: Record<string, unknown> = {}\n  for (const key of ['name', 'bio', 'image', 'url', 'pageUrl'] as const) {\n    if (String(props[key] ?? '').trim()) continue\n    if (!values[key]) continue\n    filled[key] = values[key]\n  }\n  // `links` is not authorable as text — a row carries a platform or a picked\n  // icon, and the console's author editor is where those are chosen — so\n  // there is no authored value to defer to. The record's rows are the only\n  // ones there are; `Show links` is the template's control over them.\n  if (values.links.length) filled['links'] = values.links\n  return filled\n}\n\n/** The one binding a chosen date format may replace (AGL-1459). */\nconst ENTRY_DATE_BINDING = '{{entry.date}}'\n\n/**\n * Is this authored value the `{{entry.date}}` binding under a chosen format\n * (AGL-1459)? Anything else — a literal string, another token, the default\n * format — answers no, and the authored value stands.\n */\nfunction reformattableEntryDate(\n  key: string,\n  authored: string,\n  dateFormat: CollectionEntryDateFormat,\n): boolean {\n  return (\n    key === 'date' &&\n    authored === ENTRY_DATE_BINDING &&\n    dateFormat !== COLLECTION_ENTRY_DATE_FORMAT_DEFAULT\n  )\n}\n\n/**\n * The ONE matcher configuration behind every entry search in the product\n * (AGL-1516/AGL-1525) — the block's toolbar box, its suggestion panel, and\n * the site-wide results page the panel links to.\n *\n * Shared rather than copied because the two halves are joined by a link the\n * reader clicks: the panel's \"View all results\" hands its query to /search,\n * and if the results page matched more strictly it would answer a visible\n * suggestion with \"no results\". A typo the panel forgave — \"platfrom\" — is\n * exactly the query most likely to make that trip.\n *\n * The shape is the icon picker's (use-mdi-icons-fuzzy), tuned once for prose\n * and MEASURED before shipping: the title names the post and the excerpt\n * merely describes it, so they are weighted 0.7/0.3; the default location\n * scoring buries a legitimate mid-sentence hit in a sentence-long excerpt,\n * and the default 0.6 threshold matches \"media\" against every post on letter\n * soup, so location is ignored and the threshold tightened to 0.3.\n *\n * A plain object, not a Fuse instance: `libs/aglyn` is dependency-light by\n * design, and each consumer already imports Fuse from the vendor bundle.\n */\nexport const COLLECTION_SEARCH_FUSE_OPTIONS = {\n  keys: [\n    { name: 'title', weight: 0.7 },\n    { name: 'excerpt', weight: 0.3 },\n  ],\n  includeScore: true,\n  shouldSort: true,\n  ignoreLocation: true,\n  threshold: 0.3,\n}\n\n/**\n * One entry of a Collection Entries search index (AGL-1516): the fields the\n * block's client-side search box matches against, index-aligned with the\n * entry clones the block rendered. Stamped by {@link expandCollectionEntries}\n * only when the block's `search` prop is on; never set by hand.\n */\nexport interface CollectionEntrySearchItem {\n  title: string\n  excerpt: string\n  /**\n   * Entry permalink (AGL-1525). The `filter` mode never needs it — it hides\n   * and shows clones that already carry their own links — but a suggestion\n   * row IS the link, and the panel is drawn from the index, not from the\n   * clones. Optional because a page cached before this shipped has an index\n   * without it; the panel degrades to plain text rather than to a dead link.\n   */\n  url?: string\n  /** Published date, through {@link formatCollectionEntryDate} (AGL-1525). */\n  date?: string\n  /** Category display name for the suggestion row's chip (AGL-1525). */\n  category?: string\n}\n\n/** One related post as stamped onto a Related posts block (AGL-582). */\nexport interface CollectionRelatedItem {\n  title: string\n  url: string\n  date?: string\n  excerpt?: string\n  /** Per-entry byline (AGL-686); falls back to the site as author. */\n  authorName?: string\n  category?: string\n  /**\n   * The entry's cover, as STORED (AGL-1457) — a `media:` reference, a legacy\n   * URL, or a hotlink. Left unresolved on purpose: the block resolves it at\n   * render through `resolveMediaSrc`, exactly as the Image element does, so\n   * one reference keeps working across sites and CDN route changes.\n   */\n  coverImage?: string\n  /**\n   * The author's description of that cover (AGL-2418). Travels WITH\n   * `coverImage`, and absent means \"fall back to the title\" rather than\n   * \"silent\" — on this block the cover is the link's own content.\n   */\n  coverImageAlt?: string\n}\n\n/**\n * Related-post selection (AGL-582): other entries of the same collection\n * that share the current entry's category or at least one tag, newest\n * first. Pure so the compose stage and tests share one implementation. An\n * entry with no category and no tags relates to nothing — the caller\n * renders nothing rather than guessing.\n *\n * Two entries share a category when their stable `categoryId`s are equal\n * (survives renames AND deletions) or their RESOLVED display names match\n * case-insensitively — so a legacy free-typed entry still relates to a\n * migrated `categoryId` entry whose taxonomy name spells the same.\n */\nexport function selectRelatedEntries(\n  entries: CollectionEntryRecord[],\n  current: CollectionEntryRecord,\n  limit = COLLECTION_RELATED_DEFAULT_LIMIT,\n  categories?: CollectionCategory[],\n): CollectionEntryRecord[] {\n  const categoryId = (current.categoryId ?? '').trim()\n  const categoryName = (\n    resolveEntryCategoryName(current, categories) ?? ''\n  ).toLowerCase()\n  const tags = (current.tags ?? []).map((tag) => tag.trim()).filter(Boolean)\n  if (!categoryId && !categoryName && !tags.length) return []\n  const bounded = Math.min(\n    Math.max(limit, 0) || COLLECTION_RELATED_DEFAULT_LIMIT,\n    COLLECTION_RELATED_MAX,\n  )\n  return entries\n    .filter((entry) => {\n      if (\n        (entry.$id && entry.$id === current.$id) ||\n        (entry.slug && entry.slug === current.slug)\n      ) {\n        return false\n      }\n      if (categoryId && (entry.categoryId ?? '').trim() === categoryId) {\n        return true\n      }\n      if (\n        categoryName &&\n        (resolveEntryCategoryName(entry, categories) ?? '')\n          .trim()\n          .toLowerCase() === categoryName\n      ) {\n        return true\n      }\n      return tags.some((tag) => entryMatchesFilter(entry, { tag }))\n    })\n    .sort(\n      (a, b) => (b.publishedAt?.seconds ?? 0) - (a.publishedAt?.seconds ?? 0),\n    )\n    .slice(0, bounded)\n}\n\n/**\n * Related posts blocks (AGL-582): stamps each `collectionRelated` node with\n * the current entry's related posts as a serializable `entries` prop the\n * component renders directly (no template cloning — the block owns its\n * markup). Runs only on entry renders; without an entry context the nodes\n * stay untouched, so the component's sample cards (editing surfaces) or its\n * empty site render apply. Inputs are never mutated.\n */\nexport function expandCollectionRelated<\n  N extends AglynNodeSchema = AglynNodeSchema,\n>(\n  nodes: Record<NodeId, N>,\n  source: CollectionEntriesSource | undefined,\n  currentEntry: CollectionEntryRecord | null | undefined,\n): Record<NodeId, N> {\n  if (!source || !currentEntry) return nodes\n  const containers = Object.entries(nodes).filter(\n    ([, node]) => node?.componentId === COLLECTION_RELATED_COMPONENT_ID,\n  )\n  if (!containers.length) return nodes\n\n  const next: Record<NodeId, N> = { ...nodes }\n  for (const [containerId, container] of containers) {\n    const limitRaw = Number((container.props as any)?.limit)\n    // Per node, exactly as the byline reads it (AGL-1459): the format is a\n    // prop, so two rails on one template can date their cards differently.\n    const dateFormat = normalizeCollectionEntryDateFormat(\n      (container.props as any)?.dateFormat,\n    )\n    const related = selectRelatedEntries(\n      source.entries ?? [],\n      currentEntry,\n      Number.isFinite(limitRaw) && limitRaw > 0\n        ? limitRaw\n        : COLLECTION_RELATED_DEFAULT_LIMIT,\n      source.categories,\n    )\n    const items: CollectionRelatedItem[] = related.map((entry) => {\n      const categoryName = resolveEntryCategoryName(entry, source.categories)\n      return {\n        title: entry.title ?? '',\n        url: `/${source.slug}/${entry.slug ?? ''}`,\n        // Through the one formatter (AGL-1926), not a second inline\n        // `toLocaleDateString()`. It produced the same bytes only because\n        // this runs on the server, where the implicit locale and zone happen\n        // to be the ones `formatCollectionEntryDate` now pins; a related-post\n        // card is the same published date as the byline above it and must not\n        // be able to disagree with it.\n        //\n        // Answered HERE and not in the block (AGL-2486), for the reason the\n        // byline's format is: by the time a date reaches the component it is\n        // a formatted string, and re-parsing one is ambiguous by\n        // construction — `8/9/2026` is 9 August under `en-US` and 8 September\n        // under `en-GB`. The timestamp only exists on this side.\n        ...(entry.publishedAt?.seconds\n          ? { date: formatCollectionEntryDate(entry.publishedAt, dateFormat) }\n          : {}),\n        ...(entry.excerpt ? { excerpt: entry.excerpt } : {}),\n        // AGL-1457: the block owns its markup, so there is no template to\n        // bind `{{entry.coverImage}}` on — the cover can only reach it as a\n        // stamped field. Absent covers omit the key rather than stamping an\n        // empty string, so the render asks one question, not two.\n        ...(entry.coverImage ? { coverImage: entry.coverImage } : {}),\n        // Only alongside a cover, and only when authored (AGL-2418) — a\n        // description with no picture is dead weight on every stamped node.\n        ...(entry.coverImage && (entry as any).coverImageAlt\n          ? { coverImageAlt: (entry as any).coverImageAlt }\n          : {}),\n        ...(categoryName ? { category: categoryName } : {}),\n      }\n    })\n    next[containerId] = {\n      ...container,\n      props: { ...(container.props as any), entries: items },\n    }\n  }\n  return next\n}\n\nexport default expandCollectionEntries\n"],"names":["COLLECTION_ENTRY_DATE_FORMAT_DEFAULT","collectionEntryPublishedAtIso","formatCollectionEntryDate","normalizeCollectionEntryDateFormat","contentAuthorPageUrl","normalizeContentAuthorLinks","resolveNamedTokens","COLLECTION_ENTRIES_COMPONENT_ID","COLLECTION_ENTRY_BODY_COMPONENT_ID","COLLECTION_RELATED_COMPONENT_ID","COLLECTION_SHARE_COMPONENT_ID","COLLECTION_ENTRY_META_COMPONENT_ID","COLLECTION_ENTRY_AUTHOR_COMPONENT_ID","COLLECTION_CATEGORIES_COMPONENT_ID","COLLECTION_SEARCH_COMPONENT_ID","COLLECTION_PAGE_ROUTE_SEGMENT","COLLECTION_CATEGORY_ROUTE_SEGMENT","COLLECTION_ENTRIES_NODE_ID_PREFIX","COLLECTION_ENTRIES_MAX","COLLECTION_SOURCE_MAX","collectionSourceReachedBound","entries","length","collectionSourceIsBounded","source","reachedBound","COLLECTION_LIST_PAGE_SIZE","collectionTotalPages","total","perPage","Math","max","ceil","COLLECTION_RELATED_DEFAULT_LIMIT","COLLECTION_RELATED_MAX","COLLECTION_CATEGORIES_MAX","ENTRIES_MAX_PER_COLLECTION","COLLECTIONS_MAX_PER_HOST","resolveEntryCategoryName","entry","categories","categoryId","trim","match","find","category","id","name","legacy","undefined","collectionEntryMetaValues","dateFormat","date","publishedAt","author","authorName","tags","join","collectionEntryAuthorValues","pageUrl","authorId","links","bio","image","url","collectionEntryTokens","collectionSlug","meta","slug","title","excerpt","body","coverImage","coverVideo","collectionName","seoTitle","seoDescription","entryMatchesFilter","filter","normalize","value","toLowerCase","wanted","matchesId","Boolean","matchesName","tag","some","collectionCategorySlug","String","replace","resolveCollectionCategoryBySlug","collectionListUrl","options","scoped","categorySlug","page","Number","isFinite","floor","collectionPaginationLinks","positive","parsed","totalPages","href","n","prevUrl","nextUrl","POSITIVE_INTEGER","parseCollectionRoute","segments","rest","entrySlug","test","entryMatchesCategoryRoute","route","Set","map","size","entryId","has","entryName","COLLECTION_ALL_PILL_DEFAULT","COLLECTION_ALL_PILL_NONE","resolveCollectionAllLabel","text","buildCollectionCategoryLinks","active","activeCategorySlug","idSlug","nameSlug","push","label","allLabel","buildCollectionSearchIndex","categoryName","seconds","COLLECTION_BOUND_COMPONENT_IDS","nodesRenderCollection","nodes","node","Object","values","includes","componentId","bound","props","expandCollectionEntries","sourcesBySlug","defaultSlug","containers","next","containerId","container","limitRaw","entriesLimit","limit","min","perPageRaw","pageRaw","routedPage","firstPageOnly","suppressedBeyondFirstPage","templateIds","Array","isArray","filterCategory","filterTag","filtered","sourceCapped","windowed","slice","childIds","forEach","index","prefix","prefixId","cloned","cloneSubtree","parentId","clonedChildren","$id","childId","templateId","cloneId","cloneNode","fill","entryMetaFill","entryAuthorFill","keys","assign","searchEnabled","search","searchIndex","searchTotal","searchCapped","expandCollectionCategories","items","expandCollectionSearch","startsWith","expandCollectionEntryMeta","filled","key","authored","reformattableEntryDate","authorImage","bylineShown","expandCollectionEntryAuthor","ENTRY_DATE_BINDING","COLLECTION_SEARCH_FUSE_OPTIONS","weight","includeScore","shouldSort","ignoreLocation","threshold","selectRelatedEntries","current","bounded","sort","a","b","expandCollectionRelated","currentEntry","related","coverImageAlt"],"mappings":"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"}

package/src/lib/app-utils/collection-entry-date.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * How an entry's published date is spelled, and the one function that spells
+ * it.
+ *
+ * Its own module because a published page's client bundle reads
+ * `formatCollectionEntryDate` and nothing else here: `collection-entries.ts`
+ * carries the whole collection runtime — routing, pagination, category links,
+ * the search index and the four block expanders — and a bundler cannot drop
+ * the rest of it around a single named import.
+ */
+/**
+ * How an entry's published date reads (AGL-1459).
+ *
+ * Named shapes rather than a format string, for the same reason the styles
+ * panel offers a unit picker rather than a CSS box: an editor choosing a
+ * byline is not choosing a grammar, and a free-typed pattern is a field where
+ * every typo renders as itself on a published page.
+ */
+export type CollectionEntryDateFormat = 'default' | 'monthYear' | 'mediumDate' | 'longDate' | 'iso';
+/**
+ * "However the site already renders it" — a REAL value, never absence
+ * (AGL-1459).
+ *
+ * `''` is the shape AGL-1451/AGL-1453 closed repo-wide: an emptied field
+ * cannot survive a save, so an author who tried a format and wanted the
+ * original back would have no option to pick. So the do-nothing choice is a
+ * word, exactly like `COLLECTION_ALL_PILL_NONE` in `collection-entries.ts`.
+ */
+export declare const COLLECTION_ENTRY_DATE_FORMAT_DEFAULT: CollectionEntryDateFormat;
+/**
+ * The offered formats, with the labels an author reads (AGL-1459). Lives here
+ * rather than in the block's schema so the list and the formatter cannot
+ * drift into offering a shape nothing knows how to produce.
+ *
+ * Example dates in the labels are written the way the default runtime renders
+ * them, which is what makes the choice legible without opening a preview.
+ */
+export declare const COLLECTION_ENTRY_DATE_FORMAT_OPTIONS: readonly {
+    value: CollectionEntryDateFormat;
+    label: string;
+}[];
+/** Any stored value read back as a format this module knows (AGL-1459). */
+export declare function normalizeCollectionEntryDateFormat(value: unknown): CollectionEntryDateFormat;
+/**
+ * One entry's published date, in the shape the author asked for (AGL-1459).
+ *
+ * **The formatting lives HERE, beside the timestamp, and deliberately not in
+ * the block.** By the time a date reaches the component it is already a
+ * formatted string, and re-parsing one is ambiguous by construction: the same
+ * `8/9/2026` reads as 9 August under an `en-US` runtime and 8 September under
+ * `en-GB`. A byline that silently moves an article by three weeks is far worse
+ * than one that is the wrong shape.
+ *
+ * `default` returns exactly `toLocaleDateString()` — the string this function
+ * replaced, character for character — because the block is live on published
+ * entries and opening a dropdown must not restyle them.
+ *
+ * ## Why the runtime gets no say (AGL-1926)
+ *
+ * Every branch pins BOTH the locale and the time zone, and the answer is a
+ * pure function of the timestamp. It used to pass `locale` straight through
+ * (normally `undefined`) with no `timeZone` at all, so the output was a
+ * function of the RUNTIME: `en-US` + UTC on a Vercel server, the visitor's
+ * own locale and zone in their browser. That is fine while only the server
+ * ever calls it — the string is stamped into node props at compose time and
+ * both sides then agree on it — but it makes the function a hydration
+ * mismatch waiting for its first client-side caller, and `catch-all-client`
+ * was exactly that caller. A post published at 02:30 UTC is dated the 10th by
+ * the server and the 9th by every visitor west of Greenwich; React reports
+ * the difference as a text mismatch (the live React #418 on tenant-web,
+ * AGL-1926) and then reconciles against a DOM it no longer describes, which
+ * is where the `removeChild`/`insertBefore` pair comes from.
+ *
+ * The pinned values are the ones production already emits, so no published
+ * page changes: Vercel runs UTC with an `en-US` ICU default, which is why
+ * every entry date served from aglyn.com today reads `8/9/2026`. Pinning
+ * makes that byte-for-byte guaranteed instead of a property of the host.
+ *
+ * `locale` still exists for a caller that must render in a different one; it
+ * now defaults to the value the server was picking implicitly rather than to
+ * "whatever this runtime happens to be".
+ */
+export declare const COLLECTION_ENTRY_DATE_LOCALE = "en-US";
+/**
+ * The zone the calendar day is read in. Entry timestamps are absolute
+ * instants; the day they are ATTRIBUTED to has to be one both sides agree on,
+ * and UTC is the only zone a server and an unknown visitor share.
+ */
+export declare const COLLECTION_ENTRY_DATE_TIME_ZONE = "UTC";
+export declare function formatCollectionEntryDate(publishedAt: {
+    seconds: number;
+} | null | undefined, format?: CollectionEntryDateFormat, locale?: string): string;
+/**
+ * One entry's publish instant for a machine to read: an ISO 8601 date-time in
+ * UTC, or `''` for an entry with no date (AGL-2956).
+ *
+ * {@link formatCollectionEntryDate} writes the date a READER sees, and every
+ * one of its shapes is ambiguous or incomplete to a parser: `8/9/2026` is a
+ * different day in `en-GB`, and even its `iso` shape is a calendar day with no
+ * time or zone. A field that has to be parsed — a Video element's publication
+ * date, which the page publishes as `VideoObject.uploadDate` — needs the
+ * instant itself, spelled by `toISOString()` as `Article.datePublished` is.
+ *
+ * It reads the same `publishedAt` and treats a missing or zero `seconds` the
+ * same way, so an entry is dated here exactly when it is dated there.
+ *
+ * A `seconds` no `Date` can hold answers `''` rather than throwing:
+ * `toISOString` raises a RangeError on an invalid date, and this runs while a
+ * page composes.
+ */
+export declare function collectionEntryPublishedAtIso(publishedAt: {
+    seconds: number;
+} | null | undefined): string;

package/src/lib/app-utils/collection-entry-date.js

@@ -0,0 +1,183 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * How an entry's published date is spelled, and the one function that spells
+ * it.
+ *
+ * Its own module because a published page's client bundle reads
+ * `formatCollectionEntryDate` and nothing else here: `collection-entries.ts`
+ * carries the whole collection runtime — routing, pagination, category links,
+ * the search index and the four block expanders — and a bundler cannot drop
+ * the rest of it around a single named import.
+ */ /**
+ * How an entry's published date reads (AGL-1459).
+ *
+ * Named shapes rather than a format string, for the same reason the styles
+ * panel offers a unit picker rather than a CSS box: an editor choosing a
+ * byline is not choosing a grammar, and a free-typed pattern is a field where
+ * every typo renders as itself on a published page.
+ */ /**
+ * "However the site already renders it" — a REAL value, never absence
+ * (AGL-1459).
+ *
+ * `''` is the shape AGL-1451/AGL-1453 closed repo-wide: an emptied field
+ * cannot survive a save, so an author who tried a format and wanted the
+ * original back would have no option to pick. So the do-nothing choice is a
+ * word, exactly like `COLLECTION_ALL_PILL_NONE` in `collection-entries.ts`.
+ */ export const COLLECTION_ENTRY_DATE_FORMAT_DEFAULT = 'default';
+/**
+ * The offered formats, with the labels an author reads (AGL-1459). Lives here
+ * rather than in the block's schema so the list and the formatter cannot
+ * drift into offering a shape nothing knows how to produce.
+ *
+ * Example dates in the labels are written the way the default runtime renders
+ * them, which is what makes the choice legible without opening a preview.
+ */ export const COLLECTION_ENTRY_DATE_FORMAT_OPTIONS = [
+    {
+        value: 'default',
+        label: 'Site default — 8/9/2026'
+    },
+    {
+        value: 'monthYear',
+        label: 'Month and year — Aug 2026'
+    },
+    {
+        value: 'mediumDate',
+        label: 'Short date — Aug 9, 2026'
+    },
+    {
+        value: 'longDate',
+        label: 'Long date — August 9, 2026'
+    },
+    {
+        value: 'iso',
+        label: 'ISO — 2026-08-09'
+    }
+];
+/** Any stored value read back as a format this module knows (AGL-1459). */ export function normalizeCollectionEntryDateFormat(value) {
+    var _ref;
+    const wanted = String(value != null ? value : '').trim();
+    const match = COLLECTION_ENTRY_DATE_FORMAT_OPTIONS.find((option)=>option.value === wanted);
+    return (_ref = match == null ? void 0 : match.value) != null ? _ref : COLLECTION_ENTRY_DATE_FORMAT_DEFAULT;
+}
+/**
+ * One entry's published date, in the shape the author asked for (AGL-1459).
+ *
+ * **The formatting lives HERE, beside the timestamp, and deliberately not in
+ * the block.** By the time a date reaches the component it is already a
+ * formatted string, and re-parsing one is ambiguous by construction: the same
+ * `8/9/2026` reads as 9 August under an `en-US` runtime and 8 September under
+ * `en-GB`. A byline that silently moves an article by three weeks is far worse
+ * than one that is the wrong shape.
+ *
+ * `default` returns exactly `toLocaleDateString()` — the string this function
+ * replaced, character for character — because the block is live on published
+ * entries and opening a dropdown must not restyle them.
+ *
+ * ## Why the runtime gets no say (AGL-1926)
+ *
+ * Every branch pins BOTH the locale and the time zone, and the answer is a
+ * pure function of the timestamp. It used to pass `locale` straight through
+ * (normally `undefined`) with no `timeZone` at all, so the output was a
+ * function of the RUNTIME: `en-US` + UTC on a Vercel server, the visitor's
+ * own locale and zone in their browser. That is fine while only the server
+ * ever calls it — the string is stamped into node props at compose time and
+ * both sides then agree on it — but it makes the function a hydration
+ * mismatch waiting for its first client-side caller, and `catch-all-client`
+ * was exactly that caller. A post published at 02:30 UTC is dated the 10th by
+ * the server and the 9th by every visitor west of Greenwich; React reports
+ * the difference as a text mismatch (the live React #418 on tenant-web,
+ * AGL-1926) and then reconciles against a DOM it no longer describes, which
+ * is where the `removeChild`/`insertBefore` pair comes from.
+ *
+ * The pinned values are the ones production already emits, so no published
+ * page changes: Vercel runs UTC with an `en-US` ICU default, which is why
+ * every entry date served from aglyn.com today reads `8/9/2026`. Pinning
+ * makes that byte-for-byte guaranteed instead of a property of the host.
+ *
+ * `locale` still exists for a caller that must render in a different one; it
+ * now defaults to the value the server was picking implicitly rather than to
+ * "whatever this runtime happens to be".
+ */ export const COLLECTION_ENTRY_DATE_LOCALE = 'en-US';
+/**
+ * The zone the calendar day is read in. Entry timestamps are absolute
+ * instants; the day they are ATTRIBUTED to has to be one both sides agree on,
+ * and UTC is the only zone a server and an unknown visitor share.
+ */ export const COLLECTION_ENTRY_DATE_TIME_ZONE = 'UTC';
+export function formatCollectionEntryDate(publishedAt, format, locale = COLLECTION_ENTRY_DATE_LOCALE) {
+    const seconds = publishedAt == null ? void 0 : publishedAt.seconds;
+    if (!seconds) return '';
+    const date = new Date(seconds * 1000);
+    const timeZone = COLLECTION_ENTRY_DATE_TIME_ZONE;
+    switch(normalizeCollectionEntryDateFormat(format)){
+        case 'monthYear':
+            return date.toLocaleDateString(locale, {
+                month: 'short',
+                year: 'numeric',
+                timeZone
+            });
+        case 'mediumDate':
+            return date.toLocaleDateString(locale, {
+                month: 'short',
+                day: 'numeric',
+                year: 'numeric',
+                timeZone
+            });
+        case 'longDate':
+            return date.toLocaleDateString(locale, {
+                month: 'long',
+                day: 'numeric',
+                year: 'numeric',
+                timeZone
+            });
+        case 'iso':
+            // The calendar day in the pinned zone, not `toISOString()`'s slice by
+            // luck and not the RUNTIME's local day: `getFullYear`/`getMonth`/
+            // `getDate` read the host's zone, so this branch moved an entry by a
+            // day depending on who rendered it. The UTC accessors are the same
+            // reading the three `toLocaleDateString` branches above now take.
+            return `${date.getUTCFullYear()}-` + `${String(date.getUTCMonth() + 1).padStart(2, '0')}-` + `${String(date.getUTCDate()).padStart(2, '0')}`;
+        default:
+            return date.toLocaleDateString(locale, {
+                timeZone
+            });
+    }
+}
+/**
+ * One entry's publish instant for a machine to read: an ISO 8601 date-time in
+ * UTC, or `''` for an entry with no date (AGL-2956).
+ *
+ * {@link formatCollectionEntryDate} writes the date a READER sees, and every
+ * one of its shapes is ambiguous or incomplete to a parser: `8/9/2026` is a
+ * different day in `en-GB`, and even its `iso` shape is a calendar day with no
+ * time or zone. A field that has to be parsed — a Video element's publication
+ * date, which the page publishes as `VideoObject.uploadDate` — needs the
+ * instant itself, spelled by `toISOString()` as `Article.datePublished` is.
+ *
+ * It reads the same `publishedAt` and treats a missing or zero `seconds` the
+ * same way, so an entry is dated here exactly when it is dated there.
+ *
+ * A `seconds` no `Date` can hold answers `''` rather than throwing:
+ * `toISOString` raises a RangeError on an invalid date, and this runs while a
+ * page composes.
+ */ export function collectionEntryPublishedAtIso(publishedAt) {
+    const seconds = publishedAt == null ? void 0 : publishedAt.seconds;
+    if (!seconds) return '';
+    const date = new Date(seconds * 1000);
+    return Number.isNaN(date.getTime()) ? '' : date.toISOString();
+}
+
+//# sourceMappingURL=collection-entry-date.js.map

package/src/lib/app-utils/collection-entry-date.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/collection-entry-date.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\n/**\n * How an entry's published date is spelled, and the one function that spells\n * it.\n *\n * Its own module because a published page's client bundle reads\n * `formatCollectionEntryDate` and nothing else here: `collection-entries.ts`\n * carries the whole collection runtime — routing, pagination, category links,\n * the search index and the four block expanders — and a bundler cannot drop\n * the rest of it around a single named import.\n */\n\n/**\n * How an entry's published date reads (AGL-1459).\n *\n * Named shapes rather than a format string, for the same reason the styles\n * panel offers a unit picker rather than a CSS box: an editor choosing a\n * byline is not choosing a grammar, and a free-typed pattern is a field where\n * every typo renders as itself on a published page.\n */\nexport type CollectionEntryDateFormat =\n  'default' | 'monthYear' | 'mediumDate' | 'longDate' | 'iso'\n\n/**\n * \"However the site already renders it\" — a REAL value, never absence\n * (AGL-1459).\n *\n * `''` is the shape AGL-1451/AGL-1453 closed repo-wide: an emptied field\n * cannot survive a save, so an author who tried a format and wanted the\n * original back would have no option to pick. So the do-nothing choice is a\n * word, exactly like `COLLECTION_ALL_PILL_NONE` in `collection-entries.ts`.\n */\nexport const COLLECTION_ENTRY_DATE_FORMAT_DEFAULT: CollectionEntryDateFormat =\n  'default'\n\n/**\n * The offered formats, with the labels an author reads (AGL-1459). Lives here\n * rather than in the block's schema so the list and the formatter cannot\n * drift into offering a shape nothing knows how to produce.\n *\n * Example dates in the labels are written the way the default runtime renders\n * them, which is what makes the choice legible without opening a preview.\n */\nexport const COLLECTION_ENTRY_DATE_FORMAT_OPTIONS: readonly {\n  value: CollectionEntryDateFormat\n  label: string\n}[] = [\n  { value: 'default', label: 'Site default — 8/9/2026' },\n  { value: 'monthYear', label: 'Month and year — Aug 2026' },\n  { value: 'mediumDate', label: 'Short date — Aug 9, 2026' },\n  { value: 'longDate', label: 'Long date — August 9, 2026' },\n  { value: 'iso', label: 'ISO — 2026-08-09' },\n]\n\n/** Any stored value read back as a format this module knows (AGL-1459). */\nexport function normalizeCollectionEntryDateFormat(\n  value: unknown,\n): CollectionEntryDateFormat {\n  const wanted = String(value ?? '').trim()\n  const match = COLLECTION_ENTRY_DATE_FORMAT_OPTIONS.find(\n    (option) => option.value === wanted,\n  )\n  return match?.value ?? COLLECTION_ENTRY_DATE_FORMAT_DEFAULT\n}\n\n/**\n * One entry's published date, in the shape the author asked for (AGL-1459).\n *\n * **The formatting lives HERE, beside the timestamp, and deliberately not in\n * the block.** By the time a date reaches the component it is already a\n * formatted string, and re-parsing one is ambiguous by construction: the same\n * `8/9/2026` reads as 9 August under an `en-US` runtime and 8 September under\n * `en-GB`. A byline that silently moves an article by three weeks is far worse\n * than one that is the wrong shape.\n *\n * `default` returns exactly `toLocaleDateString()` — the string this function\n * replaced, character for character — because the block is live on published\n * entries and opening a dropdown must not restyle them.\n *\n * ## Why the runtime gets no say (AGL-1926)\n *\n * Every branch pins BOTH the locale and the time zone, and the answer is a\n * pure function of the timestamp. It used to pass `locale` straight through\n * (normally `undefined`) with no `timeZone` at all, so the output was a\n * function of the RUNTIME: `en-US` + UTC on a Vercel server, the visitor's\n * own locale and zone in their browser. That is fine while only the server\n * ever calls it — the string is stamped into node props at compose time and\n * both sides then agree on it — but it makes the function a hydration\n * mismatch waiting for its first client-side caller, and `catch-all-client`\n * was exactly that caller. A post published at 02:30 UTC is dated the 10th by\n * the server and the 9th by every visitor west of Greenwich; React reports\n * the difference as a text mismatch (the live React #418 on tenant-web,\n * AGL-1926) and then reconciles against a DOM it no longer describes, which\n * is where the `removeChild`/`insertBefore` pair comes from.\n *\n * The pinned values are the ones production already emits, so no published\n * page changes: Vercel runs UTC with an `en-US` ICU default, which is why\n * every entry date served from aglyn.com today reads `8/9/2026`. Pinning\n * makes that byte-for-byte guaranteed instead of a property of the host.\n *\n * `locale` still exists for a caller that must render in a different one; it\n * now defaults to the value the server was picking implicitly rather than to\n * \"whatever this runtime happens to be\".\n */\nexport const COLLECTION_ENTRY_DATE_LOCALE = 'en-US'\n\n/**\n * The zone the calendar day is read in. Entry timestamps are absolute\n * instants; the day they are ATTRIBUTED to has to be one both sides agree on,\n * and UTC is the only zone a server and an unknown visitor share.\n */\nexport const COLLECTION_ENTRY_DATE_TIME_ZONE = 'UTC'\n\nexport function formatCollectionEntryDate(\n  publishedAt: { seconds: number } | null | undefined,\n  format?: CollectionEntryDateFormat,\n  locale: string = COLLECTION_ENTRY_DATE_LOCALE,\n): string {\n  const seconds = publishedAt?.seconds\n  if (!seconds) return ''\n  const date = new Date(seconds * 1000)\n  const timeZone = COLLECTION_ENTRY_DATE_TIME_ZONE\n  switch (normalizeCollectionEntryDateFormat(format)) {\n    case 'monthYear':\n      return date.toLocaleDateString(locale, {\n        month: 'short',\n        year: 'numeric',\n        timeZone,\n      })\n    case 'mediumDate':\n      return date.toLocaleDateString(locale, {\n        month: 'short',\n        day: 'numeric',\n        year: 'numeric',\n        timeZone,\n      })\n    case 'longDate':\n      return date.toLocaleDateString(locale, {\n        month: 'long',\n        day: 'numeric',\n        year: 'numeric',\n        timeZone,\n      })\n    case 'iso':\n      // The calendar day in the pinned zone, not `toISOString()`'s slice by\n      // luck and not the RUNTIME's local day: `getFullYear`/`getMonth`/\n      // `getDate` read the host's zone, so this branch moved an entry by a\n      // day depending on who rendered it. The UTC accessors are the same\n      // reading the three `toLocaleDateString` branches above now take.\n      return (\n        `${date.getUTCFullYear()}-` +\n        `${String(date.getUTCMonth() + 1).padStart(2, '0')}-` +\n        `${String(date.getUTCDate()).padStart(2, '0')}`\n      )\n    default:\n      return date.toLocaleDateString(locale, { timeZone })\n  }\n}\n\n/**\n * One entry's publish instant for a machine to read: an ISO 8601 date-time in\n * UTC, or `''` for an entry with no date (AGL-2956).\n *\n * {@link formatCollectionEntryDate} writes the date a READER sees, and every\n * one of its shapes is ambiguous or incomplete to a parser: `8/9/2026` is a\n * different day in `en-GB`, and even its `iso` shape is a calendar day with no\n * time or zone. A field that has to be parsed — a Video element's publication\n * date, which the page publishes as `VideoObject.uploadDate` — needs the\n * instant itself, spelled by `toISOString()` as `Article.datePublished` is.\n *\n * It reads the same `publishedAt` and treats a missing or zero `seconds` the\n * same way, so an entry is dated here exactly when it is dated there.\n *\n * A `seconds` no `Date` can hold answers `''` rather than throwing:\n * `toISOString` raises a RangeError on an invalid date, and this runs while a\n * page composes.\n */\nexport function collectionEntryPublishedAtIso(\n  publishedAt: { seconds: number } | null | undefined,\n): string {\n  const seconds = publishedAt?.seconds\n  if (!seconds) return ''\n  const date = new Date(seconds * 1000)\n  return Number.isNaN(date.getTime()) ? '' : date.toISOString()\n}\n"],"names":["COLLECTION_ENTRY_DATE_FORMAT_DEFAULT","COLLECTION_ENTRY_DATE_FORMAT_OPTIONS","value","label","normalizeCollectionEntryDateFormat","wanted","String","trim","match","find","option","COLLECTION_ENTRY_DATE_LOCALE","COLLECTION_ENTRY_DATE_TIME_ZONE","formatCollectionEntryDate","publishedAt","format","locale","seconds","date","Date","timeZone","toLocaleDateString","month","year","day","getUTCFullYear","getUTCMonth","padStart","getUTCDate","collectionEntryPublishedAtIso","Number","isNaN","getTime","toISOString"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;CASC,GAED;;;;;;;CAOC,GAID;;;;;;;;CAQC,GACD,OAAO,MAAMA,uCACX,UAAS;AAEX;;;;;;;CAOC,GACD,OAAO,MAAMC,uCAGP;IACJ;QAAEC,OAAO;QAAWC,OAAO;IAA0B;IACrD;QAAED,OAAO;QAAaC,OAAO;IAA4B;IACzD;QAAED,OAAO;QAAcC,OAAO;IAA2B;IACzD;QAAED,OAAO;QAAYC,OAAO;IAA6B;IACzD;QAAED,OAAO;QAAOC,OAAO;IAAmB;CAC3C,CAAA;AAED,yEAAyE,GACzE,OAAO,SAASC,mCACdF,KAAc;;IAEd,MAAMG,SAASC,OAAOJ,gBAAAA,QAAS,IAAIK,IAAI;IACvC,MAAMC,QAAQP,qCAAqCQ,IAAI,CACrD,CAACC,SAAWA,OAAOR,KAAK,KAAKG;IAE/B,eAAOG,yBAAAA,MAAON,KAAK,mBAAIF;AACzB;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCC,GACD,OAAO,MAAMW,+BAA+B,QAAO;AAEnD;;;;CAIC,GACD,OAAO,MAAMC,kCAAkC,MAAK;AAEpD,OAAO,SAASC,0BACdC,WAAmD,EACnDC,MAAkC,EAClCC,SAAiBL,4BAA4B;IAE7C,MAAMM,UAAUH,+BAAAA,YAAaG,OAAO;IACpC,IAAI,CAACA,SAAS,OAAO;IACrB,MAAMC,OAAO,IAAIC,KAAKF,UAAU;IAChC,MAAMG,WAAWR;IACjB,OAAQR,mCAAmCW;QACzC,KAAK;YACH,OAAOG,KAAKG,kBAAkB,CAACL,QAAQ;gBACrCM,OAAO;gBACPC,MAAM;gBACNH;YACF;QACF,KAAK;YACH,OAAOF,KAAKG,kBAAkB,CAACL,QAAQ;gBACrCM,OAAO;gBACPE,KAAK;gBACLD,MAAM;gBACNH;YACF;QACF,KAAK;YACH,OAAOF,KAAKG,kBAAkB,CAACL,QAAQ;gBACrCM,OAAO;gBACPE,KAAK;gBACLD,MAAM;gBACNH;YACF;QACF,KAAK;YACH,sEAAsE;YACtE,kEAAkE;YAClE,qEAAqE;YACrE,mEAAmE;YACnE,kEAAkE;YAClE,OACE,GAAGF,KAAKO,cAAc,GAAG,CAAC,CAAC,GAC3B,GAAGnB,OAAOY,KAAKQ,WAAW,KAAK,GAAGC,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,GACrD,GAAGrB,OAAOY,KAAKU,UAAU,IAAID,QAAQ,CAAC,GAAG,MAAM;QAEnD;YACE,OAAOT,KAAKG,kBAAkB,CAACL,QAAQ;gBAAEI;YAAS;IACtD;AACF;AAEA;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,SAASS,8BACdf,WAAmD;IAEnD,MAAMG,UAAUH,+BAAAA,YAAaG,OAAO;IACpC,IAAI,CAACA,SAAS,OAAO;IACrB,MAAMC,OAAO,IAAIC,KAAKF,UAAU;IAChC,OAAOa,OAAOC,KAAK,CAACb,KAAKc,OAAO,MAAM,KAAKd,KAAKe,WAAW;AAC7D"}