@aglyn/aglyn 1.0.0-beta.143

package/src/lib/app-utils/page-markdown.js

@@ -0,0 +1,385 @@
+/**
+ * @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.
+ */ /**
+ * A published page as Markdown — the representation an agent gets when it
+ * sends `Accept: text/markdown` (acceptmarkdown.com).
+ *
+ * ## Why serialize the NODE TREE and not the rendered HTML
+ *
+ * The obvious implementation is to render the page and run an HTML-to-Markdown
+ * converter over it. Every site on this platform is a node document, and the
+ * tree carries what the HTML has already thrown away: which text is a heading
+ * because the author said so rather than because it is large, which container
+ * is the page's content region, and which subtree is navigation. Converting
+ * the HTML back would be reconstructing, by heuristic, information we are
+ * holding.
+ *
+ * It is also cheaper by a wide margin — no React render, no plugin registry,
+ * no MUI — which is what makes this affordable to serve from a cached route on
+ * every site rather than only where somebody enabled it.
+ *
+ * ## The content region, not the document
+ *
+ * Serialization starts at the document's `main` landmark, which
+ * `stampDocumentLandmark` has already placed on the layout slot (the page
+ * content between the chrome) or on the screen root. That is what makes the
+ * output nav-free and footer-free without this module knowing anything about
+ * how a particular site builds its header — the same property that makes a
+ * Markdown variant worth serving at all.
+ *
+ * A page with no landmark falls back to the whole tree. Some content is always
+ * better than an empty document, and a page that shipped no landmark
+ * deliberately (see `document-landmark.ts`) has no content region to prefer.
+ *
+ * ## Chrome that lives INSIDE the content region
+ *
+ * A handful of components are navigation wherever they sit — an app bar, a nav
+ * menu, a language switcher, a pagination strip. They are skipped by id, and
+ * the list is deliberately short: everything not named recurses, so a plugin
+ * block nobody here has heard of still contributes its text instead of
+ * vanishing. Silence is the one failure mode that would be invisible to the
+ * author.
+ */ import { NODE_ROOT_ID } from "../canvas-manager/canvas-manager.js";
+import { authorHtmlToMarkdown, inlineAuthorHtmlToMarkdown } from "./author-html-markdown.js";
+import { resolveMarkdownSourceLinks } from "./markdown-lite.js";
+import { absoluteMediaSrc } from "./media-ref.js";
+import { SAFE_HREF_PATTERN, resolveScreenHref, splitLinkValue } from "./screen-link-value.js";
+/** The element name a node was told to render as (`props.component`). */ const elementOf = (node)=>{
+    var _ref;
+    var _node_props;
+    return String((_ref = node == null ? void 0 : (_node_props = node.props) == null ? void 0 : _node_props['component']) != null ? _ref : '').toLowerCase();
+};
+/** Components that are navigation wherever they appear. See the module note. */ const CHROME_COMPONENTS = new Set([
+    'muiAppBar',
+    'muiToolbar',
+    'muiDrawer',
+    'muiBreadcrumbs',
+    'navMenu',
+    'searchBox',
+    'languageSwitcher',
+    'themeModeSwitcher',
+    'muiPagination',
+    // An icon is decoration with no accessible text of its own. Its LABEL, where
+    // one exists, belongs to the control around it and is emitted there.
+    'icon'
+]);
+/**
+ * Whether a node is navigation rather than content: a chrome component, or
+ * an element its author declared `nav`, `header` or `footer`. Exported so a
+ * reader of a page's CONTENT — the SEO audit's heading and image scan
+ * (AGL-2910) — skips exactly what this serializer skips.
+ */ export function isPageChromeNode(node) {
+    var _node_componentId;
+    if (!node) return false;
+    if (CHROME_COMPONENTS.has(String((_node_componentId = node.componentId) != null ? _node_componentId : ''))) return true;
+    const element = elementOf(node);
+    return element === 'nav' || element === 'header' || element === 'footer';
+}
+/** Heading levels, as either `props.component` or `props.variant` spells them. */ const HEADING = /^h([1-6])$/;
+/**
+ * The heading level a text node publishes, or 0 for body copy.
+ *
+ * `component` wins over `variant` because they answer different questions and
+ * the platform lets them disagree: `variant` is the type STYLE (what size it is
+ * drawn at) and `component` is the ELEMENT (what it means). An author who set a
+ * hero line to look like an h1 but render as a `p` said it is not a heading,
+ * and the Markdown has to agree with the HTML or the two documents describe
+ * different pages.
+ */ export function headingLevelOf(props) {
+    var _ref, _ref1;
+    const element = String((_ref = props == null ? void 0 : props['component']) != null ? _ref : '').toLowerCase();
+    if (element) {
+        const asElement = HEADING.exec(element);
+        return asElement ? Number(asElement[1]) : 0;
+    }
+    const variant = String((_ref1 = props == null ? void 0 : props['variant']) != null ? _ref1 : '').toLowerCase();
+    const asVariant = HEADING.exec(variant);
+    return asVariant ? Number(asVariant[1]) : 0;
+}
+/**
+ * Escape the Markdown control characters that would otherwise re-parse.
+ *
+ * Only the characters that START a construct at the position they can occur in:
+ * a leading `#`, `>`, `-`, `+` or `1.` on its own line, and the emphasis,
+ * backtick and bracket characters anywhere. Escaping more than that produces
+ * output littered with backslashes, which is worse to read and worse to embed
+ * than the rare false heading it prevents.
+ */ export function escapeMarkdownText(value) {
+    return value.replace(/([\\`*_[\]<>])/g, '\\$1').replace(/^(\s*)([#>])/gm, '$1\\$2').replace(/^(\s*)([-+])(\s)/gm, '$1\\$2$3').replace(/^(\s*)(\d+)\.(\s)/gm, '$1$2\\.$3');
+}
+/** Collapse runs of whitespace to single spaces, as inline text renders. */ const collapse = (value)=>value.replace(/\s+/g, ' ').trim();
+/**
+ * A link target as Markdown should carry it: absolute where we can make it so.
+ *
+ * Site-relative is fine in a page — the browser has a document to resolve
+ * against. A Markdown body has no such context by the time an agent has copied
+ * it into a prompt, so a relative href there is a link to nowhere.
+ */ function absoluteHref(href, context) {
+    var _ref;
+    var _context_origin;
+    const value = href.trim();
+    if (!value) return '';
+    if (/^[a-z][a-z0-9+.-]*:/i.test(value) || value.startsWith('//')) return value;
+    const origin = (_ref = context == null ? void 0 : (_context_origin = context.origin) == null ? void 0 : _context_origin.replace(/\/+$/, '')) != null ? _ref : '';
+    if (!origin) return value;
+    return value.startsWith('/') ? `${origin}${value}` : `${origin}/${value}`;
+}
+/** The text a control shows, preferring its rich label over the plain one. */ function labelOf(props, context) {
+    const html = props == null ? void 0 : props['html'];
+    if (typeof html === 'string' && html.trim()) {
+        const rich = inlineAuthorHtmlToMarkdown(html, context);
+        if (rich.trim()) return collapse(rich);
+    }
+    const children = props == null ? void 0 : props['children'];
+    return typeof children === 'string' ? collapse(escapeMarkdownText(children)) : '';
+}
+/**
+ * Serialize the subtree at `rootId` into Markdown blocks.
+ *
+ * A depth budget and a visited set, because a node map is data: a document
+ * restored from a backup, or written through the REST API, can name a child
+ * that names it back. Recursing that tree is a stack overflow inside a request
+ * handler, i.e. a 500 on a page that renders fine — the renderer tolerates it
+ * because React unmounts a cycle, and this has nothing to stop it but itself.
+ */ function walk(nodes, rootId, context, blocks, seen, depth) {
+    var _node_componentId, _node_props;
+    if (depth > 64 || seen.has(rootId)) return;
+    const node = nodes[rootId];
+    if (!node) return;
+    seen.add(rootId);
+    const componentId = String((_node_componentId = node.componentId) != null ? _node_componentId : '');
+    // Chrome components, and `nav`, `header` and `footer` by their OWN
+    // declaration — an author who set the element picker to one of them named
+    // it navigation, and that is a stronger signal than any component-id list
+    // can be.
+    if (isPageChromeNode(node)) return;
+    const props = (_node_props = node.props) != null ? _node_props : {};
+    const childIds = Array.isArray(node.nodes) ? node.nodes.filter((id)=>typeof id === 'string') : [];
+    const recurse = ()=>{
+        for (const childId of childIds){
+            walk(nodes, childId, context, blocks, seen, depth + 1);
+        }
+    };
+    const push = (text)=>{
+        if (text.trim()) blocks.push({
+            text: text.trim()
+        });
+    };
+    switch(componentId){
+        case 'muiTypography':
+        case 'muiInlineText':
+        case 'muiListItemText':
+            {
+                const level = headingLevelOf(props);
+                const text = labelOf(props, context);
+                if (!text) {
+                    // A Typography with no text of its own but children beneath it is a
+                    // wrapper, which is how rich composites are built. Recurse rather than
+                    // dropping the subtree.
+                    recurse();
+                    return;
+                }
+                push(level > 0 ? `${'#'.repeat(level)} ${text}` : text);
+                return;
+            }
+        case 'markdown':
+            {
+                /*
+        Already Markdown. Emitted VERBATIM and never re-escaped: `content` is
+        the markdown-lite source an author typed, so escaping it would turn
+        their headings into literal `#` characters — the one transformation
+        that can only make this output worse. Its link REFERENCES are the one
+        exception (AGL-3118), resolved as the page resolves them.
+      */ const content = props['content'];
+                if (typeof content === 'string') push(authoredMarkdown(content, context));
+                return;
+            }
+        case 'custom-html':
+            {
+                var _props_html;
+                const html = (_props_html = props['html']) != null ? _props_html : props['children'];
+                if (typeof html === 'string') push(authorHtmlToMarkdown(html, context));
+                return;
+            }
+        case 'image':
+            {
+                var _props_src, _props_alt;
+                const src = absoluteMediaSrc(String((_props_src = props['src']) != null ? _props_src : '').trim(), {
+                    hostId: context == null ? void 0 : context.hostId,
+                    origin: context == null ? void 0 : context.origin
+                });
+                if (!src) return;
+                const alt = collapse(String((_props_alt = props['alt']) != null ? _props_alt : ''));
+                push(`![${escapeMarkdownText(alt)}](${src})`);
+                return;
+            }
+        case 'video':
+        case 'videoEmbed':
+            {
+                var _ref, _props_src1;
+                const src = String((_ref = (_props_src1 = props['src']) != null ? _props_src1 : props['url']) != null ? _ref : '').trim();
+                if (!src) return;
+                push(`[Video](${absoluteHref(src, context)})`);
+                return;
+            }
+        case 'muiButton':
+        case 'muiScreenLink':
+            {
+                const label = labelOf(props, context) || 'Link';
+                const href = screenLinkHref(props, context);
+                push(href ? `[${label}](${href})` : label);
+                return;
+            }
+        case 'muiList':
+            {
+                /*
+        The items are gathered into ONE block so they join as a list. Walking
+        them as siblings would put a blank line between every bullet, which is
+        a sequence of paragraphs beginning with a dash rather than a list.
+      */ const items = [];
+                for (const childId of childIds){
+                    walk(nodes, childId, context, items, seen, depth + 1);
+                }
+                const lines = items.map((item)=>item.text.replace(/\n/g, '\n  ')).filter(Boolean).map((text)=>`- ${text}`);
+                push(lines.join('\n'));
+                return;
+            }
+        default:
+            recurse();
+    }
+}
+/**
+ * Where a Button or Screen Link points.
+ *
+ * A screen link stores a SCREEN ID, not a path, and the path it resolves to is
+ * a per-request question — `screenRoutes` is the routing map the router
+ * actually honors, which is not the map publishing wrote (a collection's list
+ * template answers at the collection's slug, template screens answer nowhere).
+ * Emitting `href` alone would publish, in Markdown, the dead links AGL-1998
+ * removed from the HTML.
+ *
+ * `splitLinkValue` + `resolveScreenHref` rather than a local reading of the
+ * two props, because WHICH SLOT a screen reference arrives in is not fixed
+ * (AGL-1335): a `Link`-typed component prop is bound to whichever of
+ * `screenId`/`href` the author reached for, and a value in the `href` slot
+ * carries the stored `screen:<id>` spelling. Reading `screenId` alone published
+ * that token verbatim as a link target on every page built from a prop-fed
+ * CTA — ten of them on aglyn.com, unfollowable by the agents `/llms.txt` sends
+ * here (AGL-2740). These are the same two functions `useLinkTarget` resolves
+ * the HTML with, so the two representations of a page cannot drift again.
+ *
+ * An authored screen id that the map has lost resolves to NO link, exactly as
+ * the HTML renders it: falling back to the stored `href` there would re-publish
+ * the dead path AGL-1998 removed, which is the failure this function's own
+ * contract exists to prevent.
+ */ function screenLinkHref(props, context) {
+    const target = splitLinkValue(typeof props['screenId'] === 'string' ? props['screenId'] : undefined, typeof props['href'] === 'string' ? props['href'] : undefined);
+    if (target.screenId) {
+        var _ref;
+        const path = resolveScreenHref((_ref = context == null ? void 0 : context.screenRoutes) != null ? _ref : undefined, target.screenId);
+        return path ? absoluteHref(path, context) : '';
+    }
+    // The same protocol guard the linking elements apply. A `javascript:` href
+    // is inert in a Markdown body, but it is still a target an agent may be
+    // asked to follow, and a representation that offers one the page refuses to
+    // render is describing a different document.
+    return target.href && SAFE_HREF_PATTERN.test(target.href) ? absoluteHref(target.href, context) : '';
+}
+/**
+ * Authored markdown-lite — a Markdown element's content, an entry's body —
+ * as this document carries it: verbatim, except that each link REFERENCE
+ * (AGL-3118) points where the page's own link does, through the same routing
+ * map and the same `resolveScreenHref` as {@link screenLinkHref}, made
+ * absolute for the reason {@link absoluteHref} gives. A reference the map
+ * does not have becomes the link's text, as the page renders it: the stored
+ * `entry:…` is not a URL any reader can follow.
+ */ function authoredMarkdown(source, context) {
+    return resolveMarkdownSourceLinks(source, (reference)=>{
+        var _ref;
+        const path = resolveScreenHref((_ref = context == null ? void 0 : context.screenRoutes) != null ? _ref : undefined, reference);
+        return path ? absoluteHref(path, context) : undefined;
+    });
+}
+/**
+ * The node the document's content begins at.
+ *
+ * The `main` landmark first — `stampDocumentLandmark` puts it on the layout
+ * slot or the screen root — then the layout slot by component id, then the
+ * document root. Each fallback is wider than the last, so a tree that is
+ * missing the marker still serializes rather than returning nothing.
+ */ export function pageContentRootId(nodes, rootId = NODE_ROOT_ID) {
+    if (!nodes) return null;
+    for(const id in nodes){
+        if (elementOf(nodes[id]) === 'main') return id;
+    }
+    for(const id in nodes){
+        var _nodes_id;
+        if (((_nodes_id = nodes[id]) == null ? void 0 : _nodes_id.componentId) === 'layoutSlot') return id;
+    }
+    return nodes[rootId] ? rootId : null;
+}
+/**
+ * The whole Markdown representation of a page.
+ *
+ * @param body - already-Markdown body to use INSTEAD of walking nodes; the
+ *   content-entry case, where the stored body is markdown-lite source and
+ *   round-tripping it through the node tree could only lose fidelity.
+ */ export function buildPageMarkdown(options) {
+    var _options_front, _front_title, _front_description;
+    const front = (_options_front = options.front) != null ? _options_front : {};
+    const parts = [];
+    const title = collapse(String((_front_title = front.title) != null ? _front_title : ''));
+    if (title) parts.push(`# ${escapeMarkdownText(title)}`);
+    const description = collapse(String((_front_description = front.description) != null ? _front_description : ''));
+    if (description) parts.push(`> ${escapeMarkdownText(description)}`);
+    /*
+    The dateline is one line rather than YAML front matter. Front matter is
+    unparsed text to every Markdown reader that has not opted into it, so it
+    arrives in an agent's context as a block of `key: value` noise above the
+    content; a sentence is read correctly by all of them.
+  */ const meta = [];
+    if (front.author) meta.push(`By ${collapse(front.author)}`);
+    if (front.publishedAt) meta.push(`Published ${front.publishedAt}`);
+    if (front.updatedAt && front.updatedAt !== front.publishedAt) {
+        meta.push(`Updated ${front.updatedAt}`);
+    }
+    if (meta.length) parts.push(`_${meta.join(' · ')}_`);
+    if (typeof options.body === 'string' && options.body.trim()) {
+        parts.push(authoredMarkdown(options.body.trim(), options.context));
+    } else if (options.nodes) {
+        const contentRoot = pageContentRootId(options.nodes, options.rootId);
+        if (contentRoot) {
+            const blocks = [];
+            walk(options.nodes, contentRoot, options.context, blocks, new Set(), 0);
+            for (const block of blocks)parts.push(block.text);
+        }
+    }
+    if (front.canonicalUrl) {
+        // A source line, and the reason it is worth the two lines it costs: an
+        // agent that has copied this body into a prompt has no URL bar, so without
+        // it the document cannot be cited, re-fetched, or linked to by whatever
+        // reads it next.
+        parts.push('---', `Source: ${front.canonicalUrl}`);
+    }
+    /*
+    Collapse the runs of blank lines a nested walk leaves behind, and end with
+    exactly one newline. A Markdown body is compared byte-for-byte by caches
+    and by the conformance checkers agents run, so "tidy" here is a contract
+    rather than an aesthetic.
+  */ return `${parts.join('\n\n').replace(/\n{3,}/g, '\n\n').trim()}\n`;
+}
+
+//# sourceMappingURL=page-markdown.js.map

package/src/lib/app-utils/page-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/page-markdown.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 * A published page as Markdown — the representation an agent gets when it\n * sends `Accept: text/markdown` (acceptmarkdown.com).\n *\n * ## Why serialize the NODE TREE and not the rendered HTML\n *\n * The obvious implementation is to render the page and run an HTML-to-Markdown\n * converter over it. Every site on this platform is a node document, and the\n * tree carries what the HTML has already thrown away: which text is a heading\n * because the author said so rather than because it is large, which container\n * is the page's content region, and which subtree is navigation. Converting\n * the HTML back would be reconstructing, by heuristic, information we are\n * holding.\n *\n * It is also cheaper by a wide margin — no React render, no plugin registry,\n * no MUI — which is what makes this affordable to serve from a cached route on\n * every site rather than only where somebody enabled it.\n *\n * ## The content region, not the document\n *\n * Serialization starts at the document's `main` landmark, which\n * `stampDocumentLandmark` has already placed on the layout slot (the page\n * content between the chrome) or on the screen root. That is what makes the\n * output nav-free and footer-free without this module knowing anything about\n * how a particular site builds its header — the same property that makes a\n * Markdown variant worth serving at all.\n *\n * A page with no landmark falls back to the whole tree. Some content is always\n * better than an empty document, and a page that shipped no landmark\n * deliberately (see `document-landmark.ts`) has no content region to prefer.\n *\n * ## Chrome that lives INSIDE the content region\n *\n * A handful of components are navigation wherever they sit — an app bar, a nav\n * menu, a language switcher, a pagination strip. They are skipped by id, and\n * the list is deliberately short: everything not named recurses, so a plugin\n * block nobody here has heard of still contributes its text instead of\n * vanishing. Silence is the one failure mode that would be invisible to the\n * author.\n */\n\nimport { NODE_ROOT_ID } from '../canvas-manager/canvas-manager'\nimport { authorHtmlToMarkdown, inlineAuthorHtmlToMarkdown } from './author-html-markdown'\nimport { resolveMarkdownSourceLinks } from './markdown-lite'\nimport { absoluteMediaSrc } from './media-ref'\nimport {\n  SAFE_HREF_PATTERN,\n  resolveScreenHref,\n  splitLinkValue,\n} from './screen-link-value'\n\n/** The node shape this serializer reads; keeps callers free of the full type. */\nexport interface PageMarkdownNode {\n  componentId?: string\n  props?: Record<string, unknown> | null\n  /** Normalized documents carry child IDS; this never reads a denormalized tree. */\n  nodes?: unknown\n}\n\n/** A flat node map keyed by node id — exactly what the page route already holds. */\nexport type PageMarkdownNodes = Record<string, PageMarkdownNode>\n\n/** The element name a node was told to render as (`props.component`). */\nconst elementOf = (node: PageMarkdownNode | undefined): string =>\n  String(node?.props?.['component'] ?? '').toLowerCase()\n\n/** Components that are navigation wherever they appear. See the module note. */\nconst CHROME_COMPONENTS: ReadonlySet<string> = new Set([\n  'muiAppBar',\n  'muiToolbar',\n  'muiDrawer',\n  'muiBreadcrumbs',\n  'navMenu',\n  'searchBox',\n  'languageSwitcher',\n  'themeModeSwitcher',\n  'muiPagination',\n  // An icon is decoration with no accessible text of its own. Its LABEL, where\n  // one exists, belongs to the control around it and is emitted there.\n  'icon',\n])\n\n/**\n * Whether a node is navigation rather than content: a chrome component, or\n * an element its author declared `nav`, `header` or `footer`. Exported so a\n * reader of a page's CONTENT — the SEO audit's heading and image scan\n * (AGL-2910) — skips exactly what this serializer skips.\n */\nexport function isPageChromeNode(node: PageMarkdownNode | undefined): boolean {\n  if (!node) return false\n  if (CHROME_COMPONENTS.has(String(node.componentId ?? ''))) return true\n  const element = elementOf(node)\n  return element === 'nav' || element === 'header' || element === 'footer'\n}\n\n/** Heading levels, as either `props.component` or `props.variant` spells them. */\nconst HEADING = /^h([1-6])$/\n\n/**\n * The heading level a text node publishes, or 0 for body copy.\n *\n * `component` wins over `variant` because they answer different questions and\n * the platform lets them disagree: `variant` is the type STYLE (what size it is\n * drawn at) and `component` is the ELEMENT (what it means). An author who set a\n * hero line to look like an h1 but render as a `p` said it is not a heading,\n * and the Markdown has to agree with the HTML or the two documents describe\n * different pages.\n */\nexport function headingLevelOf(props: Record<string, unknown> | null | undefined): number {\n  const element = String(props?.['component'] ?? '').toLowerCase()\n  if (element) {\n    const asElement = HEADING.exec(element)\n    return asElement ? Number(asElement[1]) : 0\n  }\n  const variant = String(props?.['variant'] ?? '').toLowerCase()\n  const asVariant = HEADING.exec(variant)\n  return asVariant ? Number(asVariant[1]) : 0\n}\n\n/**\n * Escape the Markdown control characters that would otherwise re-parse.\n *\n * Only the characters that START a construct at the position they can occur in:\n * a leading `#`, `>`, `-`, `+` or `1.` on its own line, and the emphasis,\n * backtick and bracket characters anywhere. Escaping more than that produces\n * output littered with backslashes, which is worse to read and worse to embed\n * than the rare false heading it prevents.\n */\nexport function escapeMarkdownText(value: string): string {\n  return value\n    .replace(/([\\\\`*_[\\]<>])/g, '\\\\$1')\n    .replace(/^(\\s*)([#>])/gm, '$1\\\\$2')\n    .replace(/^(\\s*)([-+])(\\s)/gm, '$1\\\\$2$3')\n    .replace(/^(\\s*)(\\d+)\\.(\\s)/gm, '$1$2\\\\.$3')\n}\n\n/** Collapse runs of whitespace to single spaces, as inline text renders. */\nconst collapse = (value: string): string => value.replace(/\\s+/g, ' ').trim()\n\n/** Resolution context for values that are stored as references, not URLs. */\nexport interface PageMarkdownContext {\n  /** Site origin, for absolutizing media and site-relative links. */\n  origin?: string | null\n  /** Host id, so a restricted org asset resolves for the site rendering it. */\n  hostId?: string\n  /**\n   * The routing map screen links resolve against (`screenRoutes`), and the\n   * link references in authored markdown with them (AGL-3118).\n   */\n  screenRoutes?: Record<string, string> | null\n}\n\n/**\n * A link target as Markdown should carry it: absolute where we can make it so.\n *\n * Site-relative is fine in a page — the browser has a document to resolve\n * against. A Markdown body has no such context by the time an agent has copied\n * it into a prompt, so a relative href there is a link to nowhere.\n */\nfunction absoluteHref(href: string, context?: PageMarkdownContext): string {\n  const value = href.trim()\n  if (!value) return ''\n  if (/^[a-z][a-z0-9+.-]*:/i.test(value) || value.startsWith('//')) return value\n  const origin = context?.origin?.replace(/\\/+$/, '') ?? ''\n  if (!origin) return value\n  return value.startsWith('/') ? `${origin}${value}` : `${origin}/${value}`\n}\n\n/** The text a control shows, preferring its rich label over the plain one. */\nfunction labelOf(\n  props: Record<string, unknown> | null | undefined,\n  context?: PageMarkdownContext,\n): string {\n  const html = props?.['html']\n  if (typeof html === 'string' && html.trim()) {\n    const rich = inlineAuthorHtmlToMarkdown(html, context)\n    if (rich.trim()) return collapse(rich)\n  }\n  const children = props?.['children']\n  return typeof children === 'string' ? collapse(escapeMarkdownText(children)) : ''\n}\n\n/** A block emitted by the walk, before the blocks are joined. */\ninterface Block {\n  /** Markdown text of the block, already escaped. */\n  text: string\n}\n\n/**\n * Serialize the subtree at `rootId` into Markdown blocks.\n *\n * A depth budget and a visited set, because a node map is data: a document\n * restored from a backup, or written through the REST API, can name a child\n * that names it back. Recursing that tree is a stack overflow inside a request\n * handler, i.e. a 500 on a page that renders fine — the renderer tolerates it\n * because React unmounts a cycle, and this has nothing to stop it but itself.\n */\nfunction walk(\n  nodes: PageMarkdownNodes,\n  rootId: string,\n  context: PageMarkdownContext | undefined,\n  blocks: Block[],\n  seen: Set<string>,\n  depth: number,\n): void {\n  if (depth > 64 || seen.has(rootId)) return\n  const node = nodes[rootId]\n  if (!node) return\n  seen.add(rootId)\n\n  const componentId = String(node.componentId ?? '')\n  // Chrome components, and `nav`, `header` and `footer` by their OWN\n  // declaration — an author who set the element picker to one of them named\n  // it navigation, and that is a stronger signal than any component-id list\n  // can be.\n  if (isPageChromeNode(node)) return\n\n  const props = node.props ?? {}\n  const childIds = Array.isArray(node.nodes)\n    ? node.nodes.filter((id): id is string => typeof id === 'string')\n    : []\n  const recurse = (): void => {\n    for (const childId of childIds) {\n      walk(nodes, childId, context, blocks, seen, depth + 1)\n    }\n  }\n  const push = (text: string): void => {\n    if (text.trim()) blocks.push({ text: text.trim() })\n  }\n\n  switch (componentId) {\n    case 'muiTypography':\n    case 'muiInlineText':\n    case 'muiListItemText': {\n      const level = headingLevelOf(props)\n      const text = labelOf(props, context)\n      if (!text) {\n        // A Typography with no text of its own but children beneath it is a\n        // wrapper, which is how rich composites are built. Recurse rather than\n        // dropping the subtree.\n        recurse()\n        return\n      }\n      push(level > 0 ? `${'#'.repeat(level)} ${text}` : text)\n      return\n    }\n    case 'markdown': {\n      /*\n        Already Markdown. Emitted VERBATIM and never re-escaped: `content` is\n        the markdown-lite source an author typed, so escaping it would turn\n        their headings into literal `#` characters — the one transformation\n        that can only make this output worse. Its link REFERENCES are the one\n        exception (AGL-3118), resolved as the page resolves them.\n      */\n      const content = props['content']\n      if (typeof content === 'string') push(authoredMarkdown(content, context))\n      return\n    }\n    case 'custom-html': {\n      const html = props['html'] ?? props['children']\n      if (typeof html === 'string') push(authorHtmlToMarkdown(html, context))\n      return\n    }\n    case 'image': {\n      const src = absoluteMediaSrc(String(props['src'] ?? '').trim(), {\n        hostId: context?.hostId,\n        origin: context?.origin,\n      })\n      if (!src) return\n      const alt = collapse(String(props['alt'] ?? ''))\n      push(`![${escapeMarkdownText(alt)}](${src})`)\n      return\n    }\n    case 'video':\n    case 'videoEmbed': {\n      const src = String(props['src'] ?? props['url'] ?? '').trim()\n      if (!src) return\n      push(`[Video](${absoluteHref(src, context)})`)\n      return\n    }\n    case 'muiButton':\n    case 'muiScreenLink': {\n      const label = labelOf(props, context) || 'Link'\n      const href = screenLinkHref(props, context)\n      push(href ? `[${label}](${href})` : label)\n      return\n    }\n    case 'muiList': {\n      /*\n        The items are gathered into ONE block so they join as a list. Walking\n        them as siblings would put a blank line between every bullet, which is\n        a sequence of paragraphs beginning with a dash rather than a list.\n      */\n      const items: Block[] = []\n      for (const childId of childIds) {\n        walk(nodes, childId, context, items, seen, depth + 1)\n      }\n      const lines = items\n        .map((item) => item.text.replace(/\\n/g, '\\n  '))\n        .filter(Boolean)\n        .map((text) => `- ${text}`)\n      push(lines.join('\\n'))\n      return\n    }\n    default:\n      recurse()\n  }\n}\n\n/**\n * Where a Button or Screen Link points.\n *\n * A screen link stores a SCREEN ID, not a path, and the path it resolves to is\n * a per-request question — `screenRoutes` is the routing map the router\n * actually honors, which is not the map publishing wrote (a collection's list\n * template answers at the collection's slug, template screens answer nowhere).\n * Emitting `href` alone would publish, in Markdown, the dead links AGL-1998\n * removed from the HTML.\n *\n * `splitLinkValue` + `resolveScreenHref` rather than a local reading of the\n * two props, because WHICH SLOT a screen reference arrives in is not fixed\n * (AGL-1335): a `Link`-typed component prop is bound to whichever of\n * `screenId`/`href` the author reached for, and a value in the `href` slot\n * carries the stored `screen:<id>` spelling. Reading `screenId` alone published\n * that token verbatim as a link target on every page built from a prop-fed\n * CTA — ten of them on aglyn.com, unfollowable by the agents `/llms.txt` sends\n * here (AGL-2740). These are the same two functions `useLinkTarget` resolves\n * the HTML with, so the two representations of a page cannot drift again.\n *\n * An authored screen id that the map has lost resolves to NO link, exactly as\n * the HTML renders it: falling back to the stored `href` there would re-publish\n * the dead path AGL-1998 removed, which is the failure this function's own\n * contract exists to prevent.\n */\nfunction screenLinkHref(\n  props: Record<string, unknown>,\n  context?: PageMarkdownContext,\n): string {\n  const target = splitLinkValue(\n    typeof props['screenId'] === 'string' ? props['screenId'] : undefined,\n    typeof props['href'] === 'string' ? props['href'] : undefined,\n  )\n  if (target.screenId) {\n    const path = resolveScreenHref(context?.screenRoutes ?? undefined, target.screenId)\n    return path ? absoluteHref(path, context) : ''\n  }\n  // The same protocol guard the linking elements apply. A `javascript:` href\n  // is inert in a Markdown body, but it is still a target an agent may be\n  // asked to follow, and a representation that offers one the page refuses to\n  // render is describing a different document.\n  return target.href && SAFE_HREF_PATTERN.test(target.href)\n    ? absoluteHref(target.href, context)\n    : ''\n}\n\n/**\n * Authored markdown-lite — a Markdown element's content, an entry's body —\n * as this document carries it: verbatim, except that each link REFERENCE\n * (AGL-3118) points where the page's own link does, through the same routing\n * map and the same `resolveScreenHref` as {@link screenLinkHref}, made\n * absolute for the reason {@link absoluteHref} gives. A reference the map\n * does not have becomes the link's text, as the page renders it: the stored\n * `entry:…` is not a URL any reader can follow.\n */\nfunction authoredMarkdown(\n  source: string,\n  context?: PageMarkdownContext,\n): string {\n  return resolveMarkdownSourceLinks(source, (reference) => {\n    const path = resolveScreenHref(context?.screenRoutes ?? undefined, reference)\n    return path ? absoluteHref(path, context) : undefined\n  })\n}\n\n/**\n * The node the document's content begins at.\n *\n * The `main` landmark first — `stampDocumentLandmark` puts it on the layout\n * slot or the screen root — then the layout slot by component id, then the\n * document root. Each fallback is wider than the last, so a tree that is\n * missing the marker still serializes rather than returning nothing.\n */\nexport function pageContentRootId(\n  nodes: PageMarkdownNodes | null | undefined,\n  rootId: string = NODE_ROOT_ID,\n): string | null {\n  if (!nodes) return null\n  for (const id in nodes) {\n    if (elementOf(nodes[id]) === 'main') return id\n  }\n  for (const id in nodes) {\n    if (nodes[id]?.componentId === 'layoutSlot') return id\n  }\n  return nodes[rootId] ? rootId : null\n}\n\n/** What a Markdown page carries above its body. */\nexport interface PageMarkdownFrontMatter {\n  /** The `# ` heading. The page's own title, never the site's. */\n  title?: string\n  /** The meta description, emitted as the summary blockquote. */\n  description?: string\n  /** Canonical absolute URL, emitted as the source line. */\n  canonicalUrl?: string\n  /** ISO-8601 publication date, for a content entry. */\n  publishedAt?: string\n  /** ISO-8601 last-modified date, for a content entry. */\n  updatedAt?: string\n  /** Byline, for a content entry. */\n  author?: string\n}\n\n/**\n * The whole Markdown representation of a page.\n *\n * @param body - already-Markdown body to use INSTEAD of walking nodes; the\n *   content-entry case, where the stored body is markdown-lite source and\n *   round-tripping it through the node tree could only lose fidelity.\n */\nexport function buildPageMarkdown(options: {\n  nodes?: PageMarkdownNodes | null\n  rootId?: string\n  body?: string | null\n  front?: PageMarkdownFrontMatter\n  context?: PageMarkdownContext\n}): string {\n  const front = options.front ?? {}\n  const parts: string[] = []\n\n  const title = collapse(String(front.title ?? ''))\n  if (title) parts.push(`# ${escapeMarkdownText(title)}`)\n\n  const description = collapse(String(front.description ?? ''))\n  if (description) parts.push(`> ${escapeMarkdownText(description)}`)\n\n  /*\n    The dateline is one line rather than YAML front matter. Front matter is\n    unparsed text to every Markdown reader that has not opted into it, so it\n    arrives in an agent's context as a block of `key: value` noise above the\n    content; a sentence is read correctly by all of them.\n  */\n  const meta: string[] = []\n  if (front.author) meta.push(`By ${collapse(front.author)}`)\n  if (front.publishedAt) meta.push(`Published ${front.publishedAt}`)\n  if (front.updatedAt && front.updatedAt !== front.publishedAt) {\n    meta.push(`Updated ${front.updatedAt}`)\n  }\n  if (meta.length) parts.push(`_${meta.join(' · ')}_`)\n\n  if (typeof options.body === 'string' && options.body.trim()) {\n    parts.push(authoredMarkdown(options.body.trim(), options.context))\n  } else if (options.nodes) {\n    const contentRoot = pageContentRootId(options.nodes, options.rootId)\n    if (contentRoot) {\n      const blocks: Block[] = []\n      walk(options.nodes, contentRoot, options.context, blocks, new Set(), 0)\n      for (const block of blocks) parts.push(block.text)\n    }\n  }\n\n  if (front.canonicalUrl) {\n    // A source line, and the reason it is worth the two lines it costs: an\n    // agent that has copied this body into a prompt has no URL bar, so without\n    // it the document cannot be cited, re-fetched, or linked to by whatever\n    // reads it next.\n    parts.push('---', `Source: ${front.canonicalUrl}`)\n  }\n\n  /*\n    Collapse the runs of blank lines a nested walk leaves behind, and end with\n    exactly one newline. A Markdown body is compared byte-for-byte by caches\n    and by the conformance checkers agents run, so \"tidy\" here is a contract\n    rather than an aesthetic.\n  */\n  return `${parts.join('\\n\\n').replace(/\\n{3,}/g, '\\n\\n').trim()}\\n`\n}\n"],"names":["NODE_ROOT_ID","authorHtmlToMarkdown","inlineAuthorHtmlToMarkdown","resolveMarkdownSourceLinks","absoluteMediaSrc","SAFE_HREF_PATTERN","resolveScreenHref","splitLinkValue","elementOf","node","String","props","toLowerCase","CHROME_COMPONENTS","Set","isPageChromeNode","has","componentId","element","HEADING","headingLevelOf","asElement","exec","Number","variant","asVariant","escapeMarkdownText","value","replace","collapse","trim","absoluteHref","href","context","test","startsWith","origin","labelOf","html","rich","children","walk","nodes","rootId","blocks","seen","depth","add","childIds","Array","isArray","filter","id","recurse","childId","push","text","level","repeat","content","authoredMarkdown","src","hostId","alt","label","screenLinkHref","items","lines","map","item","Boolean","join","target","undefined","screenId","path","screenRoutes","source","reference","pageContentRootId","buildPageMarkdown","options","front","parts","title","description","meta","author","publishedAt","updatedAt","length","body","contentRoot","block","canonicalUrl"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCC,GAED,SAASA,YAAY,QAAQ,sCAAkC;AAC/D,SAASC,oBAAoB,EAAEC,0BAA0B,QAAQ,4BAAwB;AACzF,SAASC,0BAA0B,QAAQ,qBAAiB;AAC5D,SAASC,gBAAgB,QAAQ,iBAAa;AAC9C,SACEC,iBAAiB,EACjBC,iBAAiB,EACjBC,cAAc,QACT,yBAAqB;AAa5B,uEAAuE,GACvE,MAAMC,YAAY,CAACC;;QACVA;WAAPC,eAAOD,yBAAAA,cAAAA,KAAME,KAAK,qBAAXF,WAAa,CAAC,YAAY,mBAAI,IAAIG,WAAW;;AAEtD,8EAA8E,GAC9E,MAAMC,oBAAyC,IAAIC,IAAI;IACrD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,6EAA6E;IAC7E,qEAAqE;IACrE;CACD;AAED;;;;;CAKC,GACD,OAAO,SAASC,iBAAiBN,IAAkC;QAEhCA;IADjC,IAAI,CAACA,MAAM,OAAO;IAClB,IAAII,kBAAkBG,GAAG,CAACN,QAAOD,oBAAAA,KAAKQ,WAAW,YAAhBR,oBAAoB,MAAM,OAAO;IAClE,MAAMS,UAAUV,UAAUC;IAC1B,OAAOS,YAAY,SAASA,YAAY,YAAYA,YAAY;AAClE;AAEA,gFAAgF,GAChF,MAAMC,UAAU;AAEhB;;;;;;;;;CASC,GACD,OAAO,SAASC,eAAeT,KAAiD;;IAC9E,MAAMO,UAAUR,eAAOC,yBAAAA,KAAO,CAAC,YAAY,mBAAI,IAAIC,WAAW;IAC9D,IAAIM,SAAS;QACX,MAAMG,YAAYF,QAAQG,IAAI,CAACJ;QAC/B,OAAOG,YAAYE,OAAOF,SAAS,CAAC,EAAE,IAAI;IAC5C;IACA,MAAMG,UAAUd,gBAAOC,yBAAAA,KAAO,CAAC,UAAU,oBAAI,IAAIC,WAAW;IAC5D,MAAMa,YAAYN,QAAQG,IAAI,CAACE;IAC/B,OAAOC,YAAYF,OAAOE,SAAS,CAAC,EAAE,IAAI;AAC5C;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASC,mBAAmBC,KAAa;IAC9C,OAAOA,MACJC,OAAO,CAAC,mBAAmB,QAC3BA,OAAO,CAAC,kBAAkB,UAC1BA,OAAO,CAAC,sBAAsB,YAC9BA,OAAO,CAAC,uBAAuB;AACpC;AAEA,0EAA0E,GAC1E,MAAMC,WAAW,CAACF,QAA0BA,MAAMC,OAAO,CAAC,QAAQ,KAAKE,IAAI;AAe3E;;;;;;CAMC,GACD,SAASC,aAAaC,IAAY,EAAEC,OAA6B;;QAIhDA;IAHf,MAAMN,QAAQK,KAAKF,IAAI;IACvB,IAAI,CAACH,OAAO,OAAO;IACnB,IAAI,uBAAuBO,IAAI,CAACP,UAAUA,MAAMQ,UAAU,CAAC,OAAO,OAAOR;IACzE,MAAMS,iBAASH,4BAAAA,kBAAAA,QAASG,MAAM,qBAAfH,gBAAiBL,OAAO,CAAC,QAAQ,sBAAO;IACvD,IAAI,CAACQ,QAAQ,OAAOT;IACpB,OAAOA,MAAMQ,UAAU,CAAC,OAAO,GAAGC,SAAST,OAAO,GAAG,GAAGS,OAAO,CAAC,EAAET,OAAO;AAC3E;AAEA,4EAA4E,GAC5E,SAASU,QACP1B,KAAiD,EACjDsB,OAA6B;IAE7B,MAAMK,OAAO3B,yBAAAA,KAAO,CAAC,OAAO;IAC5B,IAAI,OAAO2B,SAAS,YAAYA,KAAKR,IAAI,IAAI;QAC3C,MAAMS,OAAOrC,2BAA2BoC,MAAML;QAC9C,IAAIM,KAAKT,IAAI,IAAI,OAAOD,SAASU;IACnC;IACA,MAAMC,WAAW7B,yBAAAA,KAAO,CAAC,WAAW;IACpC,OAAO,OAAO6B,aAAa,WAAWX,SAASH,mBAAmBc,aAAa;AACjF;AAQA;;;;;;;;CAQC,GACD,SAASC,KACPC,KAAwB,EACxBC,MAAc,EACdV,OAAwC,EACxCW,MAAe,EACfC,IAAiB,EACjBC,KAAa;QAOcrC,mBAObA;IAZd,IAAIqC,QAAQ,MAAMD,KAAK7B,GAAG,CAAC2B,SAAS;IACpC,MAAMlC,OAAOiC,KAAK,CAACC,OAAO;IAC1B,IAAI,CAAClC,MAAM;IACXoC,KAAKE,GAAG,CAACJ;IAET,MAAM1B,cAAcP,QAAOD,oBAAAA,KAAKQ,WAAW,YAAhBR,oBAAoB;IAC/C,mEAAmE;IACnE,0EAA0E;IAC1E,0EAA0E;IAC1E,UAAU;IACV,IAAIM,iBAAiBN,OAAO;IAE5B,MAAME,SAAQF,cAAAA,KAAKE,KAAK,YAAVF,cAAc,CAAC;IAC7B,MAAMuC,WAAWC,MAAMC,OAAO,CAACzC,KAAKiC,KAAK,IACrCjC,KAAKiC,KAAK,CAACS,MAAM,CAAC,CAACC,KAAqB,OAAOA,OAAO,YACtD,EAAE;IACN,MAAMC,UAAU;QACd,KAAK,MAAMC,WAAWN,SAAU;YAC9BP,KAAKC,OAAOY,SAASrB,SAASW,QAAQC,MAAMC,QAAQ;QACtD;IACF;IACA,MAAMS,OAAO,CAACC;QACZ,IAAIA,KAAK1B,IAAI,IAAIc,OAAOW,IAAI,CAAC;YAAEC,MAAMA,KAAK1B,IAAI;QAAG;IACnD;IAEA,OAAQb;QACN,KAAK;QACL,KAAK;QACL,KAAK;YAAmB;gBACtB,MAAMwC,QAAQrC,eAAeT;gBAC7B,MAAM6C,OAAOnB,QAAQ1B,OAAOsB;gBAC5B,IAAI,CAACuB,MAAM;oBACT,oEAAoE;oBACpE,uEAAuE;oBACvE,wBAAwB;oBACxBH;oBACA;gBACF;gBACAE,KAAKE,QAAQ,IAAI,GAAG,IAAIC,MAAM,CAACD,OAAO,CAAC,EAAED,MAAM,GAAGA;gBAClD;YACF;QACA,KAAK;YAAY;gBACf;;;;;;MAMA,GACA,MAAMG,UAAUhD,KAAK,CAAC,UAAU;gBAChC,IAAI,OAAOgD,YAAY,UAAUJ,KAAKK,iBAAiBD,SAAS1B;gBAChE;YACF;QACA,KAAK;YAAe;oBACLtB;gBAAb,MAAM2B,QAAO3B,cAAAA,KAAK,CAAC,OAAO,YAAbA,cAAiBA,KAAK,CAAC,WAAW;gBAC/C,IAAI,OAAO2B,SAAS,UAAUiB,KAAKtD,qBAAqBqC,MAAML;gBAC9D;YACF;QACA,KAAK;YAAS;oBACwBtB,YAKRA;gBAL5B,MAAMkD,MAAMzD,iBAAiBM,QAAOC,aAAAA,KAAK,CAAC,MAAM,YAAZA,aAAgB,IAAImB,IAAI,IAAI;oBAC9DgC,MAAM,EAAE7B,2BAAAA,QAAS6B,MAAM;oBACvB1B,MAAM,EAAEH,2BAAAA,QAASG,MAAM;gBACzB;gBACA,IAAI,CAACyB,KAAK;gBACV,MAAME,MAAMlC,SAASnB,QAAOC,aAAAA,KAAK,CAAC,MAAM,YAAZA,aAAgB;gBAC5C4C,KAAK,CAAC,EAAE,EAAE7B,mBAAmBqC,KAAK,EAAE,EAAEF,IAAI,CAAC,CAAC;gBAC5C;YACF;QACA,KAAK;QACL,KAAK;YAAc;oBACElD,MAAAA;gBAAnB,MAAMkD,MAAMnD,QAAOC,QAAAA,cAAAA,KAAK,CAAC,MAAM,YAAZA,cAAgBA,KAAK,CAAC,MAAM,YAA5BA,OAAgC,IAAImB,IAAI;gBAC3D,IAAI,CAAC+B,KAAK;gBACVN,KAAK,CAAC,QAAQ,EAAExB,aAAa8B,KAAK5B,SAAS,CAAC,CAAC;gBAC7C;YACF;QACA,KAAK;QACL,KAAK;YAAiB;gBACpB,MAAM+B,QAAQ3B,QAAQ1B,OAAOsB,YAAY;gBACzC,MAAMD,OAAOiC,eAAetD,OAAOsB;gBACnCsB,KAAKvB,OAAO,CAAC,CAAC,EAAEgC,MAAM,EAAE,EAAEhC,KAAK,CAAC,CAAC,GAAGgC;gBACpC;YACF;QACA,KAAK;YAAW;gBACd;;;;MAIA,GACA,MAAME,QAAiB,EAAE;gBACzB,KAAK,MAAMZ,WAAWN,SAAU;oBAC9BP,KAAKC,OAAOY,SAASrB,SAASiC,OAAOrB,MAAMC,QAAQ;gBACrD;gBACA,MAAMqB,QAAQD,MACXE,GAAG,CAAC,CAACC,OAASA,KAAKb,IAAI,CAAC5B,OAAO,CAAC,OAAO,SACvCuB,MAAM,CAACmB,SACPF,GAAG,CAAC,CAACZ,OAAS,CAAC,EAAE,EAAEA,MAAM;gBAC5BD,KAAKY,MAAMI,IAAI,CAAC;gBAChB;YACF;QACA;YACElB;IACJ;AACF;AAEA;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,SAASY,eACPtD,KAA8B,EAC9BsB,OAA6B;IAE7B,MAAMuC,SAASjE,eACb,OAAOI,KAAK,CAAC,WAAW,KAAK,WAAWA,KAAK,CAAC,WAAW,GAAG8D,WAC5D,OAAO9D,KAAK,CAAC,OAAO,KAAK,WAAWA,KAAK,CAAC,OAAO,GAAG8D;IAEtD,IAAID,OAAOE,QAAQ,EAAE;;QACnB,MAAMC,OAAOrE,0BAAkB2B,2BAAAA,QAAS2C,YAAY,mBAAIH,WAAWD,OAAOE,QAAQ;QAClF,OAAOC,OAAO5C,aAAa4C,MAAM1C,WAAW;IAC9C;IACA,2EAA2E;IAC3E,wEAAwE;IACxE,4EAA4E;IAC5E,6CAA6C;IAC7C,OAAOuC,OAAOxC,IAAI,IAAI3B,kBAAkB6B,IAAI,CAACsC,OAAOxC,IAAI,IACpDD,aAAayC,OAAOxC,IAAI,EAAEC,WAC1B;AACN;AAEA;;;;;;;;CAQC,GACD,SAAS2B,iBACPiB,MAAc,EACd5C,OAA6B;IAE7B,OAAO9B,2BAA2B0E,QAAQ,CAACC;;QACzC,MAAMH,OAAOrE,0BAAkB2B,2BAAAA,QAAS2C,YAAY,mBAAIH,WAAWK;QACnE,OAAOH,OAAO5C,aAAa4C,MAAM1C,WAAWwC;IAC9C;AACF;AAEA;;;;;;;CAOC,GACD,OAAO,SAASM,kBACdrC,KAA2C,EAC3CC,SAAiB3C,YAAY;IAE7B,IAAI,CAAC0C,OAAO,OAAO;IACnB,IAAK,MAAMU,MAAMV,MAAO;QACtB,IAAIlC,UAAUkC,KAAK,CAACU,GAAG,MAAM,QAAQ,OAAOA;IAC9C;IACA,IAAK,MAAMA,MAAMV,MAAO;YAClBA;QAAJ,IAAIA,EAAAA,YAAAA,KAAK,CAACU,GAAG,qBAATV,UAAWzB,WAAW,MAAK,cAAc,OAAOmC;IACtD;IACA,OAAOV,KAAK,CAACC,OAAO,GAAGA,SAAS;AAClC;AAkBA;;;;;;CAMC,GACD,OAAO,SAASqC,kBAAkBC,OAMjC;QACeA,gBAGgBC,cAGMA;IANpC,MAAMA,SAAQD,iBAAAA,QAAQC,KAAK,YAAbD,iBAAiB,CAAC;IAChC,MAAME,QAAkB,EAAE;IAE1B,MAAMC,QAAQvD,SAASnB,QAAOwE,eAAAA,MAAME,KAAK,YAAXF,eAAe;IAC7C,IAAIE,OAAOD,MAAM5B,IAAI,CAAC,CAAC,EAAE,EAAE7B,mBAAmB0D,QAAQ;IAEtD,MAAMC,cAAcxD,SAASnB,QAAOwE,qBAAAA,MAAMG,WAAW,YAAjBH,qBAAqB;IACzD,IAAIG,aAAaF,MAAM5B,IAAI,CAAC,CAAC,EAAE,EAAE7B,mBAAmB2D,cAAc;IAElE;;;;;EAKA,GACA,MAAMC,OAAiB,EAAE;IACzB,IAAIJ,MAAMK,MAAM,EAAED,KAAK/B,IAAI,CAAC,CAAC,GAAG,EAAE1B,SAASqD,MAAMK,MAAM,GAAG;IAC1D,IAAIL,MAAMM,WAAW,EAAEF,KAAK/B,IAAI,CAAC,CAAC,UAAU,EAAE2B,MAAMM,WAAW,EAAE;IACjE,IAAIN,MAAMO,SAAS,IAAIP,MAAMO,SAAS,KAAKP,MAAMM,WAAW,EAAE;QAC5DF,KAAK/B,IAAI,CAAC,CAAC,QAAQ,EAAE2B,MAAMO,SAAS,EAAE;IACxC;IACA,IAAIH,KAAKI,MAAM,EAAEP,MAAM5B,IAAI,CAAC,CAAC,CAAC,EAAE+B,KAAKf,IAAI,CAAC,OAAO,CAAC,CAAC;IAEnD,IAAI,OAAOU,QAAQU,IAAI,KAAK,YAAYV,QAAQU,IAAI,CAAC7D,IAAI,IAAI;QAC3DqD,MAAM5B,IAAI,CAACK,iBAAiBqB,QAAQU,IAAI,CAAC7D,IAAI,IAAImD,QAAQhD,OAAO;IAClE,OAAO,IAAIgD,QAAQvC,KAAK,EAAE;QACxB,MAAMkD,cAAcb,kBAAkBE,QAAQvC,KAAK,EAAEuC,QAAQtC,MAAM;QACnE,IAAIiD,aAAa;YACf,MAAMhD,SAAkB,EAAE;YAC1BH,KAAKwC,QAAQvC,KAAK,EAAEkD,aAAaX,QAAQhD,OAAO,EAAEW,QAAQ,IAAI9B,OAAO;YACrE,KAAK,MAAM+E,SAASjD,OAAQuC,MAAM5B,IAAI,CAACsC,MAAMrC,IAAI;QACnD;IACF;IAEA,IAAI0B,MAAMY,YAAY,EAAE;QACtB,uEAAuE;QACvE,2EAA2E;QAC3E,wEAAwE;QACxE,iBAAiB;QACjBX,MAAM5B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE2B,MAAMY,YAAY,EAAE;IACnD;IAEA;;;;;EAKA,GACA,OAAO,GAAGX,MAAMZ,IAAI,CAAC,QAAQ3C,OAAO,CAAC,WAAW,QAAQE,IAAI,GAAG,EAAE,CAAC;AACpE"}

package/src/lib/app-utils/paid-media-source.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @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.
+ */
+/**
+ * What a URL stored on a product's paid media names (AGL-2814).
+ *
+ * A members video is stored as whatever wrote it: the paid-media picker's
+ * reference, an older picker's CDN path, the raw Storage download URL a
+ * free-tier library hands out, or a hotlink typed into an import. Three
+ * places have to agree on which ASSET that is: the stream route that signs
+ * it, the console that shows the author whether it is protected, and the
+ * media route that refuses to publish a file a product still sells. One
+ * grammar, here, so they cannot disagree.
+ *
+ * Pure and environment-light: nothing here reads Firestore, Storage or a
+ * secret, so the console bundle can carry it.
+ */
+export type PaidMediaSource = 
+/** A media-library asset, named by scope segment and id. */
+{
+    kind: 'asset';
+    scope: string;
+    mediaId: string;
+}
+/** An object in a Storage bucket, from a download or GCS URL. */
+ | {
+    kind: 'storage-object';
+    bucket: string;
+    objectPath: string;
+}
+/** Somebody else's server. */
+ | {
+    kind: 'external';
+    url: string;
+}
+/** Nothing that can be delivered, including a Storage URL we cannot read. */
+ | {
+    kind: 'malformed';
+};
+/**
+ * Classifies a stored value. The same input always gives the same answer, so
+ * every branch is checkable without a project.
+ */
+export declare function parsePaidMediaSource(stored: unknown): PaidMediaSource;
+/**
+ * The library asset a media object key belongs to, or null.
+ *
+ * Every writer keys an asset's object as `{base}/media/[folders/]{mediaId}`,
+ * with `base` either `hosts/{hostId}` or `orgs/{orgId}`. So a key in that
+ * shape whose last segment is id-shaped IS that asset, wherever a folder move
+ * has since put it. Derived objects (`…__r720p.mp4`, `…__poster.webp`) carry
+ * a dot and are no asset's key.
+ *
+ * This names the asset and decides nothing about access: a caller that signs
+ * still has to check the bucket and that the library is its own.
+ */
+export declare function paidMediaAssetOfObject(objectPath: string): {
+    scope: string;
+    mediaId: string;
+} | null;
+/**
+ * The library asset a stored paid-media URL names, in whichever form it was
+ * written, or null for a hotlink, a malformed value, or a Storage URL that
+ * names no asset. Pass `bucket` to refuse a download URL from any other
+ * bucket, which is what every server-side caller should do.
+ */
+export declare function paidMediaAssetOf(stored: unknown, options?: {
+    bucket?: string;
+}): {
+    scope: string;
+    mediaId: string;
+} | null;
+/**
+ * Whether two scope segments name the same library: the same host, or the
+ * same org whatever site either is qualified with.
+ */
+export declare function samePaidMediaLibrary(a: string, b: string): boolean;