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

package/src/lib/app-utils/seo-keywords.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/seo-keywords.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 * Target keywords: the words a site owner wants a page found for, and where\n * the page already says them.\n *\n * The SEO check (`seo-audit.ts`) reports a keyword a page never says, and\n * anything that writes a listing holds its answer to the same count, so\n * \"the page says it\" means one thing everywhere: the keyword as whole words,\n * in any case, never inside a longer word.\n */\n\n/** Target keywords one page may name. */\nexport const SEO_MAX_KEYWORDS = 5\n\n/** The longest target keyword text a site's lines run to: a line a page, for a large site. */\nexport const SEO_KEYWORD_LINES_MAX_CHARS = 3_000\n\n/** The longest one keyword is kept. */\nconst SEO_KEYWORD_MAX_CHARS = 60\n\n/** Whether, and where, a page already says a target keyword. */\nexport interface SeoKeywordCoverage {\n  keyword: string\n  inTitle: boolean\n  inDescription: boolean\n  inH1: boolean\n  inBody: boolean\n}\n\nconst escapeRegExp = (value: string): string => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/** How many times `keyword` appears in `text` as whole words, any case. */\nexport function seoKeywordCount(text: string | null | undefined, keyword: string): number {\n  const needle = keyword.trim().toLowerCase()\n  if (!needle || !text) return 0\n  const pattern = new RegExp(\n    `(^|[^\\\\p{L}\\\\p{N}])${escapeRegExp(needle).replace(/\\s+/g, '\\\\s+')}(?=$|[^\\\\p{L}\\\\p{N}])`,\n    'giu',\n  )\n  return [...text.toLowerCase().matchAll(pattern)].length\n}\n\n/** Keywords as a person typed them: trimmed, deduplicated, capped at {@link SEO_MAX_KEYWORDS}. */\nexport function seoKeywordList(raw: unknown): string[] {\n  const parts = Array.isArray(raw) ? raw.map(String) : String(raw ?? '').split(/[,\\n]/)\n  const seen = new Set<string>()\n  const out: string[] = []\n  for (const part of parts) {\n    const keyword = part.replace(/\\s+/g, ' ').trim().slice(0, SEO_KEYWORD_MAX_CHARS)\n    const key = keyword.toLowerCase()\n    if (!keyword || seen.has(key)) continue\n    seen.add(key)\n    out.push(keyword)\n    if (out.length >= SEO_MAX_KEYWORDS) break\n  }\n  return out\n}\n\n/** Where a page already says each target keyword. */\nexport function seoKeywordCoverage(\n  keywords: readonly string[],\n  sources: { title?: string | null; description?: string | null; h1?: string | null; body?: string | null },\n): SeoKeywordCoverage[] {\n  return keywords.map((keyword) => ({\n    keyword,\n    inTitle: seoKeywordCount(sources.title, keyword) > 0,\n    inDescription: seoKeywordCount(sources.description, keyword) > 0,\n    inH1: seoKeywordCount(sources.h1, keyword) > 0,\n    inBody: seoKeywordCount(sources.body, keyword) > 0,\n  }))\n}\n"],"names":["SEO_MAX_KEYWORDS","SEO_KEYWORD_LINES_MAX_CHARS","SEO_KEYWORD_MAX_CHARS","escapeRegExp","value","replace","seoKeywordCount","text","keyword","needle","trim","toLowerCase","pattern","RegExp","matchAll","length","seoKeywordList","raw","parts","Array","isArray","map","String","split","seen","Set","out","part","slice","key","has","add","push","seoKeywordCoverage","keywords","sources","inTitle","title","inDescription","description","inH1","h1","inBody","body"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;CAQC,GAED,uCAAuC,GACvC,OAAO,MAAMA,mBAAmB,EAAC;AAEjC,4FAA4F,GAC5F,OAAO,MAAMC,8BAA8B,KAAK;AAEhD,qCAAqC,GACrC,MAAMC,wBAAwB;AAW9B,MAAMC,eAAe,CAACC,QAA0BA,MAAMC,OAAO,CAAC,uBAAuB;AAErF,yEAAyE,GACzE,OAAO,SAASC,gBAAgBC,IAA+B,EAAEC,OAAe;IAC9E,MAAMC,SAASD,QAAQE,IAAI,GAAGC,WAAW;IACzC,IAAI,CAACF,UAAU,CAACF,MAAM,OAAO;IAC7B,MAAMK,UAAU,IAAIC,OAClB,CAAC,mBAAmB,EAAEV,aAAaM,QAAQJ,OAAO,CAAC,QAAQ,QAAQ,qBAAqB,CAAC,EACzF;IAEF,OAAO;WAAIE,KAAKI,WAAW,GAAGG,QAAQ,CAACF;KAAS,CAACG,MAAM;AACzD;AAEA,gGAAgG,GAChG,OAAO,SAASC,eAAeC,GAAY;IACzC,MAAMC,QAAQC,MAAMC,OAAO,CAACH,OAAOA,IAAII,GAAG,CAACC,UAAUA,OAAOL,cAAAA,MAAO,IAAIM,KAAK,CAAC;IAC7E,MAAMC,OAAO,IAAIC;IACjB,MAAMC,MAAgB,EAAE;IACxB,KAAK,MAAMC,QAAQT,MAAO;QACxB,MAAMV,UAAUmB,KAAKtB,OAAO,CAAC,QAAQ,KAAKK,IAAI,GAAGkB,KAAK,CAAC,GAAG1B;QAC1D,MAAM2B,MAAMrB,QAAQG,WAAW;QAC/B,IAAI,CAACH,WAAWgB,KAAKM,GAAG,CAACD,MAAM;QAC/BL,KAAKO,GAAG,CAACF;QACTH,IAAIM,IAAI,CAACxB;QACT,IAAIkB,IAAIX,MAAM,IAAIf,kBAAkB;IACtC;IACA,OAAO0B;AACT;AAEA,mDAAmD,GACnD,OAAO,SAASO,mBACdC,QAA2B,EAC3BC,OAAyG;IAEzG,OAAOD,SAASb,GAAG,CAAC,CAACb,UAAa,CAAA;YAChCA;YACA4B,SAAS9B,gBAAgB6B,QAAQE,KAAK,EAAE7B,WAAW;YACnD8B,eAAehC,gBAAgB6B,QAAQI,WAAW,EAAE/B,WAAW;YAC/DgC,MAAMlC,gBAAgB6B,QAAQM,EAAE,EAAEjC,WAAW;YAC7CkC,QAAQpC,gBAAgB6B,QAAQQ,IAAI,EAAEnC,WAAW;QACnD,CAAA;AACF"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/seo-keywords.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 * Target keywords: the words a site owner wants a page found for, and where\n * the page already says them.\n *\n * The SEO check (`seo-audit.ts`) reports a keyword a page never says, and\n * anything that writes a listing holds its answer to the same count, so\n * \"the page says it\" means one thing everywhere: the keyword as whole words,\n * in any case, never inside a longer word.\n */\n\n/** Target keywords one page may name. */\nexport const SEO_MAX_KEYWORDS = 5\n\n/** The longest target keyword text a site's lines run to: a line a page, for a large site. */\nexport const SEO_KEYWORD_LINES_MAX_CHARS = 3_000\n\n/** The longest one keyword is kept. */\nconst SEO_KEYWORD_MAX_CHARS = 60\n\n/** Whether, and where, a page already says a target keyword. */\nexport interface SeoKeywordCoverage {\n  keyword: string\n  inTitle: boolean\n  inDescription: boolean\n  inH1: boolean\n  inBody: boolean\n}\n\nconst escapeRegExp = (value: string): string => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/** How many times `keyword` appears in `text` as whole words, any case. */\nexport function seoKeywordCount(text: string | null | undefined, keyword: string): number {\n  const needle = keyword.trim().toLowerCase()\n  if (!needle || !text) return 0\n  const pattern = new RegExp(\n    `(^|[^\\\\p{L}\\\\p{N}])${escapeRegExp(needle).replace(/\\s+/g, '\\\\s+')}(?=$|[^\\\\p{L}\\\\p{N}])`,\n    'giu',\n  )\n  return [...text.toLowerCase().matchAll(pattern)].length\n}\n\n/**\n * Keywords as a person typed them — trimmed, deduplicated — split at\n * {@link SEO_MAX_KEYWORDS}: the ones a page is checked for, and the distinct\n * ones past the limit, which a caller names rather than drops in silence.\n */\nexport function seoKeywordSplit(raw: unknown): { keywords: string[]; unchecked: string[] } {\n  const parts = Array.isArray(raw) ? raw.map(String) : String(raw ?? '').split(/[,\\n]/)\n  const seen = new Set<string>()\n  const keywords: string[] = []\n  const unchecked: string[] = []\n  for (const part of parts) {\n    const keyword = part.replace(/\\s+/g, ' ').trim().slice(0, SEO_KEYWORD_MAX_CHARS)\n    const key = keyword.toLowerCase()\n    if (!keyword || seen.has(key)) continue\n    seen.add(key)\n    if (keywords.length < SEO_MAX_KEYWORDS) keywords.push(keyword)\n    else unchecked.push(keyword)\n  }\n  return { keywords, unchecked }\n}\n\n/** Keywords as a person typed them: trimmed, deduplicated, capped at {@link SEO_MAX_KEYWORDS}. */\nexport function seoKeywordList(raw: unknown): string[] {\n  return seoKeywordSplit(raw).keywords\n}\n\n/** How a note names keywords: each quoted, in the order they were typed. */\nexport function seoQuotedKeywords(keywords: readonly string[]): string {\n  return keywords.map((keyword) => `“${keyword}”`).join(', ')\n}\n\n/** Where a page already says each target keyword. */\nexport function seoKeywordCoverage(\n  keywords: readonly string[],\n  sources: { title?: string | null; description?: string | null; h1?: string | null; body?: string | null },\n): SeoKeywordCoverage[] {\n  return keywords.map((keyword) => ({\n    keyword,\n    inTitle: seoKeywordCount(sources.title, keyword) > 0,\n    inDescription: seoKeywordCount(sources.description, keyword) > 0,\n    inH1: seoKeywordCount(sources.h1, keyword) > 0,\n    inBody: seoKeywordCount(sources.body, keyword) > 0,\n  }))\n}\n"],"names":["SEO_MAX_KEYWORDS","SEO_KEYWORD_LINES_MAX_CHARS","SEO_KEYWORD_MAX_CHARS","escapeRegExp","value","replace","seoKeywordCount","text","keyword","needle","trim","toLowerCase","pattern","RegExp","matchAll","length","seoKeywordSplit","raw","parts","Array","isArray","map","String","split","seen","Set","keywords","unchecked","part","slice","key","has","add","push","seoKeywordList","seoQuotedKeywords","join","seoKeywordCoverage","sources","inTitle","title","inDescription","description","inH1","h1","inBody","body"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;CAQC,GAED,uCAAuC,GACvC,OAAO,MAAMA,mBAAmB,EAAC;AAEjC,4FAA4F,GAC5F,OAAO,MAAMC,8BAA8B,KAAK;AAEhD,qCAAqC,GACrC,MAAMC,wBAAwB;AAW9B,MAAMC,eAAe,CAACC,QAA0BA,MAAMC,OAAO,CAAC,uBAAuB;AAErF,yEAAyE,GACzE,OAAO,SAASC,gBAAgBC,IAA+B,EAAEC,OAAe;IAC9E,MAAMC,SAASD,QAAQE,IAAI,GAAGC,WAAW;IACzC,IAAI,CAACF,UAAU,CAACF,MAAM,OAAO;IAC7B,MAAMK,UAAU,IAAIC,OAClB,CAAC,mBAAmB,EAAEV,aAAaM,QAAQJ,OAAO,CAAC,QAAQ,QAAQ,qBAAqB,CAAC,EACzF;IAEF,OAAO;WAAIE,KAAKI,WAAW,GAAGG,QAAQ,CAACF;KAAS,CAACG,MAAM;AACzD;AAEA;;;;CAIC,GACD,OAAO,SAASC,gBAAgBC,GAAY;IAC1C,MAAMC,QAAQC,MAAMC,OAAO,CAACH,OAAOA,IAAII,GAAG,CAACC,UAAUA,OAAOL,cAAAA,MAAO,IAAIM,KAAK,CAAC;IAC7E,MAAMC,OAAO,IAAIC;IACjB,MAAMC,WAAqB,EAAE;IAC7B,MAAMC,YAAsB,EAAE;IAC9B,KAAK,MAAMC,QAAQV,MAAO;QACxB,MAAMV,UAAUoB,KAAKvB,OAAO,CAAC,QAAQ,KAAKK,IAAI,GAAGmB,KAAK,CAAC,GAAG3B;QAC1D,MAAM4B,MAAMtB,QAAQG,WAAW;QAC/B,IAAI,CAACH,WAAWgB,KAAKO,GAAG,CAACD,MAAM;QAC/BN,KAAKQ,GAAG,CAACF;QACT,IAAIJ,SAASX,MAAM,GAAGf,kBAAkB0B,SAASO,IAAI,CAACzB;aACjDmB,UAAUM,IAAI,CAACzB;IACtB;IACA,OAAO;QAAEkB;QAAUC;IAAU;AAC/B;AAEA,gGAAgG,GAChG,OAAO,SAASO,eAAejB,GAAY;IACzC,OAAOD,gBAAgBC,KAAKS,QAAQ;AACtC;AAEA,0EAA0E,GAC1E,OAAO,SAASS,kBAAkBT,QAA2B;IAC3D,OAAOA,SAASL,GAAG,CAAC,CAACb,UAAY,CAAC,CAAC,EAAEA,QAAQ,CAAC,CAAC,EAAE4B,IAAI,CAAC;AACxD;AAEA,mDAAmD,GACnD,OAAO,SAASC,mBACdX,QAA2B,EAC3BY,OAAyG;IAEzG,OAAOZ,SAASL,GAAG,CAAC,CAACb,UAAa,CAAA;YAChCA;YACA+B,SAASjC,gBAAgBgC,QAAQE,KAAK,EAAEhC,WAAW;YACnDiC,eAAenC,gBAAgBgC,QAAQI,WAAW,EAAElC,WAAW;YAC/DmC,MAAMrC,gBAAgBgC,QAAQM,EAAE,EAAEpC,WAAW;YAC7CqC,QAAQvC,gBAAgBgC,QAAQQ,IAAI,EAAEtC,WAAW;QACnD,CAAA;AACF"}

package/src/lib/app-utils/seo-page-facts.d.ts

@@ -27,6 +27,22 @@ import { type PageMarkdownNodes } from './page-markdown';
  *
  * 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 page as it publishes (AGL-3501)
+ *
+ * Hand it the COMPOSED node map — reusable components grafted, repeats
+ * expanded (`seo-site-scan.ts` composes one) — and the page's own map as
+ * `pageNodes`. A heading a component renders is the page's heading; reading
+ * the raw map instead missed every one of them. The page's own map is what
+ * says where a fact can be fixed: an element a component renders points at
+ * the component's placement on the page and is not `editable` (a page fix
+ * cannot rewrite a component's text), and so is a copy a repeat makes, whose
+ * text is a row's.
+ *
+ * A `{{…}}` token is not copy. A token the composition did not resolve —
+ * a repeat whose rows were not read, a site variable the head resolves — is
+ * left out of the text and the headings, and a heading or a description
+ * made of one is neither judged by what it says nor offered to a fix.
  * 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.
@@ -34,17 +50,37 @@ import { type PageMarkdownNodes } from './page-markdown';
 /** How much of a page's text the facts carry. A listing summarizes; it does not need the page. */
 export declare const SEO_PAGE_TEXT_MAX_CHARS = 2000;
 export interface SeoHeading {
-    /** The element, or `null` for a heading inside rich text a fix cannot address. */
+    /**
+     * The element on the page — for one a component renders, the component's
+     * placement — or `null` for a heading inside the page's rich text a fix
+     * cannot address.
+     */
     nodeId: string | null;
     level: number;
+    /** What it says, without the tokens it resolves at render: `''` for a heading made of one. */
     text: string;
-    /** Whether a content fix can change it: a text component with plain text. */
+    /**
+     * Whether a content fix can change it: a text component on the page itself
+     * with plain text and no token — not one a component or a repeat renders.
+     */
     editable: boolean;
+    /** Rendered by a reusable component placed on the page; `nodeId` is the placement. */
+    inComponent?: boolean;
 }
 export interface SeoImage {
+    /** The element on the page, or the component placement that renders it. */
     nodeId: string;
     src: string;
     alt: string;
+    /** Whether a content fix can set its description: an image on the page itself, not a component's or a repeat's. */
+    editable: boolean;
+    /** Rendered by a reusable component placed on the page; `nodeId` is the placement. */
+    inComponent?: boolean;
+    /**
+     * The author marked it decorative (AGL-1305), so its empty description is
+     * the accessible answer rather than a gap.
+     */
+    decorative: boolean;
     /** The nearest heading or text before it, which is what the image illustrates. */
     context: string;
 }
@@ -56,11 +92,18 @@ export interface SeoPageFacts {
     h1s: SeoHeading[];
     images: SeoImage[];
     imagesMissingAlt: SeoImage[];
-    /** The node the content region starts at; a new heading goes first inside it. */
+    /** The page's own node the content region starts at; a new heading goes first inside it. */
     contentRootId: string | null;
 }
-/** Read the facts a listing and the SEO check need from one page's node map. */
+/**
+ * Read the facts a listing and the SEO check need from one page's node map.
+ *
+ * `nodes` is the page as it publishes, composed; `pageNodes` the page's own
+ * map it was composed from, which decides what a fact points at and whether
+ * a fix may change it. Without `pageNodes` the map is read as the page's own.
+ */
 export declare function seoPageFacts(nodes: PageMarkdownNodes | null | undefined, options?: {
     rootId?: string;
     maxChars?: number;
+    pageNodes?: PageMarkdownNodes | null;
 }): SeoPageFacts;

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

@@ -1,3 +1,4 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -26,6 +27,22 @@
  *
  * 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 page as it publishes (AGL-3501)
+ *
+ * Hand it the COMPOSED node map — reusable components grafted, repeats
+ * expanded (`seo-site-scan.ts` composes one) — and the page's own map as
+ * `pageNodes`. A heading a component renders is the page's heading; reading
+ * the raw map instead missed every one of them. The page's own map is what
+ * says where a fact can be fixed: an element a component renders points at
+ * the component's placement on the page and is not `editable` (a page fix
+ * cannot rewrite a component's text), and so is a copy a repeat makes, whose
+ * text is a row's.
+ *
+ * A `{{…}}` token is not copy. A token the composition did not resolve —
+ * a repeat whose rows were not read, a site variable the head resolves — is
+ * left out of the text and the headings, and a heading or a description
+ * made of one is neither judged by what it says nor offered to a fix.
  * 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.
@@ -37,7 +54,13 @@
     'muiInlineText',
     'muiListItemText'
 ]);
