@aglyn/tenant-runtime 1.0.0-beta.143

package/src/lib/collection-fallback-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/tenant/runtime/src/lib/collection-fallback-nodes.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 { wistiaMediaId } from '@aglyn/aglyn/app-utils/wistia-embed'\nimport * as Aglyn from '@aglyn/aglyn/server'\n\n/** Namespaces the synthetic fallback node ids (never persisted). */\nconst FALLBACK_ID_PREFIX = 'cfb__'\n\nconst id = (suffix: string) => `${FALLBACK_ID_PREFIX}${suffix}`\n\ntype NodesMap = Record<string, Aglyn.AglynNodeSchema>\n\ninterface FallbackCollection {\n  slug: string\n  displayName: string\n  /** Category taxonomy (AGL-582) for `categoryId` → name resolution. */\n  categories?: Aglyn.CollectionCategory[]\n}\n\ninterface FallbackEntry {\n  title?: string\n  slug?: string\n  excerpt?: string\n  /** Per-entry byline (AGL-686); falls back to the site as author. */\n  authorName?: string\n  body?: string\n  coverImage?: string\n  /** The featured video (AGL-2956); plays in the cover's place. */\n  coverVideo?: string\n  /** Meta description override (AGL-582); falls back to `excerpt`. */\n  seoDescription?: string\n  /** Stable taxonomy reference (AGL-582); wins over `category`. */\n  categoryId?: string\n  /** Legacy free-typed category (AGL-582); read-only fallback. */\n  category?: string\n  tags?: string[]\n  publishedAt?: { seconds: number } | null\n}\n\n// The one shared formatter (AGL-1926). This composes server-side, so the\n// inline `toLocaleDateString()` it replaces was not itself a hydration\n// mismatch — but it was a THIRD spelling of \"the entry's published date\",\n// free to drift from the byline and the related-post card that quote the\n// same instant. Pinned locale and zone, so all three agree by construction.\nconst formatDate = (value?: { seconds: number } | null) =>\n  Aglyn.formatCollectionEntryDate(value)\n\n/**\n * What may be interpolated into the cover block's CSS `url(\"…\")` (AGL-1407).\n *\n * The gate this replaces was `/^https?:\\/\\//i`, which answered the safety\n * question correctly and the coverage question wrongly: it admitted only the\n * OLDEST of the stored generations. A `media:` reference failed it and the\n * cover block was never emitted — a SILENT drop, no error, no placeholder,\n * just a page missing its picture — and so did the AGL-175 relative CDN path\n * that the first pass at media references wrote. Resolving before testing is\n * what closes that, and the test then has to accept a site-relative path,\n * which is what {@link Aglyn.resolveMediaSrc} returns for a reference.\n *\n * Still a scheme allowlist rather than \"anything non-empty\": this value lands\n * inside a stylesheet rather than in an `<img src>`, so `data:` and friends\n * have no business here even though {@link cssUrlValue} already makes\n * quote-breaking impossible. A bare relative `cover.png` stays rejected\n * exactly as before — there is no page for it to resolve against at compose\n * time.\n *\n * `http:` was dropped for AGL-1725. AGL-1701 found two paths accepting it;\n * markdown-lite is AGL-1713 and this was the second, separate one. It is the\n * only scheme change here, and it is not a host restriction: an author\n * hotlinking their own https cover keeps working, because on a published\n * site the author IS the site owner and the audience is their own visitors.\n * `http:` alone has no defensible use — the request is mixed passive content\n * that current browsers already block or auto-upgrade, so the author gains\n * nothing from it, while the plaintext fetch discloses which article a\n * visitor is reading to every observer on the network path.\n *\n * The consequence of the drop is the SILENT DROP this whole comment is about,\n * for `http:` covers only: no cover node is emitted. That is the correct\n * trade here and the browser was very likely refusing the image anyway, but\n * it is the reason the change is one scheme and not a host list.\n */\nconst RENDERABLE_COVER_URL = /^(?:https:\\/\\/|\\/)/i\n\n/**\n * A URL made safe to sit inside `url(\"…\")`, WITHOUT re-encoding it.\n *\n * This replaces `encodeURI`, which was the wrong tool and quietly broke the\n * commonest stored form: `encodeURI` escapes `%`, so every raw firebasestorage\n * download URL — whose object path is `orgs%2F…%2Fmedia%2F…` — came out\n * double-encoded as `%252F` and 404'd. The block rendered, the image did not,\n * which is why it survived: the page looks composed and the picture is just\n * missing.\n *\n * Only the characters that could END the CSS string are escaped, and they are\n * escaped percent-wise rather than with a backslash so the result is still a\n * valid URL if anything downstream reads it as one. `encodeURI` was never\n * needed for anything else here — a stored URL is already URL-encoded.\n */\nconst cssUrlValue = (url: string) =>\n  url.replace(/[\"\\\\\\n\\r]/g, (char) => encodeURIComponent(char))\n\n/**\n * Container width for the built-in entry article: the PROSE case of the\n * Container standard (AGL-1298), not an arbitrary narrow default. A\n * collection entry is an article body, and `xl` — the section default — runs\n * a paragraph past 180 characters a line. Stock breakpoint, no bespoke\n * number.\n */\nconst ENTRY_MAX_WIDTH = 'md'\n\n/**\n * Container width for the built-in listing: the section default. A listing is\n * a card grid rather than a reading column, so the entry's prose width is the\n * wrong measure for it, and the authored list screens render at this same\n * `xl` (AGL-2567). Still a stock breakpoint, so the AGL-1298 rule holds.\n */\nconst LIST_MAX_WIDTH = 'xl'\n\n/**\n * Vertical rhythm between the built-in listing's sections, in MUI theme\n * spacing units: `theme.spacing(6)` resolves to 48px, the same rhythm the\n * authored list screens carry, so a generated listing and an authored one\n * read as one product (AGL-2567).\n *\n * A theme token rather than a pixel string: a hand-written length here\n * answers to no theme, and a length missing its unit is a valid-looking\n * value the browser drops.\n *\n * @see https://mui.com/material-ui/customization/spacing/\n */\nconst LIST_SECTION_GAP = 6\n\n/** The page shell's width and the rhythm of the stack that holds sections. */\ninterface ShellLayout {\n  /** Stock Container breakpoint (AGL-1298); never a bespoke pixel cap. */\n  maxWidth: typeof ENTRY_MAX_WIDTH | typeof LIST_MAX_WIDTH\n  /** Props for the content stack the page's sections slot into. */\n  stackProps: Record<string, unknown>\n}\n\n/** The entry article's shell: reading column, sections close together. */\nconst entryShell = (): ShellLayout => ({\n  maxWidth: ENTRY_MAX_WIDTH,\n  stackProps: { spacing: 2 },\n})\n\n/**\n * The listing's shell: full section width, sections on the 48px rhythm.\n *\n * The gap is declared on the stack's `sx` rather than left to the Stack's own\n * `spacing`, which is the shape the authored list screens carry: one\n * `row-gap` on the flex container, so every section is spaced by the same\n * declaration instead of by margins that a section's own styling can collapse\n * or override.\n */\nconst listShell = (): ShellLayout => ({\n  maxWidth: LIST_MAX_WIDTH,\n  stackProps: {\n    sx: {\n      display: 'flex',\n      flexDirection: 'column',\n      gap: LIST_SECTION_GAP,\n    },\n  },\n})\n\n/** Root → centered container → content stack; children slot underneath. */\nfunction shell(childIds: string[], layout: ShellLayout): NodesMap {\n  return {\n    [Aglyn.NODE_ROOT_ID]: {\n      $id: Aglyn.NODE_ROOT_ID,\n      componentId: 'div',\n      nodes: [id('container')],\n    },\n    [id('container')]: {\n      $id: id('container'),\n      componentId: 'muiContainer',\n      pluginId: 'mui',\n      parentId: Aglyn.NODE_ROOT_ID,\n      props: {\n        maxWidth: layout.maxWidth,\n        sx: { paddingTop: 6, paddingBottom: 6 },\n      },\n      nodes: [id('stack')],\n    },\n    [id('stack')]: {\n      $id: id('stack'),\n      componentId: 'muiStack',\n      pluginId: 'mui',\n      parentId: id('container'),\n      props: layout.stackProps,\n      nodes: childIds,\n    },\n  }\n}\n\nconst typography = (\n  suffix: string,\n  props: Record<string, unknown>,\n): AglynNodeEntry => [\n  id(suffix),\n  {\n    $id: id(suffix),\n    componentId: 'muiTypography',\n    pluginId: 'mui',\n    parentId: id('stack'),\n    props,\n  },\n]\n\ntype AglynNodeEntry = [string, Aglyn.AglynNodeSchema]\n\n/**\n * The Video node's props for an entry's featured video, or `undefined` when\n * the entry has none this page can play (AGL-2956).\n *\n * An entry of a video collection is an article whose film sits where a post's\n * cover would, and on the built-in page nobody is there to bind one. So the\n * props carry what a designer would bind by hand: the source, the cover as\n * the poster, and the three facts the page's `VideoObject` is built from —\n * the title, the SEO description falling back to the excerpt as\n * `{{entry.seoDescription}}` does, and the ISO publish instant\n * `{{entry.publishedAt}}` resolves to. An instant rather than a calendar day:\n * the builder publishes `uploadDate` as a date-time with a zone, and it keeps\n * an instant as given where it would publish a bare day at noon UTC.\n *\n * `undefined` rather than a Video node in two cases, because the element's\n * answer to each is a labeled placeholder, which a published article must\n * never show:\n *\n * - a source nothing resolves, such as an empty field or a malformed `media:`\n *   reference;\n * - a Wistia link with no poster. Its player loads only when a visitor\n *   presses the poster, so without one there is nothing to press.\n *\n * The page then renders as a cover article, exactly as it does for an entry\n * with no video.\n *\n * The poster is the stored reference, not a resolved URL, so the element and\n * the structured data each resolve it against the site rendering the page. It\n * is passed only when the cover's own scheme rule would render it, so this\n * page never shows a still as a poster that it refuses as a cover.\n *\n * The film takes the cover's whole slot in the reading column, whose stock\n * `md` container bounds it; the column is the width limit rather than a pixel\n * cap (AGL-1298).\n */\nfunction featuredVideoProps(\n  entry: FallbackEntry,\n  options: { hostId?: string; posterRenders: boolean },\n): Record<string, unknown> | undefined {\n  const src = (entry.coverVideo ?? '').trim()\n  if (!src || !Aglyn.resolveMediaSrc(src, { hostId: options.hostId })) {\n    return undefined\n  }\n  const poster = options.posterRenders ? entry.coverImage : undefined\n  if (wistiaMediaId(src) && !poster) return undefined\n  const description = entry.seoDescription || entry.excerpt || ''\n  const uploadDate = Aglyn.collectionEntryPublishedAtIso(entry.publishedAt)\n  return {\n    src,\n    ...(poster ? { poster } : {}),\n    title: entry.title ?? '',\n    ...(description ? { description } : {}),\n    ...(uploadDate ? { uploadDate } : {}),\n    width: '100%',\n  }\n}\n\n/**\n * Built-in entry article as canvas nodes (AGL-551): when a collection has\n * no entry-template screen, `/{collection}/{entry}` renders these through\n * the normal compose pipeline — site theme, shared layout chrome, and the\n * markdown-rendering Entry body block — instead of the old unthemed HTML.\n */\nexport function buildCollectionEntryFallbackNodes(\n  collection: FallbackCollection,\n  entry: FallbackEntry,\n  /**\n   * The site being composed, so an org-scoped reference is host-qualified the\n   * way every other render surface qualifies one (AGL-1043/AGL-1407). Optional\n   * because a bare org reference still resolves without it; passing it is what\n   * lets an asset restricted to this site resolve at all.\n   */\n  hostId?: string,\n): NodesMap {\n  const entries: AglynNodeEntry[] = [\n    typography('title', {\n      variant: 'h3',\n      component: 'h1',\n      children: entry.title ?? '',\n    }),\n  ]\n  const date = formatDate(entry.publishedAt)\n  const tags = (entry.tags ?? []).filter(Boolean)\n  // Category name resolves against the collection's taxonomy (AGL-582):\n  // `categoryId` lookup first, legacy free-typed string fallback.\n  const categoryName =\n    Aglyn.resolveEntryCategoryName(entry, collection.categories) ?? ''\n  if (date || categoryName || tags.length) {\n    // Entry meta block (AGL-582): \"date · category\" line + tag chips.\n    entries.push([\n      id('meta'),\n      {\n        $id: id('meta'),\n        componentId: Aglyn.COLLECTION_ENTRY_META_COMPONENT_ID,\n        pluginId: 'mui',\n        parentId: id('stack'),\n        props: {\n          date,\n          category: categoryName,\n          tags: tags.join(', '),\n        },\n      },\n    ])\n  }\n  // The cover, through the ONE shared resolver (AGL-1407). A `media:`\n  // reference becomes the site-relative CDN path; a raw storage URL, an\n  // AGL-175 CDN path and an author's own hotlinked URL all pass through\n  // untouched, which is the documented precedence in `media-ref.ts`.\n  const coverImage = Aglyn.resolveMediaSrc(entry.coverImage, { hostId })\n  const coverRenders = Boolean(\n    coverImage && RENDERABLE_COVER_URL.test(coverImage),\n  )\n  // A featured video takes the cover's slot, with the cover as its poster\n  // (AGL-2956); see `featuredVideoProps` for when an entry has one to play.\n  const video = featuredVideoProps(entry, {\n    hostId,\n    posterRenders: coverRenders,\n  })\n  if (video) {\n    entries.push([\n      id('video'),\n      {\n        $id: id('video'),\n        componentId: Aglyn.VIDEO_COMPONENT_ID,\n        pluginId: 'mui',\n        parentId: id('stack'),\n        props: video,\n      },\n    ])\n  } else if (coverRenders) {\n    // Rendered as a background image on a plain stack, NOT through the\n    // first-party `image` component — that component crashes tenant SSR\n    // (AGL-579); the background-image approach is proven safe.\n    entries.push([\n      id('cover'),\n      {\n        $id: id('cover'),\n        componentId: 'muiStack',\n        pluginId: 'mui',\n        parentId: id('stack'),\n        props: {\n          role: 'img',\n          'aria-label': entry.title ?? '',\n          sx: {\n            backgroundImage: `url(\"${cssUrlValue(coverImage)}\")`,\n            backgroundSize: 'cover',\n            backgroundPosition: 'center',\n            borderRadius: 1,\n            minHeight: 320,\n          },\n        },\n      },\n    ])\n  }\n  entries.push([\n    id('body'),\n    {\n      $id: id('body'),\n      componentId: Aglyn.COLLECTION_ENTRY_BODY_COMPONENT_ID,\n      pluginId: 'mui',\n      parentId: id('stack'),\n      props: { markdown: entry.body ?? '' },\n    },\n  ])\n  // Related posts after the body, share bar at the end (AGL-582); the\n  // compose pipeline stamps the related entries server-side.\n  entries.push([\n    id('related'),\n    {\n      $id: id('related'),\n      componentId: Aglyn.COLLECTION_RELATED_COMPONENT_ID,\n      pluginId: 'mui',\n      parentId: id('stack'),\n      props: { heading: 'Related articles', limit: 3, sx: { paddingTop: 2 } },\n    },\n  ])\n  entries.push([\n    id('share'),\n    {\n      $id: id('share'),\n      componentId: Aglyn.COLLECTION_SHARE_COMPONENT_ID,\n      pluginId: 'mui',\n      parentId: id('stack'),\n      props: {},\n    },\n  ])\n  entries.push([\n    id('back'),\n    {\n      $id: id('back'),\n      componentId: 'muiScreenLink',\n      pluginId: 'mui',\n      parentId: id('stack'),\n      props: {\n        href: `/${collection.slug}`,\n        children: `← ${collection.displayName}`,\n        sx: { alignSelf: 'flex-start' },\n      },\n    },\n  ])\n  return {\n    ...shell(\n      entries.map(([entryId]) => entryId),\n      entryShell(),\n    ),\n    ...Object.fromEntries(entries),\n  }\n}\n\n/** Pagination state for the built-in list (AGL-620). */\nexport interface FallbackListPagination {\n  page: number\n  perPage: number\n  totalPages: number\n}\n\n/** The routed category for a filtered listing (AGL-1321). */\nexport interface FallbackListCategory {\n  slug: string\n  name: string\n}\n\n/** Prev/next + \"Page X of Y\" nav linking to /{slug}/page/{n} (AGL-620). */\nfunction paginationNodes(\n  collection: FallbackCollection,\n  pagination: FallbackListPagination,\n  category?: FallbackListCategory,\n): { childId: string; nodes: NodesMap } {\n  // Page 1 lives at the bare listing; deeper pages at .../page/{n}. Built\n  // through the shared pager computation so this fallback and the\n  // `{{pagination.*}}` tokens an authored template binds (AGL-1386) can never\n  // disagree — and so the pager stays inside the category it is paging\n  // (AGL-1321): a \"next\" that dropped the filter would silently return the\n  // reader to the unfiltered list. An edge is the empty string, which is\n  // exactly the \"no link here\" this fallback already meant.\n  const { page, totalPages, prevUrl, nextUrl } = Aglyn.collectionPaginationLinks(\n    {\n      collectionSlug: collection.slug,\n      ...(category ? { categorySlug: category.slug } : {}),\n      page: pagination.page,\n      totalPages: pagination.totalPages,\n    },\n  )\n  const children: string[] = []\n  const nodes: NodesMap = {}\n  if (prevUrl) {\n    nodes[id('prev')] = {\n      $id: id('prev'),\n      componentId: 'muiScreenLink',\n      pluginId: 'mui',\n      parentId: id('pager'),\n      props: { href: prevUrl, children: '← Newer' },\n    }\n    children.push(id('prev'))\n  }\n  nodes[id('pageinfo')] = {\n    $id: id('pageinfo'),\n    componentId: 'muiTypography',\n    pluginId: 'mui',\n    parentId: id('pager'),\n    props: {\n      variant: 'body2',\n      children: `Page ${page} of ${totalPages}`,\n      sx: { color: 'text.secondary' },\n    },\n  }\n  children.push(id('pageinfo'))\n  if (nextUrl) {\n    nodes[id('next')] = {\n      $id: id('next'),\n      componentId: 'muiScreenLink',\n      pluginId: 'mui',\n      parentId: id('pager'),\n      props: { href: nextUrl, children: 'Older →' },\n    }\n    children.push(id('next'))\n  }\n  nodes[id('pager')] = {\n    $id: id('pager'),\n    componentId: 'muiStack',\n    pluginId: 'mui',\n    parentId: id('stack'),\n    props: {\n      direction: 'row',\n      spacing: 3,\n      sx: { alignItems: 'center', justifyContent: 'center' },\n    },\n    nodes: children,\n  }\n  return { childId: id('pager'), nodes }\n}\n\n/**\n * Built-in entry list as canvas nodes (AGL-551): a heading plus a\n * Collection entries block whose template (title, date, excerpt, Read\n * more) the compose pipeline expands over the published entries — the same\n * block designers drop onto their own list-template screens. With\n * `pagination` (AGL-620) the block renders one page and prev/next nav links\n * to `/{slug}/page/{n}`.\n */\nexport function buildCollectionListFallbackNodes(\n  collection: FallbackCollection,\n  hasEntries: boolean,\n  pagination?: FallbackListPagination,\n  category?: FallbackListCategory,\n): NodesMap {\n  const [titleId, title] = typography('title', {\n    variant: 'h3',\n    component: 'h1',\n    // A filtered listing says which slice it is (AGL-1321) — a page of\n    // Guides whose only heading reads \"Blog\" tells the reader nothing about\n    // why the other posts vanished.\n    children: category\n      ? `${collection.displayName} · ${category.name}`\n      : collection.displayName,\n  })\n  // Category pills (AGL-1321): stamped by `expandCollectionCategories` during\n  // compose, from the same taxonomy this node's collection carries. Present\n  // in the EMPTY case too — a filtered listing with no entries whose pills\n  // vanished would be a dead end with no way back to \"All\".\n  const pills = collection.categories?.length\n    ? {\n        $id: id('pills'),\n        componentId: Aglyn.COLLECTION_CATEGORIES_COMPONENT_ID,\n        pluginId: 'mui',\n        parentId: id('stack'),\n        props: { allLabel: 'All' },\n      }\n    : null\n  const lead = pills ? [titleId, id('pills')] : [titleId]\n  if (!hasEntries) {\n    const [emptyId, empty] = typography('empty', {\n      variant: 'body1',\n      children: category\n        ? `Nothing published in ${category.name} yet.`\n        : 'Nothing published yet.',\n      sx: { color: 'text.secondary' },\n    })\n    return {\n      ...shell([...lead, emptyId], listShell()),\n      [titleId]: title,\n      ...(pills ? { [id('pills')]: pills } : {}),\n      [emptyId]: empty,\n    }\n  }\n  const item = (suffix: string, props: Record<string, unknown>) => ({\n    $id: id(suffix),\n    componentId: 'muiTypography' as const,\n    pluginId: 'mui',\n    parentId: id('item'),\n    props,\n  })\n  const pager =\n    pagination && pagination.totalPages > 1\n      ? paginationNodes(collection, pagination, category)\n      : null\n  return {\n    ...shell(\n      pager\n        ? [...lead, id('entries'), pager.childId]\n        : [...lead, id('entries')],\n      listShell(),\n    ),\n    [titleId]: title,\n    ...(pills ? { [id('pills')]: pills } : {}),\n    [id('entries')]: {\n      $id: id('entries'),\n      componentId: Aglyn.COLLECTION_ENTRIES_COMPONENT_ID,\n      pluginId: 'mui',\n      parentId: id('stack'),\n      props: {\n        spacing: 4,\n        ...(pagination\n          ? { perPage: pagination.perPage, page: pagination.page }\n          : {}),\n      },\n      nodes: [id('item')],\n    },\n    ...(pager ? pager.nodes : {}),\n    [id('item')]: {\n      $id: id('item'),\n      componentId: 'muiStack',\n      pluginId: 'mui',\n      parentId: id('entries'),\n      props: { spacing: 0.5 },\n      nodes: [\n        id('item-title'),\n        id('item-date'),\n        id('item-excerpt'),\n        id('item-link'),\n      ],\n    },\n    [id('item-title')]: item('item-title', {\n      variant: 'h5',\n      component: 'h2',\n      children: '{{entry.title}}',\n    }),\n    [id('item-date')]: item('item-date', {\n      variant: 'caption',\n      children: '{{entry.date}}',\n      sx: { color: 'text.secondary' },\n    }),\n    [id('item-excerpt')]: item('item-excerpt', {\n      variant: 'body1',\n      children: '{{entry.excerpt}}',\n    }),\n    [id('item-link')]: {\n      $id: id('item-link'),\n      componentId: 'muiScreenLink',\n      pluginId: 'mui',\n      parentId: id('item'),\n      props: {\n        href: '{{entry.url}}',\n        children: 'Read more',\n        size: 'small',\n        sx: { alignSelf: 'flex-start' },\n      },\n    },\n  }\n}\n\n/** Entry vs list fallback selection for the routed content (AGL-551). */\nexport function buildCollectionFallbackNodes(content: {\n  collection: FallbackCollection\n  entries: FallbackEntry[]\n  entry: FallbackEntry | null\n  pagination?: FallbackListPagination | null\n  category?: FallbackListCategory | null\n  /** The composing site, for host-qualifying a media reference (AGL-1407). */\n  hostId?: string\n}): NodesMap {\n  return content.entry\n    ? buildCollectionEntryFallbackNodes(\n        content.collection,\n        content.entry,\n        content.hostId,\n      )\n    : buildCollectionListFallbackNodes(\n        content.collection,\n        content.entries.length > 0,\n        content.pagination ?? undefined,\n        content.category ?? undefined,\n      )\n}\n\nexport default buildCollectionFallbackNodes\n"],"names":["wistiaMediaId","Aglyn","FALLBACK_ID_PREFIX","id","suffix","formatDate","value","formatCollectionEntryDate","RENDERABLE_COVER_URL","cssUrlValue","url","replace","char","encodeURIComponent","ENTRY_MAX_WIDTH","LIST_MAX_WIDTH","LIST_SECTION_GAP","entryShell","maxWidth","stackProps","spacing","listShell","sx","display","flexDirection","gap","shell","childIds","layout","NODE_ROOT_ID","$id","componentId","nodes","pluginId","parentId","props","paddingTop","paddingBottom","typography","featuredVideoProps","entry","options","src","coverVideo","trim","resolveMediaSrc","hostId","undefined","poster","posterRenders","coverImage","description","seoDescription","excerpt","uploadDate","collectionEntryPublishedAtIso","publishedAt","title","width","buildCollectionEntryFallbackNodes","collection","entries","variant","component","children","date","tags","filter","Boolean","categoryName","resolveEntryCategoryName","categories","length","push","COLLECTION_ENTRY_META_COMPONENT_ID","category","join","coverRenders","test","video","VIDEO_COMPONENT_ID","role","backgroundImage","backgroundSize","backgroundPosition","borderRadius","minHeight","COLLECTION_ENTRY_BODY_COMPONENT_ID","markdown","body","COLLECTION_RELATED_COMPONENT_ID","heading","limit","COLLECTION_SHARE_COMPONENT_ID","href","slug","displayName","alignSelf","map","entryId","Object","fromEntries","paginationNodes","pagination","page","totalPages","prevUrl","nextUrl","collectionPaginationLinks","collectionSlug","categorySlug","color","direction","alignItems","justifyContent","childId","buildCollectionListFallbackNodes","hasEntries","titleId","name","pills","COLLECTION_CATEGORIES_COMPONENT_ID","allLabel","lead","emptyId","empty","item","pager","COLLECTION_ENTRIES_COMPONENT_ID","perPage","size","buildCollectionFallbackNodes","content"],"mappings":"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"}

