@aglyn/tenant-runtime 1.0.0-beta.143

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

@@ -0,0 +1,256 @@
+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 buildCollectionFallbackNodes from "./collection-fallback-nodes.js";
+import composeScreenNodes, { composeNodesWithChrome } from "./compose-screen-nodes.js";
+import { resolveBuiltInPageLayoutId } from "./built-in-page-layout.js";
+import getScreen from "./get-screen.js";
+import { collectSocialImageFacts } from "./social-image-facts.js";
+/**
+ * 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 function resolveCollectionTemplateScreenId(collection, kind) {
+    if (kind === 'list') return collection.listScreenId || undefined;
+    return collection.entryScreenId || collection.templateScreenId || 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 function collectionTokens(collection, category, pagination) {
+    var _ref, _ref1;
+    // An unpaginated listing is page 1 of 1 — both URLs empty, which reads as
+    // the honest "nowhere to page to" rather than a broken link.
+    const pager = Aglyn.collectionPaginationLinks(_extends({
+        collectionSlug: collection.slug
+    }, (category == null ? void 0 : category.slug) ? {
+        categorySlug: category.slug
+    } : {}, {
+        page: pagination == null ? void 0 : pagination.page,
+        totalPages: pagination == null ? void 0 : pagination.totalPages
+    }));
+    return {
+        'collection.name': collection.displayName,
+        'collection.slug': collection.slug,
+        'collection.category': (_ref = category == null ? void 0 : category.name) != null ? _ref : '',
+        'collection.categorySlug': (_ref1 = category == null ? void 0 : category.slug) != null ? _ref1 : '',
+        'pagination.page': String(pager.page),
+        'pagination.totalPages': String(pager.totalPages),
+        'pagination.prevUrl': pager.prevUrl,
+        'pagination.nextUrl': pager.nextUrl
+    };
+}
+/**
+ * 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 async function composeCollectionTemplatePage(options) {
+    var _templateRes_screen_seo;
+    var _templateRes_screen_seo1, _options_host_seo, _options_host, _content_pagination;
+    const { hostId, content } = options;
+    const collection = content.collection;
+    if (!collection) return null;
+    const kind = content.entry ? 'entry' : 'list';
+    const screenId = resolveCollectionTemplateScreenId(collection, kind);
+    if (!screenId) return null;
+    // The one read that WANTS a template document (AGL-1400): this is the
+    // composition it exists for, with `{{entry.*}}` substituted against the
+    // routed entry. Every path-resolving caller leaves the flag off and gets the
+    // 404 a template deserves at an address of its own.
+    const templateRes = await getScreen({
+        hostId,
+        screenId,
+        allowTemplate: true
+    });
+    if (!templateRes.screen) return null;
+    const entry = content.entry;
+    const tokens = entry ? _extends({}, collectionTokens(collection), Aglyn.collectionEntryTokens(entry, collection.slug, collection.categories)) : collectionTokens(collection, content.category, content.pagination);
+    // The head's card on this page, in its order: the entry's cover, the
+    // template's own image, then the site default (AGL-2850).
+    const card = collectSocialImageFacts([
+        entry == null ? void 0 : entry.coverImage,
+        (_templateRes_screen_seo1 = templateRes.screen.seo) == null ? void 0 : _templateRes_screen_seo1.image,
+        (_options_host = options.host) == null ? void 0 : (_options_host_seo = _options_host.seo) == null ? void 0 : _options_host_seo.image
+    ]);
+    const nodes = await composeScreenNodes({
+        hostId,
+        screenId,
+        screen: templateRes.screen,
+        socialImages: card.socialImages,
+        // The site the template renders for, so its host variables — and its
+        // layout's — fill in as they do on every other page (AGL-2883).
+        host: options.host,
+        tokens,
+        // List pages hand their already-fetched entries to the Collection
+        // entries block; entry pages carry the routed entry (AGL-582, Related
+        // posts) and let blocks fetch entry lists on demand (e.g. a "More
+        // posts" section on the article template). The category taxonomy
+        // rides along so `{{entry.category}}` resolves inside the blocks.
+        collection: entry ? {
+            slug: collection.slug,
+            entry,
+            categories: collection.categories
+        } : _extends({
+            slug: collection.slug,
+            // Already filtered to the routed category (AGL-1321) — the block
+            // repeats what the ROUTE resolved, so a designer-pinned
+            // `filterCategory` on the block narrows it further rather than
+            // fighting it.
+            entries: content.entries,
+            categories: collection.categories
+        }, ((_content_pagination = content.pagination) == null ? void 0 : _content_pagination.page) ? {
+            page: content.pagination.page
+        } : {}, content.category ? {
+            categorySlug: content.category.slug
+        } : {}, content.entriesReachedBound ? {
+            entriesReachedBound: true
+        } : {})
+    });
+    if (!nodes) return null;
+    const screenSeo = (_templateRes_screen_seo = templateRes.screen.seo) != null ? _templateRes_screen_seo : {};
+    const seo = entry ? _extends({}, screenSeo, {
+        title: entry.seoTitle || entry.title,
+        description: entry.seoDescription || entry.excerpt || undefined
+    }, entry.coverImage ? {
+        image: entry.coverImage,
+        imageWidth: undefined,
+        imageHeight: undefined,
+        imageAlt: entry.coverImageAlt || undefined
+    } : {
+        image: screenSeo.image || undefined
+    }) : //
+    // This used to default `title` to `collection.displayName`, which reads
+    // like a harmless fallback and is not: it made an authored title
+    // indistinguishable from a generated one by the time the head was built.
+    // The title rule (AGL-1341) turns on exactly that distinction — an
+    // authored title renders VERBATIM, a name joins the site title — so a
+    // consumer reading this could only choose between dropping the site
+    // title off every untitled list ("Changelog") or ignoring the author's
+    // title on every titled one ("Changelog – Acme" over the sentence they
+    // wrote). The collection name is still the fallback; it just belongs to
+    // the title resolver, as the page's `name`, alongside every other
+    // surface's fallback rather than baked into stored SEO here.
+    screenSeo;
+    return _extends({
+        screen: _extends({}, templateRes.screen, {
+            seo
+        }),
+        nodes
+    }, card.collected());
+}
+/**
+ * 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 async function composeCollectionFallbackPage(options) {
+    const { hostId, host, content } = options;
+    const collection = content.collection;
+    if (!collection) return null;
+    try {
+        var _content_entry, _host_seo, _content_pagination;
+        // The layout for a page the platform composed rather than the author
+        // (AGL-2513). Still the home screen's layout by default — the rule this
+        // branch has always followed — but the host can now name a different one,
+        // and site search reads the same setting so the two built-in pages of a
+        // site cannot end up in different chrome.
+        const layoutId = await resolveBuiltInPageLayoutId({
+            hostId,
+            host
+        });
+        const screenNodes = buildCollectionFallbackNodes({
+            collection,
+            entries: content.entries,
+            entry: content.entry,
+            pagination: content.pagination,
+            category: content.category,
+            // The cover resolves through `resolveMediaSrc` (AGL-1407), and an
+            // org-scoped reference has to name the site asking or a site-restricted
+            // asset will not serve.
+            hostId
+        });
+        // The head's card on a page with no template: the entry's cover, then the
+        // site default (AGL-2850).
+        const card = collectSocialImageFacts([
+            (_content_entry = content.entry) == null ? void 0 : _content_entry.coverImage,
+            host == null ? void 0 : (_host_seo = host.seo) == null ? void 0 : _host_seo.image
+        ]);
+        const nodes = await composeNodesWithChrome({
+            hostId,
+            layoutId,
+            screenNodes,
+            socialImages: card.socialImages,
+            // The layout's host variables fill in from this site (AGL-2883).
+            host,
+            // Entry routes resolve with an EMPTY entries list (the loader only
+            // fetched the one entry), so hand the routed entry over and let the
+            // Related posts block fetch the list on demand (AGL-582); list
+            // routes keep their already-fetched entries. Categories ride along
+            // for `categoryId` → name resolution.
+            collection: content.entry ? {
+                slug: collection.slug,
+                entry: content.entry,
+                categories: collection.categories
+            } : _extends({
+                slug: collection.slug,
+                entries: content.entries,
+                categories: collection.categories
+            }, ((_content_pagination = content.pagination) == null ? void 0 : _content_pagination.page) ? {
+                page: content.pagination.page
+            } : {}, content.category ? {
+                categorySlug: content.category.slug
+            } : {}, content.entriesReachedBound ? {
+                entriesReachedBound: true
+            } : {})
+        });
+        return nodes ? _extends({
+            nodes
+        }, card.collected()) : null;
+    } catch (error) {
+        console.error(error);
+        return null;
+    }
+}
+export default composeCollectionTemplatePage;
+
+//# sourceMappingURL=compose-collection-page.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/tenant/runtime/src/lib/compose-collection-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 buildCollectionFallbackNodes from './collection-fallback-nodes'\nimport composeScreenNodes, {\n  composeNodesWithChrome,\n} from './compose-screen-nodes'\nimport { resolveBuiltInPageLayoutId } from './built-in-page-layout'\nimport type { CollectionContent } from './get-collection-content'\nimport getScreen from './get-screen'\nimport { collectSocialImageFacts } from './social-image-facts'\n\ntype CollectionDoc = NonNullable<CollectionContent['collection']>\n\n/**\n * Which template screen a collection route renders through (AGL-551):\n * `/{collection}` uses `listScreenId`, `/{collection}/{entry}` uses\n * `entryScreenId` — falling back to the legacy AGL-105 `templateScreenId`\n * so existing blogs keep rendering. `undefined` means no template is set\n * and the designed built-in fallback applies.\n */\nexport function resolveCollectionTemplateScreenId(\n  collection: Pick<\n    CollectionDoc,\n    'listScreenId' | 'entryScreenId' | 'templateScreenId'\n  >,\n  kind: 'list' | 'entry',\n): string | undefined {\n  if (kind === 'list') return collection.listScreenId || undefined\n  return collection.entryScreenId || collection.templateScreenId || undefined\n}\n\n/**\n * Page-level `{{collection.*}}` tokens for template screens (AGL-551), plus\n * the routed category (AGL-1321) so a list template can name what it is\n * showing — \"Guides\" rather than a heading that says \"Blog\" on every filtered\n * URL. Both category tokens resolve to the empty string on the unfiltered\n * listing, which is what makes them safe to bind unconditionally.\n *\n * `{{pagination.*}}` follows the same design (AGL-1386). One static list\n * screen serves the bare listing, every `/page/{n}` and every\n * `/category/{slug}`, so a hand-built pager on it renders identically on all\n * of them: \"Older →\" on a category that has one page, pointing at a URL that\n * dropped the filter. The URLs come from `collectionPaginationLinks`, which\n * builds them through the shared listing-URL builder (so they carry the\n * category) and resolves the EDGES TO THE EMPTY STRING — no previous page,\n * no `prevUrl`. There is no runtime conditional to hide a link with (the\n * `condition` field on nodes is editor-side field visibility, not a render\n * gate), so the empty string is what makes an unconditional binding correct\n * on every route: a link whose href does not resolve renders as an inert\n * placeholder of the same element (AGL-1268/1357).\n *\n * This SURFACES what the platform already computes — the built-in fallback\n * pager reads the same function, so the two cannot drift.\n */\nexport function collectionTokens(\n  collection: Pick<CollectionDoc, 'displayName' | 'slug'>,\n  category?: CollectionContent['category'],\n  pagination?: CollectionContent['pagination'],\n): Record<string, string> {\n  // An unpaginated listing is page 1 of 1 — both URLs empty, which reads as\n  // the honest \"nowhere to page to\" rather than a broken link.\n  const pager = Aglyn.collectionPaginationLinks({\n    collectionSlug: collection.slug,\n    ...(category?.slug ? { categorySlug: category.slug } : {}),\n    page: pagination?.page,\n    totalPages: pagination?.totalPages,\n  })\n  return {\n    'collection.name': collection.displayName,\n    'collection.slug': collection.slug,\n    'collection.category': category?.name ?? '',\n    'collection.categorySlug': category?.slug ?? '',\n    'pagination.page': String(pager.page),\n    'pagination.totalPages': String(pager.totalPages),\n    'pagination.prevUrl': pager.prevUrl,\n    'pagination.nextUrl': pager.nextUrl,\n  }\n}\n\nexport interface ComposedCollectionPage {\n  /** Template screen doc with the entry/collection SEO merged in. */\n  screen: Record<string, any>\n  nodes: Record<string, any>\n  /**\n   * The current pair of each asset the head's card may name (AGL-2850): the\n   * entry's cover, the template's image, the site default. Read in the\n   * composition's batch, and absent when it answered for none of them.\n   */\n  socialImageFacts?: Aglyn.SocialImageAssetFacts\n}\n\n/**\n * Renders a collection route through its designated template screen\n * (AGL-551), the same mechanism as commerce PDP/collection templates: the\n * screen composes through the NORMAL published pipeline — theme, shared\n * layout, reusable components — with `{{entry.*}}`/`{{collection.*}}`\n * tokens substituted and Collection entries blocks expanded. Returns null\n * when no template is designated (or it fails to compose) so the caller\n * falls through to the designed built-in fallback.\n */\nexport async function composeCollectionTemplatePage(options: {\n  hostId: string\n  content: CollectionContent\n  /**\n   * The site, whose default card the head falls back to after the entry's\n   * cover and the template's image (AGL-2850). Its document is read in this\n   * page's batch with theirs.\n   */\n  host?: Aglyn.AglynHost | null\n}): Promise<ComposedCollectionPage | null> {\n  const { hostId, content } = options\n  const collection = content.collection\n  if (!collection) return null\n  const kind = content.entry ? 'entry' : 'list'\n  const screenId = resolveCollectionTemplateScreenId(collection, kind)\n  if (!screenId) return null\n\n  // The one read that WANTS a template document (AGL-1400): this is the\n  // composition it exists for, with `{{entry.*}}` substituted against the\n  // routed entry. Every path-resolving caller leaves the flag off and gets the\n  // 404 a template deserves at an address of its own.\n  const templateRes = await getScreen({ hostId, screenId, allowTemplate: true })\n  if (!templateRes.screen) return null\n\n  const entry = content.entry\n  const tokens = entry\n    ? {\n        ...collectionTokens(collection),\n        // Category names resolve against the collection's taxonomy\n        // (AGL-582): `categoryId` lookup first, legacy string fallback.\n        ...Aglyn.collectionEntryTokens(\n          entry,\n          collection.slug,\n          collection.categories,\n        ),\n      }\n    : collectionTokens(collection, content.category, content.pagination)\n  // The head's card on this page, in its order: the entry's cover, the\n  // template's own image, then the site default (AGL-2850).\n  const card = collectSocialImageFacts([\n    entry?.coverImage,\n    (templateRes.screen as any).seo?.image,\n    options.host?.seo?.image,\n  ])\n  const nodes = await composeScreenNodes({\n    hostId,\n    screenId,\n    screen: templateRes.screen,\n    socialImages: card.socialImages,\n    // The site the template renders for, so its host variables — and its\n    // layout's — fill in as they do on every other page (AGL-2883).\n    host: options.host,\n    tokens,\n    // List pages hand their already-fetched entries to the Collection\n    // entries block; entry pages carry the routed entry (AGL-582, Related\n    // posts) and let blocks fetch entry lists on demand (e.g. a \"More\n    // posts\" section on the article template). The category taxonomy\n    // rides along so `{{entry.category}}` resolves inside the blocks.\n    collection: entry\n      ? { slug: collection.slug, entry, categories: collection.categories }\n      : {\n          slug: collection.slug,\n          // Already filtered to the routed category (AGL-1321) — the block\n          // repeats what the ROUTE resolved, so a designer-pinned\n          // `filterCategory` on the block narrows it further rather than\n          // fighting it.\n          entries: content.entries,\n          categories: collection.categories,\n          ...(content.pagination?.page\n            ? { page: content.pagination.page }\n            : {}),\n          ...(content.category ? { categorySlug: content.category.slug } : {}),\n          // The read's own bound (AGL-1516), which has to travel WITH the\n          // filtered entries above: once `content.entries` has been narrowed\n          // to a category, nothing downstream can tell a complete read from a\n          // truncated one by counting it.\n          ...(content.entriesReachedBound\n            ? { entriesReachedBound: true }\n            : {}),\n        },\n  })\n  if (!nodes) return null\n\n  const screenSeo = (templateRes.screen as any).seo ?? {}\n  const seo = entry\n    ? // Entry metadata drives the head (AGL-117 merge; AGL-582 overrides).\n      {\n        ...screenSeo,\n        title: entry.seoTitle || entry.title,\n        description: entry.seoDescription || entry.excerpt || undefined,\n        // The image and its companions move as ONE group (AGL-2417). The\n        // spread above carries the SCREEN's `imageWidth`/`imageHeight`/\n        // `imageAlt`, so an entry that supplies its own cover was describing\n        // it with the screen default's size and — once alts existed — with\n        // the screen default's DESCRIPTION: a sentence about a picture this\n        // card does not show, delivered to the reader least able to check.\n        // When the entry wins, its own companions win with it.\n        ...(entry.coverImage\n          ? {\n              image: entry.coverImage,\n              imageWidth: undefined,\n              imageHeight: undefined,\n              imageAlt: entry.coverImageAlt || undefined,\n            }\n          : { image: screenSeo.image || undefined }),\n      }\n    : // A LIST passes its screen's own SEO through UNTOUCHED (AGL-1345).\n      //\n      // This used to default `title` to `collection.displayName`, which reads\n      // like a harmless fallback and is not: it made an authored title\n      // indistinguishable from a generated one by the time the head was built.\n      // The title rule (AGL-1341) turns on exactly that distinction — an\n      // authored title renders VERBATIM, a name joins the site title — so a\n      // consumer reading this could only choose between dropping the site\n      // title off every untitled list (\"Changelog\") or ignoring the author's\n      // title on every titled one (\"Changelog – Acme\" over the sentence they\n      // wrote). The collection name is still the fallback; it just belongs to\n      // the title resolver, as the page's `name`, alongside every other\n      // surface's fallback rather than baked into stored SEO here.\n      screenSeo\n  return {\n    screen: { ...(templateRes.screen as any), seo },\n    nodes,\n    ...card.collected(),\n  }\n}\n\n/**\n * The designed built-in rendering (AGL-551): when a collection has no\n * template screen, its routes still compose through the site's theme and\n * the host's default shared layout (the home screen's layout) instead of\n * the old unthemed article. Fail-open — any error returns null and the\n * caller keeps the legacy plain rendering.\n */\nexport async function composeCollectionFallbackPage(options: {\n  hostId: string\n  host: Aglyn.AglynHost\n  content: CollectionContent\n}): Promise<Omit<ComposedCollectionPage, 'screen'> | null> {\n  const { hostId, host, content } = options\n  const collection = content.collection\n  if (!collection) return null\n  try {\n    // The layout for a page the platform composed rather than the author\n    // (AGL-2513). Still the home screen's layout by default — the rule this\n    // branch has always followed — but the host can now name a different one,\n    // and site search reads the same setting so the two built-in pages of a\n    // site cannot end up in different chrome.\n    const layoutId = await resolveBuiltInPageLayoutId({ hostId, host })\n    const screenNodes = buildCollectionFallbackNodes({\n      collection,\n      entries: content.entries,\n      entry: content.entry,\n      pagination: content.pagination,\n      category: content.category,\n      // The cover resolves through `resolveMediaSrc` (AGL-1407), and an\n      // org-scoped reference has to name the site asking or a site-restricted\n      // asset will not serve.\n      hostId,\n    })\n    // The head's card on a page with no template: the entry's cover, then the\n    // site default (AGL-2850).\n    const card = collectSocialImageFacts([\n      content.entry?.coverImage,\n      host?.seo?.image,\n    ])\n    const nodes = await composeNodesWithChrome({\n      hostId,\n      layoutId,\n      screenNodes,\n      socialImages: card.socialImages,\n      // The layout's host variables fill in from this site (AGL-2883).\n      host,\n      // Entry routes resolve with an EMPTY entries list (the loader only\n      // fetched the one entry), so hand the routed entry over and let the\n      // Related posts block fetch the list on demand (AGL-582); list\n      // routes keep their already-fetched entries. Categories ride along\n      // for `categoryId` → name resolution.\n      collection: content.entry\n        ? {\n            slug: collection.slug,\n            entry: content.entry,\n            categories: collection.categories,\n          }\n        : {\n            slug: collection.slug,\n            entries: content.entries,\n            categories: collection.categories,\n            ...(content.pagination?.page\n              ? { page: content.pagination.page }\n              : {}),\n            ...(content.category\n              ? { categorySlug: content.category.slug }\n              : {}),\n            // Same fact, same reason as the template path above (AGL-1516).\n            ...(content.entriesReachedBound\n              ? { entriesReachedBound: true }\n              : {}),\n          },\n    })\n    return nodes ? { nodes, ...card.collected() } : null\n  } catch (error) {\n    console.error(error)\n    return null\n  }\n}\n\nexport default composeCollectionTemplatePage\n"],"names":["Aglyn","buildCollectionFallbackNodes","composeScreenNodes","composeNodesWithChrome","resolveBuiltInPageLayoutId","getScreen","collectSocialImageFacts","resolveCollectionTemplateScreenId","collection","kind","listScreenId","undefined","entryScreenId","templateScreenId","collectionTokens","category","pagination","pager","collectionPaginationLinks","collectionSlug","slug","categorySlug","page","totalPages","displayName","name","String","prevUrl","nextUrl","composeCollectionTemplatePage","options","content","hostId","entry","screenId","templateRes","allowTemplate","screen","tokens","collectionEntryTokens","categories","card","coverImage","seo","image","host","nodes","socialImages","entries","entriesReachedBound","screenSeo","title","seoTitle","description","seoDescription","excerpt","imageWidth","imageHeight","imageAlt","coverImageAlt","collected","composeCollectionFallbackPage","layoutId","screenNodes","error","console"],"mappings":"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"}

package/src/lib/compose-screen-nodes.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @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 ComposeSocialImages } from './social-image-facts';
+/**
+ * Content-collection context for a compose (AGL-551): the collection the
+ * route resolved (list/entry template screens). `entries` rides along when
+ * the route already fetched them (list pages); blocks bound to other
+ * collections — or to this one when `entries` is absent — fetch on demand.
+ */
+export interface ComposeCollectionContext {
+    slug: string;
+    entries?: Aglyn.CollectionEntryRecord[];
+    /**
+     * The entry being rendered (AGL-582, entry-template screens / entry
+     * fallback) — the Related posts block resolves against it.
+     */
+    entry?: Aglyn.CollectionEntryRecord | null;
+    /**
+     * The routed collection's category taxonomy (AGL-582): entry
+     * `categoryId`s resolve to display names against it during expansion.
+     */
+    categories?: Aglyn.CollectionCategory[];
+    /**
+     * The list page the URL asked for (AGL-1321). Fills in an entries block
+     * that declares `perPage` but no `page` — design time cannot know which
+     * page a visitor is on.
+     */
+    page?: number;
+    /**
+     * The category segment the URL filtered on (AGL-1321); marks the current
+     * pill in a Category Pills block. `entries` arrives already filtered.
+     */
+    categorySlug?: string;
+    /**
+     * Whether the read behind `entries` stopped at its `.limit()` (AGL-1516).
+     * Travels with the entries because the search boxes downstream have to say
+     * what they actually searched, and — with the liveness gate and the route's
+     * category filter both in between — `entries.length` no longer tells them.
+     */
+    entriesReachedBound?: boolean;
+    /**
+     * Whether {@link slug} is a cache KEY rather than an address (AGL-2524).
+     *
+     * The author page mixes collections, and the compose pipeline keys entry
+     * sources by collection slug — so it hands over a synthetic one
+     * (`AUTHOR_ENTRIES_SOURCE_SLUG`) with its entries already in hand. That is
+     * harmless for the entries block, whose every row carries its OWN
+     * `collectionSlug` and builds `entry.url` from it, and for the search box,
+     * whose index is built the same way.
+     *
+     * It is NOT harmless for anything that builds a URL from the source's slug
+     * itself. Set this and such a block resolves nothing rather than pointing
+     * readers at `/{synthetic}/…`.
+     */
+    routeless?: boolean;
+}
+/**
+ * Shared post-version composition (AGL-551, extracted from
+ * `composeScreenNodes`): layout chrome, reusable components, repeatables,
+ * collection entries, bindings, function definitions, plugin installs,
+ * named tokens, denormalize, and last the current facts of each placed image
+ * and film, and of the social card the page is shared as. The screen path and
+ * the collection-fallback
+ * path (which has no screen doc) build identical trees through this one
+ * pipeline.
+ */
+export declare function composeNodesWithChrome(options: {
+    hostId: string;
+    /**
+     * The layout binding, or a PROMISE of it.
+     *
+     * The unresolved form exists for the same reason `screenNodes` accepts one
+     * (AGL-1428): the binding may live on the version document (key-present
+     * wins over the screen's), and awaiting the version before this call would
+     * put every host-scoped read back behind it. Only the layout-chain walk
+     * consumes the binding, so it alone waits; the rest of the chrome bundle
+     * still starts immediately.
+     */
+    layoutId?: string | null | Promise<string | null | undefined>;
+    /**
+     * The screen's values for the properties of the layouts it renders inside
+     * (AGL-2893), keyed by layout id — or a PROMISE of them, for the reason
+     * `layoutId` accepts one: they live on the version document beside the
+     * binding. Absent, every layout renders its properties' defaults.
+     */
+    layoutPropValues?: Aglyn.AglynScreenVersion['layoutPropValues'] | null | Promise<Aglyn.AglynScreenVersion['layoutPropValues'] | null | undefined>;
+    /**
+     * The screen's own nodes, or a PROMISE of them (AGL-1428).
+     *
+     * Accepting the unresolved form is what lets `composeScreenNodes` hand the
+     * version read over before it has finished, so the host-scoped reads below
+     * — none of which look at these nodes — overlap it instead of queueing
+     * behind it. Passing a resolved value behaves exactly as before, which is
+     * what every other caller does.
+     */
+    screenNodes: Record<string, any> | Promise<Record<string, any>>;
+    /** Entry-template tokens (AGL-105) substituted before denormalize. */
+    tokens?: Record<string, string>;
+    /** Routed content collection (AGL-551) for Collection entries blocks. */
+    collection?: ComposeCollectionContext;
+    /**
+     * The host document, for `host.*` tokens (AGL-1022).
+     *
+     * Passed in rather than read here: every caller already holds it, and
+     * `composeScreenNodes` was the largest single render phase before AGL-1225
+     * cut it to one round trip — adding a read back would spend that win on
+     * data we already have in hand.
+     */
+    host?: Aglyn.HostTokenSource | null;
+    /**
+     * The social card the head shares this page as (AGL-2850). The documents of
+     * the assets it names are read in the same batch as the images and films
+     * the tree places.
+     */
+    socialImages?: ComposeSocialImages;
+}): Promise<Record<string, any>>;
+/**
+ * Full published-render composition for one screen (extracted for AGL-87 so
+ * the SSG path and the password-unlock API build identical trees): applies
+ * a due publish schedule, loads the version, composes the shared layout
+ * chrome, grafts reusable components, and denormalizes.
+ */
+export declare function composeScreenNodes(options: {
+    hostId: string;
+    screenId: string;
+    screen: Aglyn.AglynScreen;
+    /** Entry-template tokens (AGL-105) substituted before denormalize. */
+    tokens?: Record<string, string>;
+    /** Routed content collection (AGL-551) for Collection entries blocks. */
+    collection?: ComposeCollectionContext;
+    /**
+     * Compose a specific version instead of the published one (AGL-253):
+     * experiment variants point at versions; schedules don't apply.
+     */
+    versionId?: string;
+    /** The host document, for `host.*` tokens (AGL-1022). */
+    host?: Aglyn.HostTokenSource | null;
+    /** The social card the head shares this page as (AGL-2850). */
+    socialImages?: ComposeSocialImages;
+}): Promise<Record<string, any> | null>;
+export default composeScreenNodes;