+/** A reusable-component placement, as the page's own map stores it (`reusable-component-keys.ts`). */ const REUSABLE_INSTANCE = 'reusableInstance';
+/** The prefix a component's grafted elements carry (`reusable-component-keys.ts`): `cmp__{placementId}__{id}`. */ const COMPONENT_GRAFT_PREFIX = 'cmp__';
+/** The prefix a repeat's copies carry (`expand-repeatables.ts`): `rep__{repeatId}__{index}__{templateId}`. */ const REPEAT_COPY_PREFIX = 'rep__';
+/** A `{{…}}` token: a value something else resolves, never copy of its own. */ const TOKEN_PATTERN = /\{\{[^{}]*\}\}/g;
 const collapse = (value)=>value.replace(/\s+/g, ' ').trim();
+const hasToken = (value)=>value.search(TOKEN_PATTERN) >= 0;
+/** A value as copy: its unresolved tokens left out. */ const withoutTokens = (value)=>collapse(value.replace(TOKEN_PATTERN, ' '));
 /** 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, '&'));
 }
@@ -57,8 +80,67 @@ const collapse = (value)=>value.replace(/\s+/g, ' ').trim();
     };
 }
 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;
+/**
+ * Maps an element of the composed map to the page's own map: itself when the
+ * page holds it, its placement when a component renders it (the placement
+ * keeps its id as the component's root; what the component holds is grafted
+ * under the placement's prefix), and the template a repeat copied it from —
+ * with the copy's text a row's, so not editable.
+ */ function originResolver(pageNodes) {
+    const placementIds = Object.keys(pageNodes).filter((id)=>{
+        var _pageNodes_id;
+        return ((_pageNodes_id = pageNodes[id]) == null ? void 0 : _pageNodes_id.componentId) === REUSABLE_INSTANCE;
+    });
+    const repeatIds = Object.keys(pageNodes).filter((id)=>{
+        var _pageNodes_id_props, _pageNodes_id;
+        const key = (_pageNodes_id = pageNodes[id]) == null ? void 0 : (_pageNodes_id_props = _pageNodes_id.props) == null ? void 0 : _pageNodes_id_props['repeatDataset'];
+        return typeof key === 'string' && key.trim() !== '';
+    });
+    const resolve = (id, depth)=>{
+        if (depth > MAX_DEPTH) return null;
+        const own = pageNodes[id];
+        if (own) {
+            return own.componentId === REUSABLE_INSTANCE ? {
+                nodeId: id,
+                editable: false,
+                inComponent: true
+            } : {
+                nodeId: id,
+                editable: true,
+                inComponent: false
+            };
+        }
+        if (id.startsWith(COMPONENT_GRAFT_PREFIX)) {
+            const placementId = placementIds.find((placement)=>id.startsWith(`${COMPONENT_GRAFT_PREFIX}${placement}__`));
+            return placementId ? {
+                nodeId: placementId,
+                editable: false,
+                inComponent: true
+            } : null;
+        }
+        if (!id.startsWith(REPEAT_COPY_PREFIX)) return null;
+        for (const repeatId of repeatIds){
+            var _exec;
+            const prefix = `${REPEAT_COPY_PREFIX}${repeatId}__`;
+            if (!id.startsWith(prefix)) continue;
+            const template = (_exec = /^\d+__(.+)$/.exec(id.slice(prefix.length))) == null ? void 0 : _exec[1];
+            const origin = template ? resolve(template, depth + 1) : null;
+            if (origin) return _extends({}, origin, {
+                editable: false
+            });
+        }
+        return null;
+    };
+    return (id)=>resolve(id, 0);
+}
+/**
+ * Read the facts a listing and the SEO check need from one page's node map.
+ *
+ * `nodes` is the page as it publishes, composed; `pageNodes` the page's own
+ * map it was composed from, which decides what a fact points at and whether
+ * a fix may change it. Without `pageNodes` the map is read as the page's own.
+ */ export function seoPageFacts(nodes, options = {}) {
+    var _options_maxChars, _options_pageNodes;
     const empty = {
         text: '',
         wordCount: 0,
@@ -74,81 +156,104 @@ const childIdsOf = (node)=>Array.isArray(node == null ? void 0 : node.nodes) ? (
     const markdown = buildPageMarkdown({
         nodes,
         rootId: options.rootId
-    });
+    }).replace(TOKEN_PATTERN, '').replace(/[ \t]{2,}/g, ' ');
     const text = markdown.trim().slice(0, (_options_maxChars = options.maxChars) != null ? _options_maxChars : SEO_PAGE_TEXT_MAX_CHARS);
     const headings = [];
     const images = [];
+    /** Images whose description is a token: described at render, by a value this read cannot see. */ const boundAlt = new Set();
+    const originOf = originResolver((_options_pageNodes = options.pageNodes) != null ? _options_pageNodes : nodes);
     let lastText = '';
     const seen = new Set();
-    const visit = (id, depth)=>{
-        var _node_props, _node_componentId, _props_html;
+    const visit = (id, depth, owner)=>{
+        var _ref, _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;
+        // Inside a placement everything is the component's; elsewhere the page's own map says.
+        const origin = (_ref = owner != null ? owner : originOf(id)) != null ? _ref : {
+            nodeId: id,
+            editable: false,
+            inComponent: false
+        };
+        const tag = origin.inComponent ? {
+            inComponent: true
+        } : {};
         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 { text: raw, plain } = textOf(props);
+            const own = withoutTokens(raw);
+            const bound = hasToken(raw);
             const level = headingLevelOf(props);
-            if (own) {
-                if (level > 0) headings.push({
-                    nodeId: id,
-                    level,
-                    text: own,
-                    editable: plain
-                });
-                lastText = own;
+            if (own || bound) {
+                if (level > 0) {
+                    headings.push(_extends({
+                        nodeId: origin.nodeId,
+                        level,
+                        text: own,
+                        editable: plain && !bound && origin.editable
+                    }, tag));
+                }
+                if (own) 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,
+                    headings.push(_extends({
+                        nodeId: origin.inComponent ? origin.nodeId : null,
                         level: match[1].length,
-                        text: collapse(match[2]),
+                        text: withoutTokens(match[2]),
                         editable: false
-                    });
+                    }, tag));
                 }
             }
-            lastText = collapse(String(props['content'])).slice(0, IMAGE_CONTEXT_MAX_CHARS);
+            lastText = withoutTokens(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,
+                headings.push(_extends({
+                    nodeId: origin.inComponent ? origin.nodeId : null,
                     level: Number(match[1]),
-                    text: htmlText(match[2]),
+                    text: withoutTokens(htmlText(match[2])),
                     editable: false
-                });
+                }, tag));
             }
         } 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,