package/src/lib/compose-author-page.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @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.
+ */
+import * as Aglyn from '@aglyn/aglyn/server';
+import type { AuthorContent } from './get-author-content';
+/**
+ * The host field naming the screen every author page renders through
+ * (AGL-2518).
+ *
+ * ## Why the HOST and not the author
+ *
+ * A collection names its own list and entry templates because a site
+ * legitimately designs its changelog differently from its blog. Author pages
+ * are not like that: they are one page shape repeated per person, and letting
+ * each author record name its own template would mean a masthead where the
+ * design changes as the reader clicks between colleagues — plus a template
+ * picker on a form whose whole subject is a byline.
+ *
+ * ## Why a SCREEN and not a layout
+ *
+ * The opposite call from `builtInPageLayoutId` (AGL-2513), and for the reason
+ * that comment gives in reverse. Search results have no design worth
+ * authoring — the platform composes the body and the site only chooses the
+ * chrome around it. An author page has: a portrait, a bio, a role, links, and
+ * a listing whose cards a designer wants to match the blog's. That is a page,
+ * so the author designs it as one, with `{{author.*}}` tokens and the same
+ * Collection entries block every list template uses.
+ *
+ * Unset is the ordinary case rather than a misconfiguration, and it renders
+ * the built-in body — bylines link to this address, so it must always answer.
+ */
+export declare const AUTHOR_PAGE_SCREEN_FIELD: "authorScreenId";
+/**
+ * The pseudo-collection an author page's entries block resolves against.
+ *
+ * The compose pipeline keys entry sources by collection slug, and this page
+ * has no single collection — it mixes them. Its entries are handed over
+ * already in hand (`ComposeCollectionContext.entries`), which is a path that
+ * never touches Firestore, so the key only has to be a name that no real
+ * collection can take: a collection slug is a URL segment, and this is not a
+ * legal one.
+ *
+ * It never reaches a URL. Every entry on this page carries its OWN
+ * `collectionSlug` out of the read that found it, and `collectionEntryTokens`
+ * prefers that — which is the whole reason a cross-collection listing can
+ * build correct `entry.url`s at all.
+ */
+export declare const AUTHOR_ENTRIES_SOURCE_SLUG = "__author__";
+/** What the author route renders. */
+export interface ComposedAuthorPage {
+    /** The template screen doc, when one is designated; null for the built-in. */
+    screen: Record<string, any> | null;
+    nodes: Record<string, any>;
+    /**
+     * The current pair of each picture the head's card may name (AGL-2850): the
+     * author's share card, then their portrait. Read in the composition's
+     * batch, and absent when it answered for neither.
+     */
+    socialImageFacts?: Aglyn.SocialImageAssetFacts;
+}
+/**
+ * An author page composed through the screen the host designated (AGL-2518).
+ *
+ * The `composeCollectionTemplatePage` shape: the screen goes through the
+ * NORMAL published pipeline — theme, shared layout, reusable components,
+ * Collection entries blocks — with `{{author.*}}` and `{{pagination.*}}`
+ * substituted and Author Profile blocks filled from the record.
+ *
+ * Returns null when no screen is designated, or when the designated one has
+ * been deleted, so the caller falls through to the built-in body rather than
+ * serving a 404 for a page a byline links to.
+ */
+export declare function composeAuthorTemplatePage(options: {
+    hostId: string;
+    host: any;
+    content: AuthorContent;
+}): Promise<ComposedAuthorPage | null>;
+/**
+ * The built-in author page (AGL-2518) — the body this file's own nodes build,
+ * grafted into the site's shared layout so it carries the same header, nav and
+ * footer as the posts it links to.
+ *
+ * Which layout is the host's to choose (`resolveBuiltInPageLayoutId`), shared
+ * with site search so the two platform-built pages of a site cannot end up in
+ * different chrome.
+ *
+ * Fail-open to `null`, and the route then renders the body with no chrome at
+ * all. A person's page must not be the page that 500s because a layout was
+ * deleted.
+ */
+export declare function composeAuthorFallbackPage(options: {
+    hostId: string;
+    host: any;
+    content: AuthorContent;
+}): Promise<ComposedAuthorPage | null>;
+export default composeAuthorTemplatePage;

