@aglyn/aglyn 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/app-utils/seo-page-facts.js

@@ -0,0 +1,155 @@
+/**
+ * @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 { buildPageMarkdown, headingLevelOf, isPageChromeNode, pageContentRootId } from "./page-markdown.js";
+/**
+ * What a page SAYS, read off its node tree (AGL-2910): the text a search
+ * listing summarizes, the headings, and the images — each heading and image
+ * by node id, so a finding can name the element it is about and a fix can
+ * address the element it changes.
+ *
+ * Pure, and the platform's: the SEO check (`seo-audit.ts`) judges a page by
+ * these facts, and anything that proposes a listing or a content fix reads
+ * the same ones rather than walking the tree its own way.
+ *
+ * The text is the page's Markdown representation, the one an agent is
+ * served, so what the listing summarizes is what a reader of the page gets.
+ * The walk starts where that serializer starts — the content region — and
+ * skips what it skips, through the same chrome predicate: a heading in the
+ * site's navigation is not the page's heading.
+ */ /** How much of a page's text the facts carry. A listing summarizes; it does not need the page. */ export const SEO_PAGE_TEXT_MAX_CHARS = 2000;
+/** How much text around an image describes it. */ const IMAGE_CONTEXT_MAX_CHARS = 160;
+/** The deepest a walk goes, and it stops at a cycle — a node map is data. */ const MAX_DEPTH = 64;
+/** The text components whose heading level `headingLevelOf` reads. */ const TEXT_COMPONENTS = new Set([
+    'muiTypography',
+    'muiInlineText',
+    'muiListItemText'
+]);
+const collapse = (value)=>value.replace(/\s+/g, ' ').trim();
+/** Author HTML to its text, for a heading stored as rich text. */ function htmlText(html) {
+    return collapse(html.replace(/<[^>]*>/g, ' ').replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&'));
+}
+/** A text component's own text, and whether it is plain (a fix can rewrite it). */ function textOf(props) {
+    const html = props['html'];
+    if (typeof html === 'string' && html.trim()) return {
+        text: htmlText(html),
+        plain: false
+    };
+    const children = props['children'];
+    return typeof children === 'string' ? {
+        text: collapse(children),
+        plain: true
+    } : {
+        text: '',
+        plain: true
+    };
+}
+const childIdsOf = (node)=>Array.isArray(node == null ? void 0 : node.nodes) ? (node == null ? void 0 : node.nodes).filter((id)=>typeof id === 'string') : [];
+/** Read the facts a listing and the SEO check need from one page's node map. */ export function seoPageFacts(nodes, options = {}) {
+    var _options_maxChars;
+    const empty = {
+        text: '',
+        wordCount: 0,
+        headings: [],
+        h1s: [],
+        images: [],
+        imagesMissingAlt: [],
+        contentRootId: null
+    };
+    if (!nodes) return empty;
+    const contentRootId = pageContentRootId(nodes, options.rootId);
+    if (!contentRootId) return empty;
+    const markdown = buildPageMarkdown({
+        nodes,
+        rootId: options.rootId
+    });
+    const text = markdown.trim().slice(0, (_options_maxChars = options.maxChars) != null ? _options_maxChars : SEO_PAGE_TEXT_MAX_CHARS);
+    const headings = [];
+    const images = [];
+    let lastText = '';
+    const seen = new Set();
+    const visit = (id, depth)=>{
+        var _node_props, _node_componentId, _props_html;
+        if (depth > MAX_DEPTH || seen.has(id)) return;
+        const node = nodes[id];
+        if (!node) return;
+        seen.add(id);
+        if (isPageChromeNode(node)) return;
+        const props = (_node_props = node.props) != null ? _node_props : {};
+        const componentId = String((_node_componentId = node.componentId) != null ? _node_componentId : '');
+        if (TEXT_COMPONENTS.has(componentId)) {
+            const { text: own, plain } = textOf(props);
+            const level = headingLevelOf(props);
+            if (own) {
+                if (level > 0) headings.push({
+                    nodeId: id,
+                    level,
+                    text: own,
+                    editable: plain
+                });
+                lastText = own;
+            }
+        } else if (componentId === 'markdown' && typeof props['content'] === 'string') {
+            for (const line of String(props['content']).split('\n')){
+                const match = /^(#{1,6})\s+(.+)$/.exec(line.trim());
+                if (match) {
+                    headings.push({
+                        nodeId: null,
+                        level: match[1].length,
+                        text: collapse(match[2]),
+                        editable: false
+                    });
+                }
+            }
+            lastText = collapse(String(props['content'])).slice(0, IMAGE_CONTEXT_MAX_CHARS);
+        } else if (componentId === 'custom-html' && typeof ((_props_html = props['html']) != null ? _props_html : props['children']) === 'string') {
+            var _props_html1;
+            const html = String((_props_html1 = props['html']) != null ? _props_html1 : props['children']);
+            for (const match of html.matchAll(/<h([1-6])[^>]*>([\s\S]*?)<\/h\1>/gi)){
+                headings.push({
+                    nodeId: null,
+                    level: Number(match[1]),
+                    text: htmlText(match[2]),
+                    editable: false
+                });
+            }
+        } else if (componentId === 'image') {
+            var _props_src;
+            const src = String((_props_src = props['src']) != null ? _props_src : '').trim();
+            if (src) {
+                var _props_alt;
+                images.push({
+                    nodeId: id,
+                    src,
+                    alt: collapse(String((_props_alt = props['alt']) != null ? _props_alt : '')),
+                    context: lastText.slice(0, IMAGE_CONTEXT_MAX_CHARS)
+                });
+            }
+        }
+        for (const childId of childIdsOf(node))visit(childId, depth + 1);
+    };
+    visit(contentRootId, 0);
+    return {
+        text,
+        wordCount: text ? text.split(/\s+/).filter(Boolean).length : 0,
+        headings,
+        h1s: headings.filter((heading)=>heading.level === 1),
+        images,
+        imagesMissingAlt: images.filter((image)=>!image.alt),
+        contentRootId
+    };
+}
+
+//# sourceMappingURL=seo-page-facts.js.map

package/src/lib/app-utils/seo-page-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/seo-page-facts.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  buildPageMarkdown,\n  headingLevelOf,\n  isPageChromeNode,\n  pageContentRootId,\n  type PageMarkdownNode,\n  type PageMarkdownNodes,\n} from './page-markdown'\n\n/**\n * What a page SAYS, read off its node tree (AGL-2910): the text a search\n * listing summarizes, the headings, and the images — each heading and image\n * by node id, so a finding can name the element it is about and a fix can\n * address the element it changes.\n *\n * Pure, and the platform's: the SEO check (`seo-audit.ts`) judges a page by\n * these facts, and anything that proposes a listing or a content fix reads\n * the same ones rather than walking the tree its own way.\n *\n * The text is the page's Markdown representation, the one an agent is\n * served, so what the listing summarizes is what a reader of the page gets.\n * The walk starts where that serializer starts — the content region — and\n * skips what it skips, through the same chrome predicate: a heading in the\n * site's navigation is not the page's heading.\n */\n\n/** How much of a page's text the facts carry. A listing summarizes; it does not need the page. */\nexport const SEO_PAGE_TEXT_MAX_CHARS = 2_000\n\n/** How much text around an image describes it. */\nconst IMAGE_CONTEXT_MAX_CHARS = 160\n\n/** The deepest a walk goes, and it stops at a cycle — a node map is data. */\nconst MAX_DEPTH = 64\n\n/** The text components whose heading level `headingLevelOf` reads. */\nconst TEXT_COMPONENTS: ReadonlySet<string> = new Set(['muiTypography', 'muiInlineText', 'muiListItemText'])\n\nexport interface SeoHeading {\n  /** The element, or `null` for a heading inside rich text a fix cannot address. */\n  nodeId: string | null\n  level: number\n  text: string\n  /** Whether a content fix can change it: a text component with plain text. */\n  editable: boolean\n}\n\nexport interface SeoImage {\n  nodeId: string\n  src: string\n  alt: string\n  /** The nearest heading or text before it, which is what the image illustrates. */\n  context: string\n}\n\nexport interface SeoPageFacts {\n  /** The page's Markdown body, capped. */\n  text: string\n  wordCount: number\n  headings: SeoHeading[]\n  h1s: SeoHeading[]\n  images: SeoImage[]\n  imagesMissingAlt: SeoImage[]\n  /** The node the content region starts at; a new heading goes first inside it. */\n  contentRootId: string | null\n}\n\nconst collapse = (value: string): string => value.replace(/\\s+/g, ' ').trim()\n\n/** Author HTML to its text, for a heading stored as rich text. */\nfunction htmlText(html: string): string {\n  return collapse(html.replace(/<[^>]*>/g, ' ').replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&'))\n}\n\n/** A text component's own text, and whether it is plain (a fix can rewrite it). */\nfunction textOf(props: Record<string, unknown>): { text: string; plain: boolean } {\n  const html = props['html']\n  if (typeof html === 'string' && html.trim()) return { text: htmlText(html), plain: false }\n  const children = props['children']\n  return typeof children === 'string' ? { text: collapse(children), plain: true } : { text: '', plain: true }\n}\n\nconst childIdsOf = (node: PageMarkdownNode | undefined): string[] =>\n  Array.isArray(node?.nodes) ? (node?.nodes as unknown[]).filter((id): id is string => typeof id === 'string') : []\n\n/** Read the facts a listing and the SEO check need from one page's node map. */\nexport function seoPageFacts(\n  nodes: PageMarkdownNodes | null | undefined,\n  options: { rootId?: string; maxChars?: number } = {},\n): SeoPageFacts {\n  const empty: SeoPageFacts = {\n    text: '',\n    wordCount: 0,\n    headings: [],\n    h1s: [],\n    images: [],\n    imagesMissingAlt: [],\n    contentRootId: null,\n  }\n  if (!nodes) return empty\n  const contentRootId = pageContentRootId(nodes, options.rootId)\n  if (!contentRootId) return empty\n\n  const markdown = buildPageMarkdown({ nodes, rootId: options.rootId })\n  const text = markdown.trim().slice(0, options.maxChars ?? SEO_PAGE_TEXT_MAX_CHARS)\n  const headings: SeoHeading[] = []\n  const images: SeoImage[] = []\n  let lastText = ''\n\n  const seen = new Set<string>()\n  const visit = (id: string, depth: number): void => {\n    if (depth > MAX_DEPTH || seen.has(id)) return\n    const node = nodes[id]\n    if (!node) return\n    seen.add(id)\n    if (isPageChromeNode(node)) return\n    const props = (node.props ?? {}) as Record<string, unknown>\n    const componentId = String(node.componentId ?? '')\n    if (TEXT_COMPONENTS.has(componentId)) {\n      const { text: own, plain } = textOf(props)\n      const level = headingLevelOf(props)\n      if (own) {\n        if (level > 0) headings.push({ nodeId: id, level, text: own, editable: plain })\n        lastText = own\n      }\n    } else if (componentId === 'markdown' && typeof props['content'] === 'string') {\n      for (const line of String(props['content']).split('\\n')) {\n        const match = /^(#{1,6})\\s+(.+)$/.exec(line.trim())\n        if (match) {\n          headings.push({ nodeId: null, level: match[1].length, text: collapse(match[2]), editable: false })\n        }\n      }\n      lastText = collapse(String(props['content'])).slice(0, IMAGE_CONTEXT_MAX_CHARS)\n    } else if (componentId === 'custom-html' && typeof (props['html'] ?? props['children']) === 'string') {\n      const html = String(props['html'] ?? props['children'])\n      for (const match of html.matchAll(/<h([1-6])[^>]*>([\\s\\S]*?)<\\/h\\1>/gi)) {\n        headings.push({ nodeId: null, level: Number(match[1]), text: htmlText(match[2]), editable: false })\n      }\n    } else if (componentId === 'image') {\n      const src = String(props['src'] ?? '').trim()\n      if (src) {\n        images.push({\n          nodeId: id,\n          src,\n          alt: collapse(String(props['alt'] ?? '')),\n          context: lastText.slice(0, IMAGE_CONTEXT_MAX_CHARS),\n        })\n      }\n    }\n    for (const childId of childIdsOf(node)) visit(childId, depth + 1)\n  }\n  visit(contentRootId, 0)\n\n  return {\n    text,\n    wordCount: text ? text.split(/\\s+/).filter(Boolean).length : 0,\n    headings,\n    h1s: headings.filter((heading) => heading.level === 1),\n    images,\n    imagesMissingAlt: images.filter((image) => !image.alt),\n    contentRootId,\n  }\n}\n"],"names":["buildPageMarkdown","headingLevelOf","isPageChromeNode","pageContentRootId","SEO_PAGE_TEXT_MAX_CHARS","IMAGE_CONTEXT_MAX_CHARS","MAX_DEPTH","TEXT_COMPONENTS","Set","collapse","value","replace","trim","htmlText","html","textOf","props","text","plain","children","childIdsOf","node","Array","isArray","nodes","filter","id","seoPageFacts","options","empty","wordCount","headings","h1s","images","imagesMissingAlt","contentRootId","rootId","markdown","slice","maxChars","lastText","seen","visit","depth","has","add","componentId","String","own","level","push","nodeId","editable","line","split","match","exec","length","matchAll","Number","src","alt","context","childId","Boolean","heading","image"],"mappings":"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"}

package/src/lib/app-utils/seo-site-scan.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @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 { type SeoAuditPage, type SeoAuditSite } from './seo-audit';
+/**
+ * Read a site for the SEO check (`seo-audit.ts`) the way its sitemap lists
+ * it: every screen the routing map publishes, less the template screens, the
+ * status pages and every screen that is not public — through the same shared
+ * predicates the tenant's `sitemap.xml` and `/llms.txt` apply, so the check
+ * covers exactly the pages a crawler is handed. Then each page's published
+ * version, and the shared layouts, for the links that decide which pages
+ * nothing points to.
+ *
+ * It knows nothing about the Firestore SDK. A caller hands it a
+ * {@link SeoScanStore} — the Admin SDK's `Firestore` satisfies it — and the
+ * template screen ids, which the tenant runtime resolves; so this module stays
+ * pure enough to import from anywhere, and a spec hands it a fake.
+ *
+ * Reads: one projected query of the screens, one of the layouts, and one
+ * version document per checked page and per layout — at most
+ * {@link SEO_AUDIT_MAX_PAGES} + {@link SEO_SCAN_LAYOUT_LIMIT} + 2.
+ */
+/** Shared layouts read for the links they carry. */
+export declare const SEO_SCAN_LAYOUT_LIMIT = 20;
+export interface SeoScanSnapshot {
+    readonly exists: boolean;
+    get(field: string): unknown;
+}
+export interface SeoScanQueryDocument {
+    readonly id: string;
+    data(): unknown;
+    get(field: string): unknown;
+    readonly ref: SeoScanDocumentRef;
+}
+export interface SeoScanQuery {
+    limit(count: number): SeoScanQuery;
+    get(): Promise<{
+        readonly docs: readonly SeoScanQueryDocument[];
+    }>;
+}
+export interface SeoScanCollection {
+    select(...fields: string[]): SeoScanQuery;
+    doc(id: string): SeoScanDocumentRef;
+}
+export interface SeoScanDocumentRef {
+    collection(name: string): SeoScanCollection;
+    get(): Promise<SeoScanSnapshot>;
+}
+/** What the scan reads through; the Admin SDK's `Firestore` is one. */
+export interface SeoScanStore {
+    collection(name: string): SeoScanCollection;
+}
+/** The host document fields the scan and the site findings read. */
+export interface SeoSiteHost {
+    displayName?: string;
+    screens?: Record<string, string>;
+    errorScreens?: Record<string, string>;
+    notFoundScreenId?: string | null;
+    seo?: {
+        title?: string;
+        separator?: string;
+        discourageSearchEngines?: boolean;
+        entity?: {
+            name?: string;
+            description?: string;
+        };
+        agent?: {
+            whenToUse?: string;
+        };
+    };
+}
+/** The screen document fields the scan reads. */
+interface SeoScreenDocument {
+    displayName?: string;
+    description?: string;
+    versionId?: string;
+    visibility?: unknown;
+    deletedAt?: unknown;
+    seo?: {
+        title?: string;
+        description?: string;
+        breadcrumb?: string;
+        image?: string;
+        imageAlt?: string;
+    };
+}
+export interface SeoScannedPage extends SeoAuditPage {
+    /** The listing as the screen document stores it: a title's variables unresolved. */
+    storedSeo: NonNullable<SeoScreenDocument['seo']>;
+    /** The page's node map as checked. */
+    nodes: Record<string, unknown> | null;
+}
+export interface SeoSiteScan {
+    pages: SeoScannedPage[];
+    /** Published pages past {@link SEO_AUDIT_MAX_PAGES}. */
+    skipped: number;
+    /** Customer-safe lines: a keyword line naming a page the site does not publish. */
+    notes: string[];
+}
+/** The site as the check reads it, from its host document. */
+export declare function seoAuditSiteOf(host: SeoSiteHost): SeoAuditSite;
+/**
+ * Read `hostId`'s published pages for the check.
+ *
+ * `keywords` are the target keyword lines a person typed (`/path: a, b`);
+ * `templateScreenIds` are the screens a collection, the store or the host
+ * renders other URLs through, which are not pages of their own.
+ */
+export declare function scanSeoSite(store: SeoScanStore, hostId: string, host: SeoSiteHost, options?: {
+    keywords?: unknown;
+    templateScreenIds?: Iterable<string>;
+}): Promise<SeoSiteScan>;
+export {};

package/src/lib/app-utils/seo-site-scan.js

@@ -0,0 +1,162 @@
+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 { screenRoutePathToUrl } from "./screen-route.js";
+import { nodesReferenceScreen } from "./screen-link-value.js";
+import { isScreenIndexable, isSearchDiscouraged, statusPageScreenIds } from "./search-indexing.js";
+import { SEO_AUDIT_MAX_PAGES, parseSeoKeywordLines, seoNormalizePath } from "./seo-audit.js";
+import { seoPageFacts } from "./seo-page-facts.js";
+import { resolveSeoTitleVariables } from "./seo-title-variables.js";
+import { decodeStoredNodes } from "./stored-nodes.js";
+/**
+ * Read a site for the SEO check (`seo-audit.ts`) the way its sitemap lists
+ * it: every screen the routing map publishes, less the template screens, the
+ * status pages and every screen that is not public — through the same shared
+ * predicates the tenant's `sitemap.xml` and `/llms.txt` apply, so the check
+ * covers exactly the pages a crawler is handed. Then each page's published
+ * version, and the shared layouts, for the links that decide which pages
+ * nothing points to.
+ *
+ * It knows nothing about the Firestore SDK. A caller hands it a
+ * {@link SeoScanStore} — the Admin SDK's `Firestore` satisfies it — and the
+ * template screen ids, which the tenant runtime resolves; so this module stays
+ * pure enough to import from anywhere, and a spec hands it a fake.
+ *
+ * Reads: one projected query of the screens, one of the layouts, and one
+ * version document per checked page and per layout — at most
+ * {@link SEO_AUDIT_MAX_PAGES} + {@link SEO_SCAN_LAYOUT_LIMIT} + 2.
+ */ /** Shared layouts read for the links they carry. */ export const SEO_SCAN_LAYOUT_LIMIT = 20;
+/** Version documents read at once. */ const READ_CHUNK = 10;
+/** Screen documents the projected query reads. */ const SCREEN_SCAN_LIMIT = 1000;
+const str = (value)=>typeof value === 'string' ? value.trim() : '';
+/** The site as the check reads it, from its host document. */ export function seoAuditSiteOf(host) {
+    var _ref, _ref1;
+    var _host_seo, _host_seo1;
+    return {
+        discouraged: isSearchDiscouraged(host),
+        entity: (_ref = (_host_seo = host.seo) == null ? void 0 : _host_seo.entity) != null ? _ref : {},
+        agent: (_ref1 = (_host_seo1 = host.seo) == null ? void 0 : _host_seo1.agent) != null ? _ref1 : {}
+    };
+}
+/** A version's node map and root, or `null` when it cannot be read. */ async function readVersionNodes(parent, versionId) {
+    if (!versionId) return null;
+    const snapshot = await parent.collection('versions').doc(versionId).get();
+    if (!snapshot.exists) return null;
+    const nodes = decodeStoredNodes(snapshot.get('nodes'));
+    if (!nodes) return null;
+    const rootId = snapshot.get('rootId');
+    return _extends({
+        nodes
+    }, typeof rootId === 'string' ? {
+        rootId
+    } : {});
+}
+async function inChunks(items, run) {
+    for(let start = 0; start < items.length; start += READ_CHUNK){
+        await Promise.all(items.slice(start, start + READ_CHUNK).map(run));
+    }
+}
+/**
+ * Read `hostId`'s published pages for the check.
+ *
+ * `keywords` are the target keyword lines a person typed (`/path: a, b`);
+ * `templateScreenIds` are the screens a collection, the store or the host
+ * renders other URLs through, which are not pages of their own.
+ */ export async function scanSeoSite(store, hostId, host, options = {}) {
+    var _host_screens, _options_templateScreenIds;
+    var _host_seo;
+    const hostRef = store.collection('hosts').doc(hostId);
+    const routing = (_host_screens = host.screens) != null ? _host_screens : {};
+    const [screenDocs, layoutDocs] = await Promise.all([
+        hostRef.collection('screens').select('visibility', 'seo', 'description', 'displayName', 'versionId', 'deletedAt').limit(SCREEN_SCAN_LIMIT).get(),
+        hostRef.collection('layouts').select('versionId').limit(SEO_SCAN_LAYOUT_LIMIT).get()
+    ]);
+    const screens = new Map(screenDocs.docs.map((doc)=>{
+        var _doc_data;
+        return [
+            doc.id,
+            (_doc_data = doc.data()) != null ? _doc_data : {}
+        ];
+    }));
+    const excluded = new Set([
+        ...statusPageScreenIds(host),
+        ...(_options_templateScreenIds = options.templateScreenIds) != null ? _options_templateScreenIds : []
+    ]);
+    const published = Object.entries(routing).filter(([screenId])=>!excluded.has(screenId)).filter(([screenId])=>{
+        const screen = screens.get(screenId);
+        return Boolean(screen) && !(screen == null ? void 0 : screen.deletedAt) && isScreenIndexable(screen);
+    }).map(([screenId, route])=>({
+            screenId,
+            path: screenRoutePathToUrl(String(route))
+        })).sort((a, b)=>a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+    const checked = published.slice(0, SEO_AUDIT_MAX_PAGES);
+    const versions = new Map();
+    await inChunks(checked, async ({ screenId })=>{
+        var _screens_get;
+        versions.set(screenId, await readVersionNodes(hostRef.collection('screens').doc(screenId), str((_screens_get = screens.get(screenId)) == null ? void 0 : _screens_get.versionId)));
+    });
+    const layoutNodes = [];
+    await inChunks(layoutDocs.docs.filter((doc)=>str(doc.get('versionId'))), async (doc)=>{
+        const version = await readVersionNodes(doc.ref, str(doc.get('versionId')));
+        if (version) layoutNodes.push(version.nodes);
+    });
+    const keywordsByPath = parseSeoKeywordLines(options.keywords);
+    const checkedPaths = new Set(checked.map((page)=>seoNormalizePath(page.path)));
+    const notes = Object.keys(keywordsByPath).filter((path)=>!checkedPaths.has(path)).map((path)=>`Keywords for ${path} were not used: no checked page is published at that address.`);
+    const siteName = str((_host_seo = host.seo) == null ? void 0 : _host_seo.title) || str(host.displayName);
+    const pages = checked.map(({ screenId, path })=>{
+        var _screens_get, _versions_get, _screen_seo, _keywordsByPath_seoNormalizePath, _ref;
+        var _host_seo;
+        const screen = (_screens_get = screens.get(screenId)) != null ? _screens_get : {};
+        const version = (_versions_get = versions.get(screenId)) != null ? _versions_get : null;
+        const storedSeo = (_screen_seo = screen.seo) != null ? _screen_seo : {};
+        const linkedFrom = layoutNodes.some((nodes)=>nodesReferenceScreen(nodes, screenId)) || checked.some((other)=>{
+            var _ref;
+            var _versions_get;
+            return other.screenId !== screenId && nodesReferenceScreen((_ref = (_versions_get = versions.get(other.screenId)) == null ? void 0 : _versions_get.nodes) != null ? _ref : null, screenId);
+        });
+        return {
+            screenId,
+            path,
+            name: str(screen.displayName) || path,
+            versionId: str(screen.versionId) || null,
+            // Judged as the head renders it: `{{page.name}} – {{site.name}}` on two
+            // pages is two different titles, and its length is the rendered one.
+            seo: _extends({}, storedSeo, {
+                title: resolveSeoTitleVariables(storedSeo.title, {
+                    'page.name': str(screen.displayName),
+                    'site.name': siteName,
+                    'site.separator': str((_host_seo = host.seo) == null ? void 0 : _host_seo.separator)
+                })
+            }),
+            storedSeo,
+            description: str(screen.description),
+            facts: seoPageFacts(version == null ? void 0 : version.nodes, {
+                rootId: version == null ? void 0 : version.rootId
+            }),
+            linkedFrom,
+            keywords: (_keywordsByPath_seoNormalizePath = keywordsByPath[seoNormalizePath(path)]) != null ? _keywordsByPath_seoNormalizePath : [],
+            nodes: (_ref = version == null ? void 0 : version.nodes) != null ? _ref : null
+        };
+    });
+    return {
+        pages,
+        skipped: Math.max(0, published.length - checked.length),
+        notes
+    };
+}
+
+//# sourceMappingURL=seo-site-scan.js.map

package/src/lib/app-utils/seo-site-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/seo-site-scan.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 { screenRoutePathToUrl } from './screen-route'\nimport { nodesReferenceScreen } from './screen-link-value'\nimport {\n  isScreenIndexable,\n  isSearchDiscouraged,\n  statusPageScreenIds,\n  type SearchIndexingScreen,\n} from './search-indexing'\nimport {\n  SEO_AUDIT_MAX_PAGES,\n  parseSeoKeywordLines,\n  seoNormalizePath,\n  type SeoAuditPage,\n  type SeoAuditSite,\n} from './seo-audit'\nimport { seoPageFacts } from './seo-page-facts'\nimport type { PageMarkdownNodes } from './page-markdown'\nimport { resolveSeoTitleVariables } from './seo-title-variables'\nimport { decodeStoredNodes } from './stored-nodes'\n\n/**\n * Read a site for the SEO check (`seo-audit.ts`) the way its sitemap lists\n * it: every screen the routing map publishes, less the template screens, the\n * status pages and every screen that is not public — through the same shared\n * predicates the tenant's `sitemap.xml` and `/llms.txt` apply, so the check\n * covers exactly the pages a crawler is handed. Then each page's published\n * version, and the shared layouts, for the links that decide which pages\n * nothing points to.\n *\n * It knows nothing about the Firestore SDK. A caller hands it a\n * {@link SeoScanStore} — the Admin SDK's `Firestore` satisfies it — and the\n * template screen ids, which the tenant runtime resolves; so this module stays\n * pure enough to import from anywhere, and a spec hands it a fake.\n *\n * Reads: one projected query of the screens, one of the layouts, and one\n * version document per checked page and per layout — at most\n * {@link SEO_AUDIT_MAX_PAGES} + {@link SEO_SCAN_LAYOUT_LIMIT} + 2.\n */\n\n/** Shared layouts read for the links they carry. */\nexport const SEO_SCAN_LAYOUT_LIMIT = 20\n\n/** Version documents read at once. */\nconst READ_CHUNK = 10\n\n/** Screen documents the projected query reads. */\nconst SCREEN_SCAN_LIMIT = 1000\n\n/* ---- The store, structurally ---------------------------------------------- */\n\nexport interface SeoScanSnapshot {\n  readonly exists: boolean\n  get(field: string): unknown\n}\n\nexport interface SeoScanQueryDocument {\n  readonly id: string\n  data(): unknown\n  get(field: string): unknown\n  readonly ref: SeoScanDocumentRef\n}\n\nexport interface SeoScanQuery {\n  limit(count: number): SeoScanQuery\n  get(): Promise<{ readonly docs: readonly SeoScanQueryDocument[] }>\n}\n\nexport interface SeoScanCollection {\n  select(...fields: string[]): SeoScanQuery\n  doc(id: string): SeoScanDocumentRef\n}\n\nexport interface SeoScanDocumentRef {\n  collection(name: string): SeoScanCollection\n  get(): Promise<SeoScanSnapshot>\n}\n\n/** What the scan reads through; the Admin SDK's `Firestore` is one. */\nexport interface SeoScanStore {\n  collection(name: string): SeoScanCollection\n}\n\n/* ---- What it reads --------------------------------------------------------- */\n\n/** The host document fields the scan and the site findings read. */\nexport interface SeoSiteHost {\n  displayName?: string\n  screens?: Record<string, string>\n  errorScreens?: Record<string, string>\n  notFoundScreenId?: string | null\n  seo?: {\n    title?: string\n    separator?: string\n    discourageSearchEngines?: boolean\n    entity?: { name?: string; description?: string }\n    agent?: { whenToUse?: string }\n  }\n}\n\n/** The screen document fields the scan reads. */\ninterface SeoScreenDocument {\n  displayName?: string\n  description?: string\n  versionId?: string\n  visibility?: unknown\n  deletedAt?: unknown\n  seo?: {\n    title?: string\n    description?: string\n    breadcrumb?: string\n    image?: string\n    imageAlt?: string\n  }\n}\n\nexport interface SeoScannedPage extends SeoAuditPage {\n  /** The listing as the screen document stores it: a title's variables unresolved. */\n  storedSeo: NonNullable<SeoScreenDocument['seo']>\n  /** The page's node map as checked. */\n  nodes: Record<string, unknown> | null\n}\n\nexport interface SeoSiteScan {\n  pages: SeoScannedPage[]\n  /** Published pages past {@link SEO_AUDIT_MAX_PAGES}. */\n  skipped: number\n  /** Customer-safe lines: a keyword line naming a page the site does not publish. */\n  notes: string[]\n}\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/** The site as the check reads it, from its host document. */\nexport function seoAuditSiteOf(host: SeoSiteHost): SeoAuditSite {\n  return {\n    discouraged: isSearchDiscouraged(host),\n    entity: host.seo?.entity ?? {},\n    agent: host.seo?.agent ?? {},\n  }\n}\n\n/** A version's node map and root, or `null` when it cannot be read. */\nasync function readVersionNodes(\n  parent: SeoScanDocumentRef,\n  versionId: string,\n): Promise<{ nodes: Record<string, unknown>; rootId?: string } | null> {\n  if (!versionId) return null\n  const snapshot = await parent.collection('versions').doc(versionId).get()\n  if (!snapshot.exists) return null\n  const nodes = decodeStoredNodes<Record<string, unknown>>(snapshot.get('nodes'))\n  if (!nodes) return null\n  const rootId = snapshot.get('rootId')\n  return { nodes, ...(typeof rootId === 'string' ? { rootId } : {}) }\n}\n\nasync function inChunks<T>(items: readonly T[], run: (item: T) => Promise<void>): Promise<void> {\n  for (let start = 0; start < items.length; start += READ_CHUNK) {\n    await Promise.all(items.slice(start, start + READ_CHUNK).map(run))\n  }\n}\n\n/**\n * Read `hostId`'s published pages for the check.\n *\n * `keywords` are the target keyword lines a person typed (`/path: a, b`);\n * `templateScreenIds` are the screens a collection, the store or the host\n * renders other URLs through, which are not pages of their own.\n */\nexport async function scanSeoSite(\n  store: SeoScanStore,\n  hostId: string,\n  host: SeoSiteHost,\n  options: { keywords?: unknown; templateScreenIds?: Iterable<string> } = {},\n): Promise<SeoSiteScan> {\n  const hostRef = store.collection('hosts').doc(hostId)\n  const routing = host.screens ?? {}\n  const [screenDocs, layoutDocs] = await Promise.all([\n    hostRef\n      .collection('screens')\n      .select('visibility', 'seo', 'description', 'displayName', 'versionId', 'deletedAt')\n      .limit(SCREEN_SCAN_LIMIT)\n      .get(),\n    hostRef.collection('layouts').select('versionId').limit(SEO_SCAN_LAYOUT_LIMIT).get(),\n  ])\n  const screens = new Map(screenDocs.docs.map((doc) => [doc.id, (doc.data() ?? {}) as SeoScreenDocument]))\n  const excluded = new Set<string>([...statusPageScreenIds(host), ...(options.templateScreenIds ?? [])])\n  const published = Object.entries(routing)\n    .filter(([screenId]) => !excluded.has(screenId))\n    .filter(([screenId]) => {\n      const screen = screens.get(screenId)\n      return Boolean(screen) && !screen?.deletedAt && isScreenIndexable(screen as SearchIndexingScreen)\n    })\n    .map(([screenId, route]) => ({ screenId, path: screenRoutePathToUrl(String(route)) }))\n    .sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0))\n  const checked = published.slice(0, SEO_AUDIT_MAX_PAGES)\n\n  const versions = new Map<string, { nodes: Record<string, unknown>; rootId?: string } | null>()\n  await inChunks(checked, async ({ screenId }) => {\n    versions.set(\n      screenId,\n      await readVersionNodes(hostRef.collection('screens').doc(screenId), str(screens.get(screenId)?.versionId)),\n    )\n  })\n  const layoutNodes: Record<string, unknown>[] = []\n  await inChunks(\n    layoutDocs.docs.filter((doc) => str(doc.get('versionId'))),\n    async (doc) => {\n      const version = await readVersionNodes(doc.ref, str(doc.get('versionId')))\n      if (version) layoutNodes.push(version.nodes)\n    },\n  )\n\n  const keywordsByPath = parseSeoKeywordLines(options.keywords)\n  const checkedPaths = new Set(checked.map((page) => seoNormalizePath(page.path)))\n  const notes = Object.keys(keywordsByPath)\n    .filter((path) => !checkedPaths.has(path))\n    .map((path) => `Keywords for ${path} were not used: no checked page is published at that address.`)\n\n  const siteName = str(host.seo?.title) || str(host.displayName)\n  const pages: SeoScannedPage[] = checked.map(({ screenId, path }) => {\n    const screen = screens.get(screenId) ?? {}\n    const version = versions.get(screenId) ?? null\n    const storedSeo = screen.seo ?? {}\n    const linkedFrom =\n      layoutNodes.some((nodes) => nodesReferenceScreen(nodes, screenId)) ||\n      checked.some(\n        (other) =>\n          other.screenId !== screenId &&\n          nodesReferenceScreen(versions.get(other.screenId)?.nodes ?? null, screenId),\n      )\n    return {\n      screenId,\n      path,\n      name: str(screen.displayName) || path,\n      versionId: str(screen.versionId) || null,\n      // Judged as the head renders it: `{{page.name}} – {{site.name}}` on two\n      // pages is two different titles, and its length is the rendered one.\n      seo: {\n        ...storedSeo,\n        title: resolveSeoTitleVariables(storedSeo.title, {\n          'page.name': str(screen.displayName),\n          'site.name': siteName,\n          'site.separator': str(host.seo?.separator),\n        }),\n      },\n      storedSeo,\n      description: str(screen.description),\n      facts: seoPageFacts(version?.nodes as PageMarkdownNodes | undefined, { rootId: version?.rootId }),\n      linkedFrom,\n      keywords: keywordsByPath[seoNormalizePath(path)] ?? [],\n      nodes: version?.nodes ?? null,\n    }\n  })\n  return { pages, skipped: Math.max(0, published.length - checked.length), notes }\n}\n"],"names":["screenRoutePathToUrl","nodesReferenceScreen","isScreenIndexable","isSearchDiscouraged","statusPageScreenIds","SEO_AUDIT_MAX_PAGES","parseSeoKeywordLines","seoNormalizePath","seoPageFacts","resolveSeoTitleVariables","decodeStoredNodes","SEO_SCAN_LAYOUT_LIMIT","READ_CHUNK","SCREEN_SCAN_LIMIT","str","value","trim","seoAuditSiteOf","host","discouraged","entity","seo","agent","readVersionNodes","parent","versionId","snapshot","collection","doc","get","exists","nodes","rootId","inChunks","items","run","start","length","Promise","all","slice","map","scanSeoSite","store","hostId","options","hostRef","routing","screens","screenDocs","layoutDocs","select","limit","Map","docs","id","data","excluded","Set","templateScreenIds","published","Object","entries","filter","screenId","has","screen","Boolean","deletedAt","route","path","String","sort","a","b","checked","versions","set","layoutNodes","version","ref","push","keywordsByPath","keywords","checkedPaths","page","notes","keys","siteName","title","displayName","pages","storedSeo","linkedFrom","some","other","name","separator","description","facts","skipped","Math","max"],"mappings":"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"}

package/src/lib/app-utils/seo-title-variables.js

@@ -71,7 +71,7 @@
     {
         name: 'page.name',
         label: 'Page name',
-        description: 'What this page is called — a screen’s display name.'
+        description: 'What this page is called — its display name.'
     },
     {
         name: 'site.separator',

package/src/lib/app-utils/seo-title-variables.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/seo-title-variables.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The variables a page title may be written in terms of, and how a written\n * title becomes a rendered one.\n *\n * ## Why this exists\n *\n * A title is verbatim (AGL-1341, and that rule is right — see `seo-title`), so\n * an author who wants the brand in a title TYPES it. Fifty screens on the\n * marketing site end in a literal ` | Aglyn`, which means the site name and\n * the character in front of it are stored fifty times, and changing either one\n * is fifty edits that nothing reminds you to make. `seo.separator` already\n * exists as a setting and every one of those titles ignores it.\n *\n * So a title may now be WRITTEN in terms of what it depends on:\n *\n * ```\n *   {{page.name}} {{site.separator}} {{site.name}}\n * ```\n *\n * and a site-name change is one edit in Host setup → SEO.\n *\n * ## ⛔ No rendered title changes because this shipped\n *\n * The whole feature is opt-in at the string level: a title with no `{{` in it\n * is returned unchanged, character for character, by the same code path that\n * returned it before. Nothing migrates the fifty existing titles — a migration\n * could not be output-preserving anyway, because ` | Aglyn` is not what\n * `{{site.separator}}{{site.name}}` resolves to on a host whose separator is\n * `-` and whose site title is the long form. They keep working as literals\n * until somebody decides otherwise, one at a time.\n *\n * `DEFAULT_TITLE_PATTERN` is held to the same standard: it is the composition\n * `resolveSeoTitle` already performed for a page with no authored title, said\n * in tokens instead of in code, and `seo-title.spec` pins that the two agree.\n *\n * ## The grammar is `{{…}}`, not `[…]`\n *\n * Because the platform already has one: the besigner's attribute fields, the\n * markdown blocks and the campaign editors all serialize `{{…}}` and the\n * people writing SEO titles are the same people who write those. A second\n * grammar for the same idea is a second thing to learn and a second parser to\n * keep in step.\n *\n * ## What is NOT a variable here\n *\n * Anything per-visitor or per-request. A `<title>` is rendered into a cached,\n * shared HTML document and read by crawlers, so a variable that resolved to\n * something about the reader would be wrong for everyone it was cached for.\n * These three are properties of the page and the site, both of which are the\n * same for everybody who asks for that URL.\n */\n\n/** A variable's name, as it is written between the braces. */\nexport type SeoTitleVariableName = 'page.name' | 'site.name' | 'site.separator'\n\nexport interface SeoTitleVariableDefinition {\n  name: SeoTitleVariableName\n  /** What the insert menu calls it. */\n  label: string\n  /** One line under the label, saying where the value comes from. */\n  description: string\n}\n\n/**\n * Every variable a title may use, in the order a picker should offer them —\n * which is the order they appear in the default pattern, so the menu reads as\n * the sentence it builds.\n */\nexport const SEO_TITLE_VARIABLES: readonly SeoTitleVariableDefinition[] = [\n  {\n    name: 'page.name',\n    label: 'Page name',\n    description: 'What this page is called — a screen’s display name.',\n  },\n  {\n    name: 'site.separator',\n    label: 'Separator',\n    description: 'The character from Host setup → SEO that joins the two.',\n  },\n  {\n    name: 'site.name',\n    label: 'Site name',\n    description: 'The site title from Host setup → SEO.',\n  },\n]\n\n/**\n * The composition every untitled page gets when the site sets no pattern of\n * its own.\n *\n * This is `resolveSeoTitle`'s previous hard-coded composition, written out:\n * name, separator padded by a space on each side, site title. It is a constant\n * rather than a string built at the call site so that the setting's default,\n * the placeholder the editor shows and the value the renderer falls back to\n * are one thing.\n */\nexport const DEFAULT_TITLE_PATTERN = '{{page.name}} {{site.separator}} {{site.name}}'\n\n/** The values the variables stand for, for one page of one site. */\nexport interface SeoTitleVariableValues {\n  'page.name'?: string | null\n  'site.name'?: string | null\n  'site.separator'?: string | null\n}\n\n/** Trimmed, or `''` for anything that is not a live string. */\nfunction clean(value?: string | null): string {\n  return typeof value === 'string' ? value.trim() : ''\n}\n\n/**\n * The separator a site uses when it has set none.\n *\n * An en dash, which is what `seo-title` has padded around since AGL-1341. It\n * lives here because `{{site.separator}}` has to resolve to the SAME character\n * the code composed with — a variable that stood for \"the separator, unless\n * it is unset, in which case nothing\" would silently change the title of every\n * untitled page on every site that never filled the field in.\n */\nexport const DEFAULT_TITLE_SEPARATOR = '\\u2013'\n\n/** The site's separator, defaulted the one way everything defaults it. */\nexport function seoSeparatorOrDefault(separator?: string | null): string {\n  return clean(separator) || DEFAULT_TITLE_SEPARATOR\n}\n\n/**\n * Whether a written value uses any variable at all.\n *\n * The cheap gate in front of every path here: a title with no `{{` is returned\n * by identity, which is what makes \"nothing renders differently\" a property of\n * the code rather than a claim about the data.\n */\nexport function hasSeoTitleVariables(value?: string | null): boolean {\n  return typeof value === 'string' && value.includes('{{')\n}\n\n/** Whether a name is one this catalog defines. */\nexport function isSeoTitleVariable(name: string): name is SeoTitleVariableName {\n  return SEO_TITLE_VARIABLES.some((variable) => variable.name === name)\n}\n\n/**\n * `{{ name }}` — the whole token, and the name inside it with its padding\n * trimmed, so a human who typed a space after the braces is not punished for\n * it.\n */\nconst TOKEN = /\\{\\{\\s*([a-zA-Z][\\w.]*)\\s*\\}\\}/g\n\ninterface Part {\n  /** What renders here, once the variable is resolved. */\n  text: string\n  /** The variable this came from, if it came from one. */\n  variable?: string\n}\n\n/** The written string as literal runs and variable slots, in order. */\nfunction partsOf(source: string, values: SeoTitleVariableValues): Part[] {\n  const parts: Part[] = []\n  let at = 0\n  TOKEN.lastIndex = 0\n  for (let match = TOKEN.exec(source); match; match = TOKEN.exec(source)) {\n    if (match.index > at) parts.push({ text: source.slice(at, match.index) })\n    const name = match[1]\n    parts.push({\n      variable: name,\n      // An unknown variable renders AS ITSELF — see the resolver's docblock.\n      text: !isSeoTitleVariable(name)\n        ? match[0]\n        : name === 'site.separator'\n          ? seoSeparatorOrDefault(values[name])\n          : clean(values[name]),\n    })\n    at = match.index + match[0].length\n  }\n  if (at < source.length) parts.push({ text: source.slice(at) })\n  return parts\n}\n\n/**\n * Resolve a written title into the one that is rendered.\n *\n * ## An unknown variable is left alone\n *\n * `{{page.subtitle}}` renders as itself, visibly, rather than as an empty gap.\n * A typo that vanished would produce a title that is silently missing a piece,\n * and the author's next look at the live page would show them a sentence that\n * merely reads a bit short. Leaving it visible is the version somebody\n * notices. The editor's picker and autocomplete are what keep it from\n * happening; this is what happens when they are bypassed.\n *\n * ## A separator needs something on BOTH sides\n *\n * This is `resolveSeoTitle`'s own rule (AGL-1341) and it survives the move into\n * a pattern, because it is the rule that stops `<title>` from beginning with a\n * dash on a page whose name is missing. A `{{site.separator}}` with nothing\n * rendered on one side of it is dropped, whatever order the pattern put the\n * pieces in — which is why the parts are walked rather than regex-substituted:\n * a substitution cannot see its neighbours.\n *\n * ## An empty variable takes its spacing with it\n *\n * Otherwise a site with no name set renders `Pricing  ` — the gap where the\n * missing piece was, and a trailing separator's worth of whitespace. Runs\n * collapse to one space and the result is trimmed.\n */\nexport function resolveSeoTitleVariables(\n  written: string | null | undefined,\n  values: SeoTitleVariableValues,\n): string {\n  const source = typeof written === 'string' ? written : ''\n  if (!hasSeoTitleVariables(source)) return source\n\n  const parts = partsOf(source, values)\n  const rendered = parts.map((part) => part.text)\n  // A separator survives only where something renders on each side of it.\n  parts.forEach((part, index) => {\n    if (part.variable !== 'site.separator') return\n    const live = (from: number, to: number) =>\n      rendered.slice(from, to).some((text) => text.trim())\n    if (!live(0, index) || !live(index + 1, rendered.length)) rendered[index] = ''\n  })\n\n  return rendered.join('').replace(/\\s{2,}/g, ' ').trim()\n}\n"],"names":["SEO_TITLE_VARIABLES","name","label","description","DEFAULT_TITLE_PATTERN","clean","value","trim","DEFAULT_TITLE_SEPARATOR","seoSeparatorOrDefault","separator","hasSeoTitleVariables","includes","isSeoTitleVariable","some","variable","TOKEN","partsOf","source","values","parts","at","lastIndex","match","exec","index","push","text","slice","length","resolveSeoTitleVariables","written","rendered","map","part","forEach","live","from","to","join","replace"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/seo-title-variables.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The variables a page title may be written in terms of, and how a written\n * title becomes a rendered one.\n *\n * ## Why this exists\n *\n * A title is verbatim (AGL-1341, and that rule is right — see `seo-title`), so\n * an author who wants the brand in a title TYPES it. Fifty screens on the\n * marketing site end in a literal ` | Aglyn`, which means the site name and\n * the character in front of it are stored fifty times, and changing either one\n * is fifty edits that nothing reminds you to make. `seo.separator` already\n * exists as a setting and every one of those titles ignores it.\n *\n * So a title may now be WRITTEN in terms of what it depends on:\n *\n * ```\n *   {{page.name}} {{site.separator}} {{site.name}}\n * ```\n *\n * and a site-name change is one edit in Host setup → SEO.\n *\n * ## ⛔ No rendered title changes because this shipped\n *\n * The whole feature is opt-in at the string level: a title with no `{{` in it\n * is returned unchanged, character for character, by the same code path that\n * returned it before. Nothing migrates the fifty existing titles — a migration\n * could not be output-preserving anyway, because ` | Aglyn` is not what\n * `{{site.separator}}{{site.name}}` resolves to on a host whose separator is\n * `-` and whose site title is the long form. They keep working as literals\n * until somebody decides otherwise, one at a time.\n *\n * `DEFAULT_TITLE_PATTERN` is held to the same standard: it is the composition\n * `resolveSeoTitle` already performed for a page with no authored title, said\n * in tokens instead of in code, and `seo-title.spec` pins that the two agree.\n *\n * ## The grammar is `{{…}}`, not `[…]`\n *\n * Because the platform already has one: the besigner's attribute fields, the\n * markdown blocks and the campaign editors all serialize `{{…}}` and the\n * people writing SEO titles are the same people who write those. A second\n * grammar for the same idea is a second thing to learn and a second parser to\n * keep in step.\n *\n * ## What is NOT a variable here\n *\n * Anything per-visitor or per-request. A `<title>` is rendered into a cached,\n * shared HTML document and read by crawlers, so a variable that resolved to\n * something about the reader would be wrong for everyone it was cached for.\n * These three are properties of the page and the site, both of which are the\n * same for everybody who asks for that URL.\n */\n\n/** A variable's name, as it is written between the braces. */\nexport type SeoTitleVariableName = 'page.name' | 'site.name' | 'site.separator'\n\nexport interface SeoTitleVariableDefinition {\n  name: SeoTitleVariableName\n  /** What the insert menu calls it. */\n  label: string\n  /** One line under the label, saying where the value comes from. */\n  description: string\n}\n\n/**\n * Every variable a title may use, in the order a picker should offer them —\n * which is the order they appear in the default pattern, so the menu reads as\n * the sentence it builds.\n */\nexport const SEO_TITLE_VARIABLES: readonly SeoTitleVariableDefinition[] = [\n  {\n    name: 'page.name',\n    label: 'Page name',\n    description: 'What this page is called — its display name.',\n  },\n  {\n    name: 'site.separator',\n    label: 'Separator',\n    description: 'The character from Host setup → SEO that joins the two.',\n  },\n  {\n    name: 'site.name',\n    label: 'Site name',\n    description: 'The site title from Host setup → SEO.',\n  },\n]\n\n/**\n * The composition every untitled page gets when the site sets no pattern of\n * its own.\n *\n * This is `resolveSeoTitle`'s previous hard-coded composition, written out:\n * name, separator padded by a space on each side, site title. It is a constant\n * rather than a string built at the call site so that the setting's default,\n * the placeholder the editor shows and the value the renderer falls back to\n * are one thing.\n */\nexport const DEFAULT_TITLE_PATTERN = '{{page.name}} {{site.separator}} {{site.name}}'\n\n/** The values the variables stand for, for one page of one site. */\nexport interface SeoTitleVariableValues {\n  'page.name'?: string | null\n  'site.name'?: string | null\n  'site.separator'?: string | null\n}\n\n/** Trimmed, or `''` for anything that is not a live string. */\nfunction clean(value?: string | null): string {\n  return typeof value === 'string' ? value.trim() : ''\n}\n\n/**\n * The separator a site uses when it has set none.\n *\n * An en dash, which is what `seo-title` has padded around since AGL-1341. It\n * lives here because `{{site.separator}}` has to resolve to the SAME character\n * the code composed with — a variable that stood for \"the separator, unless\n * it is unset, in which case nothing\" would silently change the title of every\n * untitled page on every site that never filled the field in.\n */\nexport const DEFAULT_TITLE_SEPARATOR = '\\u2013'\n\n/** The site's separator, defaulted the one way everything defaults it. */\nexport function seoSeparatorOrDefault(separator?: string | null): string {\n  return clean(separator) || DEFAULT_TITLE_SEPARATOR\n}\n\n/**\n * Whether a written value uses any variable at all.\n *\n * The cheap gate in front of every path here: a title with no `{{` is returned\n * by identity, which is what makes \"nothing renders differently\" a property of\n * the code rather than a claim about the data.\n */\nexport function hasSeoTitleVariables(value?: string | null): boolean {\n  return typeof value === 'string' && value.includes('{{')\n}\n\n/** Whether a name is one this catalog defines. */\nexport function isSeoTitleVariable(name: string): name is SeoTitleVariableName {\n  return SEO_TITLE_VARIABLES.some((variable) => variable.name === name)\n}\n\n/**\n * `{{ name }}` — the whole token, and the name inside it with its padding\n * trimmed, so a human who typed a space after the braces is not punished for\n * it.\n */\nconst TOKEN = /\\{\\{\\s*([a-zA-Z][\\w.]*)\\s*\\}\\}/g\n\ninterface Part {\n  /** What renders here, once the variable is resolved. */\n  text: string\n  /** The variable this came from, if it came from one. */\n  variable?: string\n}\n\n/** The written string as literal runs and variable slots, in order. */\nfunction partsOf(source: string, values: SeoTitleVariableValues): Part[] {\n  const parts: Part[] = []\n  let at = 0\n  TOKEN.lastIndex = 0\n  for (let match = TOKEN.exec(source); match; match = TOKEN.exec(source)) {\n    if (match.index > at) parts.push({ text: source.slice(at, match.index) })\n    const name = match[1]\n    parts.push({\n      variable: name,\n      // An unknown variable renders AS ITSELF — see the resolver's docblock.\n      text: !isSeoTitleVariable(name)\n        ? match[0]\n        : name === 'site.separator'\n          ? seoSeparatorOrDefault(values[name])\n          : clean(values[name]),\n    })\n    at = match.index + match[0].length\n  }\n  if (at < source.length) parts.push({ text: source.slice(at) })\n  return parts\n}\n\n/**\n * Resolve a written title into the one that is rendered.\n *\n * ## An unknown variable is left alone\n *\n * `{{page.subtitle}}` renders as itself, visibly, rather than as an empty gap.\n * A typo that vanished would produce a title that is silently missing a piece,\n * and the author's next look at the live page would show them a sentence that\n * merely reads a bit short. Leaving it visible is the version somebody\n * notices. The editor's picker and autocomplete are what keep it from\n * happening; this is what happens when they are bypassed.\n *\n * ## A separator needs something on BOTH sides\n *\n * This is `resolveSeoTitle`'s own rule (AGL-1341) and it survives the move into\n * a pattern, because it is the rule that stops `<title>` from beginning with a\n * dash on a page whose name is missing. A `{{site.separator}}` with nothing\n * rendered on one side of it is dropped, whatever order the pattern put the\n * pieces in — which is why the parts are walked rather than regex-substituted:\n * a substitution cannot see its neighbours.\n *\n * ## An empty variable takes its spacing with it\n *\n * Otherwise a site with no name set renders `Pricing  ` — the gap where the\n * missing piece was, and a trailing separator's worth of whitespace. Runs\n * collapse to one space and the result is trimmed.\n */\nexport function resolveSeoTitleVariables(\n  written: string | null | undefined,\n  values: SeoTitleVariableValues,\n): string {\n  const source = typeof written === 'string' ? written : ''\n  if (!hasSeoTitleVariables(source)) return source\n\n  const parts = partsOf(source, values)\n  const rendered = parts.map((part) => part.text)\n  // A separator survives only where something renders on each side of it.\n  parts.forEach((part, index) => {\n    if (part.variable !== 'site.separator') return\n    const live = (from: number, to: number) =>\n      rendered.slice(from, to).some((text) => text.trim())\n    if (!live(0, index) || !live(index + 1, rendered.length)) rendered[index] = ''\n  })\n\n  return rendered.join('').replace(/\\s{2,}/g, ' ').trim()\n}\n"],"names":["SEO_TITLE_VARIABLES","name","label","description","DEFAULT_TITLE_PATTERN","clean","value","trim","DEFAULT_TITLE_SEPARATOR","seoSeparatorOrDefault","separator","hasSeoTitleVariables","includes","isSeoTitleVariable","some","variable","TOKEN","partsOf","source","values","parts","at","lastIndex","match","exec","index","push","text","slice","length","resolveSeoTitleVariables","written","rendered","map","part","forEach","live","from","to","join","replace"],"mappings":"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"}