+                const rawAlt = String((_props_alt = props['alt']) != null ? _props_alt : '');
+                const image = _extends({
+                    nodeId: origin.nodeId,
                     src,
-                    alt: collapse(String((_props_alt = props['alt']) != null ? _props_alt : '')),
+                    alt: withoutTokens(rawAlt),
+                    decorative: props['decorative'] === true,
+                    editable: origin.editable && !hasToken(rawAlt),
                     context: lastText.slice(0, IMAGE_CONTEXT_MAX_CHARS)
-                });
+                }, tag);
+                images.push(image);
+                if (hasToken(rawAlt)) boundAlt.add(image);
             }
         }
-        for (const childId of childIdsOf(node))visit(childId, depth + 1);
+        const inherited = owner != null ? owner : origin.inComponent ? origin : null;
+        for (const childId of childIdsOf(node))visit(childId, depth + 1, inherited);
     };
-    visit(contentRootId, 0);
+    visit(contentRootId, 0, null);
     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
+        imagesMissingAlt: images.filter((image)=>!image.alt && !image.decorative && !boundAlt.has(image)),
+        // Where a fix adds a heading is the page's own content region, which a
+        // composed map can start inside a component.
+        contentRootId: options.pageNodes ? pageContentRootId(options.pageNodes, options.rootId) : contentRootId
     };
 }
 

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