package/src/lib/compose-author-page.js

@@ -0,0 +1,225 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ import * as Aglyn from "@aglyn/aglyn/server";
+import buildAuthorPageNodes from "./author-page-nodes.js";
+import { resolveBuiltInPageLayoutId } from "./built-in-page-layout.js";
+import composeScreenNodes, { composeNodesWithChrome } from "./compose-screen-nodes.js";
+import getScreen from "./get-screen.js";
+import { collectSocialImageFacts } from "./social-image-facts.js";
+/**
+ * The host field naming the screen every author page renders through
+ * (AGL-2518).
+ *
+ * ## Why the HOST and not the author
+ *
+ * A collection names its own list and entry templates because a site
+ * legitimately designs its changelog differently from its blog. Author pages
+ * are not like that: they are one page shape repeated per person, and letting
+ * each author record name its own template would mean a masthead where the
+ * design changes as the reader clicks between colleagues — plus a template
+ * picker on a form whose whole subject is a byline.
+ *
+ * ## Why a SCREEN and not a layout
+ *
+ * The opposite call from `builtInPageLayoutId` (AGL-2513), and for the reason
+ * that comment gives in reverse. Search results have no design worth
+ * authoring — the platform composes the body and the site only chooses the
+ * chrome around it. An author page has: a portrait, a bio, a role, links, and
+ * a listing whose cards a designer wants to match the blog's. That is a page,
+ * so the author designs it as one, with `{{author.*}}` tokens and the same
+ * Collection entries block every list template uses.
+ *
+ * Unset is the ordinary case rather than a misconfiguration, and it renders
+ * the built-in body — bylines link to this address, so it must always answer.
+ */ export const AUTHOR_PAGE_SCREEN_FIELD = 'authorScreenId';
+/**
+ * The pseudo-collection an author page's entries block resolves against.
+ *
+ * The compose pipeline keys entry sources by collection slug, and this page
+ * has no single collection — it mixes them. Its entries are handed over
+ * already in hand (`ComposeCollectionContext.entries`), which is a path that
+ * never touches Firestore, so the key only has to be a name that no real
+ * collection can take: a collection slug is a URL segment, and this is not a
+ * legal one.
+ *
+ * It never reaches a URL. Every entry on this page carries its OWN
+ * `collectionSlug` out of the read that found it, and `collectionEntryTokens`
+ * prefers that — which is the whole reason a cross-collection listing can
+ * build correct `entry.url`s at all.
+ */ export const AUTHOR_ENTRIES_SOURCE_SLUG = '__author__';
+/** The tokens and entry context both compose paths share. */ function authorComposeContext(content) {
+    var _content_author, _content_author1;
+    const address = content.author ? {
+        author: content.author
+    } : {
+        authorName: content.slug
+    };
+    const pager = Aglyn.contentAuthorPaginationLinks(_extends({}, address, {
+        page: content.page,
+        totalPages: content.totalPages
+    }));
+    return {
+        /**
+     * The pictures the head builds the card from, in its order: the share
+     * card, then the portrait (AGL-2850). The author head reads the record
+     * alone and never the site default, so the host's image is not one.
+     */ cardImages: [
+            (_content_author = content.author) == null ? void 0 : _content_author.seoImage,
+            (_content_author1 = content.author) == null ? void 0 : _content_author1.image
+        ],
+        tokens: _extends({}, Aglyn.contentAuthorTokens(content.author, {
+            entryCount: content.totalEntries
+        }), {
+            // The byline falls back to the raw segment for an unknown author, so a
+            // heading bound to `{{author.name}}` prints something either way.
+            'author.name': content.name,
+            // Named `pagination.*` rather than `author.page*`, so a designer who has
+            // already built a pager on a collection list template rebuilds nothing
+            // here — and so the two pagers cannot drift into two spellings of the
+            // same four values. The edges are the empty string, which is what makes
+            // an unconditional binding correct on page 1 of 1.
+            'pagination.page': String(pager.page),
+            'pagination.totalPages': String(pager.totalPages),
+            'pagination.prevUrl': pager.prevUrl,
+            'pagination.nextUrl': pager.nextUrl
+        }),
+        collection: {
+            slug: AUTHOR_ENTRIES_SOURCE_SLUG,
+            // The slug above is a key, not an address (AGL-2524) — so a block that
+            // would build a URL out of it resolves nothing instead.
+            routeless: true,
+            // Already narrowed to this author AND to this page's window by the
+            // loader, for the reason the category route states: a page count
+            // computed over the whole set advertises pages that render empty.
+            entries: content.entries,
+            categories: content.categories,
+            page: content.page
+        }
+    };
+}
+/**
+ * An author page composed through the screen the host designated (AGL-2518).
+ *
+ * The `composeCollectionTemplatePage` shape: the screen goes through the
+ * NORMAL published pipeline — theme, shared layout, reusable components,
+ * Collection entries blocks — with `{{author.*}}` and `{{pagination.*}}`
+ * substituted and Author Profile blocks filled from the record.
+ *
+ * Returns null when no screen is designated, or when the designated one has
+ * been deleted, so the caller falls through to the built-in body rather than
+ * serving a 404 for a page a byline links to.
+ */ export async function composeAuthorTemplatePage(options) {
+    var _ref;
+    const { hostId, host, content } = options;
+    const screenId = String((_ref = host == null ? void 0 : host[AUTHOR_PAGE_SCREEN_FIELD]) != null ? _ref : '').trim();
+    if (!screenId) return null;
+    try {
+        // `allowTemplate`, exactly as a collection template is read: the screen is
+        // deliberately not servable at an address of its own, and this is the
+        // composition it exists for.
+        const templateRes = await getScreen({
+            hostId,
+            screenId,
+            allowTemplate: true
+        });
+        if (!templateRes.screen) return null;
+        const { cardImages, tokens, collection } = authorComposeContext(content);
+        const card = collectSocialImageFacts(cardImages);
+        const nodes = await composeScreenNodes({
+            hostId,
+            screenId,
+            screen: templateRes.screen,
+            tokens,
+            collection,
+            socialImages: card.socialImages,
+            // The designated screen's host variables, and its layout's, fill in
+            // from this site, as the built-in author page's already do (AGL-2883).
+            host: host
+        });
+        if (!nodes) return null;
+        /*
+      The screen document travels UNCHANGED, and deliberately carries no
+      composed SEO.
+
+      A collection template composes the entry's title and cover into
+      `screen.seo` because `page.tsx` reads that on its way to the head. An
+      author page does not take that path: its head branch has the author
+      RECORD in hand and builds the title, description and portrait from it
+      directly, before the screen branch is ever reached. Writing a second,
+      unread copy here would be a value that looks authoritative, is dead, and
+      goes stale the first time the head's rule changes — which is how a
+      template's stored title came to name every post in a collection
+      (AGL-1345).
+    */ return _extends({
+            screen: templateRes.screen,
+            nodes: Aglyn.expandContentAuthorProfile(nodes, content.author)
+        }, card.collected());
+    } catch (error) {
+        console.error('author template composition failed', error);
+        return null;
+    }
+}
+/**
+ * The built-in author page (AGL-2518) — the body this file's own nodes build,
+ * grafted into the site's shared layout so it carries the same header, nav and
+ * footer as the posts it links to.
+ *
+ * Which layout is the host's to choose (`resolveBuiltInPageLayoutId`), shared
+ * with site search so the two platform-built pages of a site cannot end up in
+ * different chrome.
+ *
+ * Fail-open to `null`, and the route then renders the body with no chrome at
+ * all. A person's page must not be the page that 500s because a layout was
+ * deleted.
+ */ export async function composeAuthorFallbackPage(options) {
+    const { hostId, host, content } = options;
+    try {
+        const layoutId = await resolveBuiltInPageLayoutId({
+            hostId,
+            host
+        });
+        const { cardImages, tokens, collection } = authorComposeContext(content);
+        const card = collectSocialImageFacts(cardImages);
+        const nodes = await composeNodesWithChrome({
+            hostId,
+            layoutId,
+            socialImages: card.socialImages,
+            screenNodes: buildAuthorPageNodes({
+                slug: content.slug,
+                name: content.name,
+                author: content.author,
+                hasEntries: content.entries.length > 0,
+                page: content.page,
+                perPage: content.perPage,
+                totalPages: content.totalPages
+            }),
+            tokens,
+            collection,
+            host: host
+        });
+        return nodes ? _extends({
+            screen: null,
+            nodes
+        }, card.collected()) : null;
+    } catch (error) {
+        console.error('author page composition failed', error);
+        return null;
+    }
+}
+export default composeAuthorTemplatePage;
+
+//# sourceMappingURL=compose-author-page.js.map

package/src/lib/compose-author-page.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/tenant/runtime/src/lib/compose-author-page.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 * as Aglyn from '@aglyn/aglyn/server'\nimport buildAuthorPageNodes from './author-page-nodes'\nimport { resolveBuiltInPageLayoutId } from './built-in-page-layout'\nimport composeScreenNodes, {\n  composeNodesWithChrome,\n} from './compose-screen-nodes'\nimport type { AuthorContent } from './get-author-content'\nimport getScreen from './get-screen'\nimport { collectSocialImageFacts } from './social-image-facts'\n\n/**\n * The host field naming the screen every author page renders through\n * (AGL-2518).\n *\n * ## Why the HOST and not the author\n *\n * A collection names its own list and entry templates because a site\n * legitimately designs its changelog differently from its blog. Author pages\n * are not like that: they are one page shape repeated per person, and letting\n * each author record name its own template would mean a masthead where the\n * design changes as the reader clicks between colleagues — plus a template\n * picker on a form whose whole subject is a byline.\n *\n * ## Why a SCREEN and not a layout\n *\n * The opposite call from `builtInPageLayoutId` (AGL-2513), and for the reason\n * that comment gives in reverse. Search results have no design worth\n * authoring — the platform composes the body and the site only chooses the\n * chrome around it. An author page has: a portrait, a bio, a role, links, and\n * a listing whose cards a designer wants to match the blog's. That is a page,\n * so the author designs it as one, with `{{author.*}}` tokens and the same\n * Collection entries block every list template uses.\n *\n * Unset is the ordinary case rather than a misconfiguration, and it renders\n * the built-in body — bylines link to this address, so it must always answer.\n */\nexport const AUTHOR_PAGE_SCREEN_FIELD = 'authorScreenId' as const\n\n/**\n * The pseudo-collection an author page's entries block resolves against.\n *\n * The compose pipeline keys entry sources by collection slug, and this page\n * has no single collection — it mixes them. Its entries are handed over\n * already in hand (`ComposeCollectionContext.entries`), which is a path that\n * never touches Firestore, so the key only has to be a name that no real\n * collection can take: a collection slug is a URL segment, and this is not a\n * legal one.\n *\n * It never reaches a URL. Every entry on this page carries its OWN\n * `collectionSlug` out of the read that found it, and `collectionEntryTokens`\n * prefers that — which is the whole reason a cross-collection listing can\n * build correct `entry.url`s at all.\n */\nexport const AUTHOR_ENTRIES_SOURCE_SLUG = '__author__'\n\n/** What the author route renders. */\nexport interface ComposedAuthorPage {\n  /** The template screen doc, when one is designated; null for the built-in. */\n  screen: Record<string, any> | null\n  nodes: Record<string, any>\n  /**\n   * The current pair of each picture the head's card may name (AGL-2850): the\n   * author's share card, then their portrait. Read in the composition's\n   * batch, and absent when it answered for neither.\n   */\n  socialImageFacts?: Aglyn.SocialImageAssetFacts\n}\n\n/** The tokens and entry context both compose paths share. */\nfunction authorComposeContext(content: AuthorContent) {\n  const address = content.author\n    ? { author: content.author }\n    : { authorName: content.slug }\n  const pager = Aglyn.contentAuthorPaginationLinks({\n    ...address,\n    page: content.page,\n    totalPages: content.totalPages,\n  })\n  return {\n    /**\n     * The pictures the head builds the card from, in its order: the share\n     * card, then the portrait (AGL-2850). The author head reads the record\n     * alone and never the site default, so the host's image is not one.\n     */\n    cardImages: [content.author?.seoImage, content.author?.image],\n    tokens: {\n      ...Aglyn.contentAuthorTokens(content.author, {\n        entryCount: content.totalEntries,\n      }),\n      // The byline falls back to the raw segment for an unknown author, so a\n      // heading bound to `{{author.name}}` prints something either way.\n      'author.name': content.name,\n      // Named `pagination.*` rather than `author.page*`, so a designer who has\n      // already built a pager on a collection list template rebuilds nothing\n      // here — and so the two pagers cannot drift into two spellings of the\n      // same four values. The edges are the empty string, which is what makes\n      // an unconditional binding correct on page 1 of 1.\n      'pagination.page': String(pager.page),\n      'pagination.totalPages': String(pager.totalPages),\n      'pagination.prevUrl': pager.prevUrl,\n      'pagination.nextUrl': pager.nextUrl,\n    } as Record<string, string>,\n    collection: {\n      slug: AUTHOR_ENTRIES_SOURCE_SLUG,\n      // The slug above is a key, not an address (AGL-2524) — so a block that\n      // would build a URL out of it resolves nothing instead.\n      routeless: true,\n      // Already narrowed to this author AND to this page's window by the\n      // loader, for the reason the category route states: a page count\n      // computed over the whole set advertises pages that render empty.\n      entries: content.entries,\n      categories: content.categories,\n      page: content.page,\n    },\n  }\n}\n\n/**\n * An author page composed through the screen the host designated (AGL-2518).\n *\n * The `composeCollectionTemplatePage` shape: the screen goes through the\n * NORMAL published pipeline — theme, shared layout, reusable components,\n * Collection entries blocks — with `{{author.*}}` and `{{pagination.*}}`\n * substituted and Author Profile blocks filled from the record.\n *\n * Returns null when no screen is designated, or when the designated one has\n * been deleted, so the caller falls through to the built-in body rather than\n * serving a 404 for a page a byline links to.\n */\nexport async function composeAuthorTemplatePage(options: {\n  hostId: string\n  host: any\n  content: AuthorContent\n}): Promise<ComposedAuthorPage | null> {\n  const { hostId, host, content } = options\n  const screenId = String(host?.[AUTHOR_PAGE_SCREEN_FIELD] ?? '').trim()\n  if (!screenId) return null\n  try {\n    // `allowTemplate`, exactly as a collection template is read: the screen is\n    // deliberately not servable at an address of its own, and this is the\n    // composition it exists for.\n    const templateRes = await getScreen({\n      hostId,\n      screenId,\n      allowTemplate: true,\n    })\n    if (!templateRes.screen) return null\n    const { cardImages, tokens, collection } = authorComposeContext(content)\n    const card = collectSocialImageFacts(cardImages)\n    const nodes = await composeScreenNodes({\n      hostId,\n      screenId,\n      screen: templateRes.screen,\n      tokens,\n      collection,\n      socialImages: card.socialImages,\n      // The designated screen's host variables, and its layout's, fill in\n      // from this site, as the built-in author page's already do (AGL-2883).\n      host: host as Aglyn.HostTokenSource,\n    })\n    if (!nodes) return null\n    /*\n      The screen document travels UNCHANGED, and deliberately carries no\n      composed SEO.\n\n      A collection template composes the entry's title and cover into\n      `screen.seo` because `page.tsx` reads that on its way to the head. An\n      author page does not take that path: its head branch has the author\n      RECORD in hand and builds the title, description and portrait from it\n      directly, before the screen branch is ever reached. Writing a second,\n      unread copy here would be a value that looks authoritative, is dead, and\n      goes stale the first time the head's rule changes — which is how a\n      template's stored title came to name every post in a collection\n      (AGL-1345).\n    */\n    return {\n      screen: templateRes.screen as Record<string, any>,\n      nodes: Aglyn.expandContentAuthorProfile(nodes, content.author),\n      ...card.collected(),\n    }\n  } catch (error) {\n    console.error('author template composition failed', error)\n    return null\n  }\n}\n\n/**\n * The built-in author page (AGL-2518) — the body this file's own nodes build,\n * grafted into the site's shared layout so it carries the same header, nav and\n * footer as the posts it links to.\n *\n * Which layout is the host's to choose (`resolveBuiltInPageLayoutId`), shared\n * with site search so the two platform-built pages of a site cannot end up in\n * different chrome.\n *\n * Fail-open to `null`, and the route then renders the body with no chrome at\n * all. A person's page must not be the page that 500s because a layout was\n * deleted.\n */\nexport async function composeAuthorFallbackPage(options: {\n  hostId: string\n  host: any\n  content: AuthorContent\n}): Promise<ComposedAuthorPage | null> {\n  const { hostId, host, content } = options\n  try {\n    const layoutId = await resolveBuiltInPageLayoutId({ hostId, host })\n    const { cardImages, tokens, collection } = authorComposeContext(content)\n    const card = collectSocialImageFacts(cardImages)\n    const nodes = await composeNodesWithChrome({\n      hostId,\n      layoutId,\n      socialImages: card.socialImages,\n      screenNodes: buildAuthorPageNodes({\n        slug: content.slug,\n        name: content.name,\n        author: content.author,\n        hasEntries: content.entries.length > 0,\n        page: content.page,\n        perPage: content.perPage,\n        totalPages: content.totalPages,\n      }),\n      tokens,\n      collection,\n      host: host as Aglyn.HostTokenSource,\n    })\n    return nodes ? { screen: null, nodes, ...card.collected() } : null\n  } catch (error) {\n    console.error('author page composition failed', error)\n    return null\n  }\n}\n\nexport default composeAuthorTemplatePage\n"],"names":["Aglyn","buildAuthorPageNodes","resolveBuiltInPageLayoutId","composeScreenNodes","composeNodesWithChrome","getScreen","collectSocialImageFacts","AUTHOR_PAGE_SCREEN_FIELD","AUTHOR_ENTRIES_SOURCE_SLUG","authorComposeContext","content","address","author","authorName","slug","pager","contentAuthorPaginationLinks","page","totalPages","cardImages","seoImage","image","tokens","contentAuthorTokens","entryCount","totalEntries","name","String","prevUrl","nextUrl","collection","routeless","entries","categories","composeAuthorTemplatePage","options","hostId","host","screenId","trim","templateRes","allowTemplate","screen","card","nodes","socialImages","expandContentAuthorProfile","collected","error","console","composeAuthorFallbackPage","layoutId","screenNodes","hasEntries","length","perPage"],"mappings":"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"}

package/src/lib/compose-collection-page.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @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.
+ */
+import * as Aglyn from '@aglyn/aglyn/server';
+import type { CollectionContent } from './get-collection-content';
+type CollectionDoc = NonNullable<CollectionContent['collection']>;
+/**
+ * Which template screen a collection route renders through (AGL-551):
+ * `/{collection}` uses `listScreenId`, `/{collection}/{entry}` uses
+ * `entryScreenId` — falling back to the legacy AGL-105 `templateScreenId`
+ * so existing blogs keep rendering. `undefined` means no template is set
+ * and the designed built-in fallback applies.
+ */
+export declare function resolveCollectionTemplateScreenId(collection: Pick<CollectionDoc, 'listScreenId' | 'entryScreenId' | 'templateScreenId'>, kind: 'list' | 'entry'): string | undefined;
+/**
+ * Page-level `{{collection.*}}` tokens for template screens (AGL-551), plus
+ * the routed category (AGL-1321) so a list template can name what it is
+ * showing — "Guides" rather than a heading that says "Blog" on every filtered
+ * URL. Both category tokens resolve to the empty string on the unfiltered
+ * listing, which is what makes them safe to bind unconditionally.
+ *
+ * `{{pagination.*}}` follows the same design (AGL-1386). One static list
+ * screen serves the bare listing, every `/page/{n}` and every
+ * `/category/{slug}`, so a hand-built pager on it renders identically on all
+ * of them: "Older →" on a category that has one page, pointing at a URL that
+ * dropped the filter. The URLs come from `collectionPaginationLinks`, which
+ * builds them through the shared listing-URL builder (so they carry the
+ * category) and resolves the EDGES TO THE EMPTY STRING — no previous page,
+ * no `prevUrl`. There is no runtime conditional to hide a link with (the
+ * `condition` field on nodes is editor-side field visibility, not a render
+ * gate), so the empty string is what makes an unconditional binding correct
+ * on every route: a link whose href does not resolve renders as an inert
+ * placeholder of the same element (AGL-1268/1357).
+ *
+ * This SURFACES what the platform already computes — the built-in fallback
+ * pager reads the same function, so the two cannot drift.
+ */
+export declare function collectionTokens(collection: Pick<CollectionDoc, 'displayName' | 'slug'>, category?: CollectionContent['category'], pagination?: CollectionContent['pagination']): Record<string, string>;
+export interface ComposedCollectionPage {
+    /** Template screen doc with the entry/collection SEO merged in. */
+    screen: Record<string, any>;
+    nodes: Record<string, any>;
+    /**
+     * The current pair of each asset the head's card may name (AGL-2850): the
+     * entry's cover, the template's image, the site default. Read in the
+     * composition's batch, and absent when it answered for none of them.
+     */
+    socialImageFacts?: Aglyn.SocialImageAssetFacts;
+}
+/**
+ * Renders a collection route through its designated template screen
+ * (AGL-551), the same mechanism as commerce PDP/collection templates: the
+ * screen composes through the NORMAL published pipeline — theme, shared
+ * layout, reusable components — with `{{entry.*}}`/`{{collection.*}}`
+ * tokens substituted and Collection entries blocks expanded. Returns null
+ * when no template is designated (or it fails to compose) so the caller
+ * falls through to the designed built-in fallback.
+ */
+export declare function composeCollectionTemplatePage(options: {
+    hostId: string;
+    content: CollectionContent;
+    /**
+     * The site, whose default card the head falls back to after the entry's
+     * cover and the template's image (AGL-2850). Its document is read in this
+     * page's batch with theirs.
+     */
+    host?: Aglyn.AglynHost | null;
+}): Promise<ComposedCollectionPage | null>;
+/**
+ * The designed built-in rendering (AGL-551): when a collection has no
+ * template screen, its routes still compose through the site's theme and
+ * the host's default shared layout (the home screen's layout) instead of
+ * the old unthemed article. Fail-open — any error returns null and the
+ * caller keeps the legacy plain rendering.
+ */
+export declare function composeCollectionFallbackPage(options: {
+    hostId: string;
+    host: Aglyn.AglynHost;
+    content: CollectionContent;
+}): Promise<Omit<ComposedCollectionPage, 'screen'> | null>;
+export default composeCollectionTemplatePage;