@@ -1 +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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"}
+{"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 *\n * ## The page as it publishes (AGL-3501)\n *\n * Hand it the COMPOSED node map — reusable components grafted, repeats\n * expanded (`seo-site-scan.ts` composes one) — and the page's own map as\n * `pageNodes`. A heading a component renders is the page's heading; reading\n * the raw map instead missed every one of them. The page's own map is what\n * says where a fact can be fixed: an element a component renders points at\n * the component's placement on the page and is not `editable` (a page fix\n * cannot rewrite a component's text), and so is a copy a repeat makes, whose\n * text is a row's.\n *\n * A `{{…}}` token is not copy. A token the composition did not resolve —\n * a repeat whose rows were not read, a site variable the head resolves — is\n * left out of the text and the headings, and a heading or a description\n * made of one is neither judged by what it says nor offered to a fix.\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\n/** A reusable-component placement, as the page's own map stores it (`reusable-component-keys.ts`). */\nconst REUSABLE_INSTANCE = 'reusableInstance'\n\n/** The prefix a component's grafted elements carry (`reusable-component-keys.ts`): `cmp__{placementId}__{id}`. */\nconst COMPONENT_GRAFT_PREFIX = 'cmp__'\n\n/** The prefix a repeat's copies carry (`expand-repeatables.ts`): `rep__{repeatId}__{index}__{templateId}`. */\nconst REPEAT_COPY_PREFIX = 'rep__'\n\n/** A `{{…}}` token: a value something else resolves, never copy of its own. */\nconst TOKEN_PATTERN = /\\{\\{[^{}]*\\}\\}/g\n\nexport interface SeoHeading {\n  /**\n   * The element on the page — for one a component renders, the component's\n   * placement — or `null` for a heading inside the page's rich text a fix\n   * cannot address.\n   */\n  nodeId: string | null\n  level: number\n  /** What it says, without the tokens it resolves at render: `''` for a heading made of one. */\n  text: string\n  /**\n   * Whether a content fix can change it: a text component on the page itself\n   * with plain text and no token — not one a component or a repeat renders.\n   */\n  editable: boolean\n  /** Rendered by a reusable component placed on the page; `nodeId` is the placement. */\n  inComponent?: boolean\n}\n\nexport interface SeoImage {\n  /** The element on the page, or the component placement that renders it. */\n  nodeId: string\n  src: string\n  alt: string\n  /** Whether a content fix can set its description: an image on the page itself, not a component's or a repeat's. */\n  editable: boolean\n  /** Rendered by a reusable component placed on the page; `nodeId` is the placement. */\n  inComponent?: boolean\n  /**\n   * The author marked it decorative (AGL-1305), so its empty description is\n   * the accessible answer rather than a gap.\n   */\n  decorative: boolean\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 page's own 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\nconst hasToken = (value: string): boolean => value.search(TOKEN_PATTERN) >= 0\n\n/** A value as copy: its unresolved tokens left out. */\nconst withoutTokens = (value: string): string => collapse(value.replace(TOKEN_PATTERN, ' '))\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/** Where a fact found on a composed page can be addressed on the page itself. */\ninterface FactOrigin {\n  nodeId: string\n  editable: boolean\n  inComponent: boolean\n}\n\n/**\n * Maps an element of the composed map to the page's own map: itself when the\n * page holds it, its placement when a component renders it (the placement\n * keeps its id as the component's root; what the component holds is grafted\n * under the placement's prefix), and the template a repeat copied it from —\n * with the copy's text a row's, so not editable.\n */\nfunction originResolver(\n  pageNodes: PageMarkdownNodes,\n): (id: string) => FactOrigin | null {\n  const placementIds = Object.keys(pageNodes).filter((id) => pageNodes[id]?.componentId === REUSABLE_INSTANCE)\n  const repeatIds = Object.keys(pageNodes).filter((id) => {\n    const key = (pageNodes[id]?.props as Record<string, unknown> | null | undefined)?.['repeatDataset']\n    return typeof key === 'string' && key.trim() !== ''\n  })\n  const resolve = (id: string, depth: number): FactOrigin | null => {\n    if (depth > MAX_DEPTH) return null\n    const own = pageNodes[id]\n    if (own) {\n      return own.componentId === REUSABLE_INSTANCE\n        ? { nodeId: id, editable: false, inComponent: true }\n        : { nodeId: id, editable: true, inComponent: false }\n    }\n    if (id.startsWith(COMPONENT_GRAFT_PREFIX)) {\n      const placementId = placementIds.find((placement) => id.startsWith(`${COMPONENT_GRAFT_PREFIX}${placement}__`))\n      return placementId ? { nodeId: placementId, editable: false, inComponent: true } : null\n    }\n    if (!id.startsWith(REPEAT_COPY_PREFIX)) return null\n    for (const repeatId of repeatIds) {\n      const prefix = `${REPEAT_COPY_PREFIX}${repeatId}__`\n      if (!id.startsWith(prefix)) continue\n      const template = /^\\d+__(.+)$/.exec(id.slice(prefix.length))?.[1]\n      const origin = template ? resolve(template, depth + 1) : null\n      if (origin) return { ...origin, editable: false }\n    }\n    return null\n  }\n  return (id) => resolve(id, 0)\n}\n\n/**\n * Read the facts a listing and the SEO check need from one page's node map.\n *\n * `nodes` is the page as it publishes, composed; `pageNodes` the page's own\n * map it was composed from, which decides what a fact points at and whether\n * a fix may change it. Without `pageNodes` the map is read as the page's own.\n */\nexport function seoPageFacts(\n  nodes: PageMarkdownNodes | null | undefined,\n  options: { rootId?: string; maxChars?: number; pageNodes?: PageMarkdownNodes | null } = {},\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    .replace(TOKEN_PATTERN, '')\n    .replace(/[ \\t]{2,}/g, ' ')\n  const text = markdown.trim().slice(0, options.maxChars ?? SEO_PAGE_TEXT_MAX_CHARS)\n  const headings: SeoHeading[] = []\n  const images: SeoImage[] = []\n  /** Images whose description is a token: described at render, by a value this read cannot see. */\n  const boundAlt = new Set<SeoImage>()\n  const originOf = originResolver(options.pageNodes ?? nodes)\n  let lastText = ''\n\n  const seen = new Set<string>()\n  const visit = (id: string, depth: number, owner: FactOrigin | null): 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    // Inside a placement everything is the component's; elsewhere the page's own map says.\n    const origin: FactOrigin = owner ?? originOf(id) ?? { nodeId: id, editable: false, inComponent: false }\n    const tag = origin.inComponent ? { inComponent: true as const } : {}\n    const props = (node.props ?? {}) as Record<string, unknown>\n    const componentId = String(node.componentId ?? '')\n    if (TEXT_COMPONENTS.has(componentId)) {\n      const { text: raw, plain } = textOf(props)\n      const own = withoutTokens(raw)\n      const bound = hasToken(raw)\n      const level = headingLevelOf(props)\n      if (own || bound) {\n        if (level > 0) {\n          headings.push({ nodeId: origin.nodeId, level, text: own, editable: plain && !bound && origin.editable, ...tag })\n        }\n        if (own) 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({\n            nodeId: origin.inComponent ? origin.nodeId : null,\n            level: match[1].length,\n            text: withoutTokens(match[2]),\n            editable: false,\n            ...tag,\n          })\n        }\n      }\n      lastText = withoutTokens(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({\n          nodeId: origin.inComponent ? origin.nodeId : null,\n          level: Number(match[1]),\n          text: withoutTokens(htmlText(match[2])),\n          editable: false,\n          ...tag,\n        })\n      }\n    } else if (componentId === 'image') {\n      const src = String(props['src'] ?? '').trim()\n      if (src) {\n        const rawAlt = String(props['alt'] ?? '')\n        const image: SeoImage = {\n          nodeId: origin.nodeId,\n          src,\n          alt: withoutTokens(rawAlt),\n          decorative: props['decorative'] === true,\n          editable: origin.editable && !hasToken(rawAlt),\n          context: lastText.slice(0, IMAGE_CONTEXT_MAX_CHARS),\n          ...tag,\n        }\n        images.push(image)\n        if (hasToken(rawAlt)) boundAlt.add(image)\n      }\n    }\n    const inherited = owner ?? (origin.inComponent ? origin : null)\n    for (const childId of childIdsOf(node)) visit(childId, depth + 1, inherited)\n  }\n  visit(contentRootId, 0, null)\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 && !image.decorative && !boundAlt.has(image)),\n    // Where a fix adds a heading is the page's own content region, which a\n    // composed map can start inside a component.\n    contentRootId: options.pageNodes ? pageContentRootId(options.pageNodes, options.rootId) : contentRootId,\n  }\n}\n"],"names":["buildPageMarkdown","headingLevelOf","isPageChromeNode","pageContentRootId","SEO_PAGE_TEXT_MAX_CHARS","IMAGE_CONTEXT_MAX_CHARS","MAX_DEPTH","TEXT_COMPONENTS","Set","REUSABLE_INSTANCE","COMPONENT_GRAFT_PREFIX","REPEAT_COPY_PREFIX","TOKEN_PATTERN","collapse","value","replace","trim","hasToken","search","withoutTokens","htmlText","html","textOf","props","text","plain","children","childIdsOf","node","Array","isArray","nodes","filter","id","originResolver","pageNodes","placementIds","Object","keys","componentId","repeatIds","key","resolve","depth","own","nodeId","editable","inComponent","startsWith","placementId","find","placement","repeatId","prefix","template","exec","slice","length","origin","seoPageFacts","options","empty","wordCount","headings","h1s","images","imagesMissingAlt","contentRootId","rootId","markdown","maxChars","boundAlt","originOf","lastText","seen","visit","owner","has","add","tag","String","raw","bound","level","push","line","split","match","matchAll","Number","src","rawAlt","image","alt","decorative","context","inherited","childId","Boolean","heading"],"mappings":"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"}

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

@@ -15,6 +15,7 @@
  * limitations under the License.
  */
 import { type SeoAuditPage, type SeoAuditSite } from './seo-audit';
+import { type RepeatableDataset } from './expand-repeatables';
 /**
  * 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
@@ -29,9 +30,16 @@ import { type SeoAuditPage, type SeoAuditSite } from './seo-audit';
  * 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.
  *
+ * Each page is checked as it publishes (AGL-3501): {@link composeSeoPages}
+ * grafts the reusable components it places, with each placement's values,
+ * and expands its repeats over their rows when the caller hands over the
+ * repeat-rows reader — the composition the tenant runs before it renders.
+ *
  * 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.
+ * {@link SEO_AUDIT_MAX_PAGES} + {@link SEO_SCAN_LAYOUT_LIMIT} + 2 — then one
+ * document per distinct component those place, and one repeat-rows request
+ * for every key they repeat over.
  */
 /** Shared layouts read for the links they carry. */
 export declare const SEO_SCAN_LAYOUT_LIMIT = 20;
@@ -100,7 +108,7 @@ interface SeoScreenDocument {
 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. */
+    /** The page's own node map, as its published version stores it — not composed. */
     nodes: Record<string, unknown> | null;
 }
 export interface SeoSiteScan {
@@ -110,6 +118,34 @@ export interface SeoSiteScan {
     /** Customer-safe lines: a keyword line naming a page the site does not publish. */
     notes: string[];
 }
+/**
+ * The rows a site's repeats render, by key — the repeat-rows contract
+ * (`plugin-manager/repeat-rows`), which is server-only and so handed in
+ * rather than imported here.
+ */
+export type SeoRepeatRowsReader = (keys: readonly string[]) => Promise<Record<string, RepeatableDataset>>;
+export interface SeoCompositionOptions {
+    /** Without it a repeat is read once, as written, its `{{item.*}}` tokens left out of the facts. */
+    readRepeatRows?: SeoRepeatRowsReader;
+}
+export interface SeoComposedPages {
+    /** Each node map as it publishes, in the order given; `null` stays `null`. */
+    composed: (Record<string, unknown> | null)[];
+    /** The repeats' rows were asked for and could not be read, so each repeat was read once, as written. */
+    rowsUnread: boolean;
+}
+/**
+ * Node maps of `hostId` as they publish (AGL-3501): each reusable component
+ * placed grafted from its published definition with the placement's values
+ * (`load-referenced-components.ts`, the graft the tenant runs), then each
+ * repeat expanded over its rows when `readRepeatRows` is given — one request
+ * for every key the maps repeat over.
+ *
+ * A component that does not load leaves its placement as authored, as on the
+ * page; rows that cannot be read leave each repeat once, as written, and say
+ * so through `rowsUnread` rather than failing the check.
+ */
+export declare function composeSeoPages(store: SeoScanStore, hostId: string, maps: readonly (Record<string, unknown> | null | undefined)[], options?: SeoCompositionOptions): Promise<SeoComposedPages>;
 /** The site as the check reads it, from its host document. */
 export declare function seoAuditSiteOf(host: SeoSiteHost): SeoAuditSite;
 /**
@@ -117,10 +153,12 @@ export declare function seoAuditSiteOf(host: SeoSiteHost): SeoAuditSite;
  *
  * `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.
+ * renders other URLs through, which are not pages of their own;
+ * `readRepeatRows` reads the rows the pages repeat over
+ * ({@link composeSeoPages}).
  */
 export declare function scanSeoSite(store: SeoScanStore, hostId: string, host: SeoSiteHost, options?: {
     keywords?: unknown;
     templateScreenIds?: Iterable<string>;
-}): Promise<SeoSiteScan>;
+} & SeoCompositionOptions): Promise<SeoSiteScan>;
 export {};