framewatch-mcp-server 0.1.0 → 0.2.0

package/dist/engine/seo.d.ts

@@ -0,0 +1,189 @@
+import type { BrowserContext, Page } from "playwright";
+/**
+ * SEO engine.
+ *
+ * Everything here talks to the page or the network; nothing here decides
+ * whether what it found is good or bad — that is `utils/seo-rules.ts`, which
+ * is pure and therefore testable without a browser.
+ *
+ * The split matters more than it looks. What a crawler sees is a fact about
+ * one particular page load: the DOM *after* the app has rendered (which is why
+ * this reads the live document rather than the HTML source), the response
+ * headers, robots.txt, and whether the share image actually resolves. What
+ * counts as a problem is a judgement, and judgements need unit tests.
+ */
+/** A `<link rel=…>`, with its href resolved against the document. */
+export interface LinkTag {
+    href: string;
+    resolved?: string;
+    hreflang?: string;
+    type?: string;
+}
+export interface HeadingNode {
+    level: number;
+    text: string;
+    /** Not rendered — a visually-hidden h1 is still crawled, so this is context, not a verdict. */
+    hidden: boolean;
+    empty: boolean;
+}
+export interface ImageNode {
+    src: string;
+    /** How the element is named in the report — `#hero`, `.logo`, or its source. */
+    description: string;
+}
+export interface ImageSummary {
+    total: number;
+    /** Images with no `alt` attribute at all (not the same as `alt=""`). */
+    missing_alt: ImageNode[];
+    missing_alt_total: number;
+    /** `alt=""` — a decorative image, correctly marked. */
+    empty_alt: number;
+    /** No `width`/`height` attributes, so the browser cannot reserve space (layout shift). */
+    no_dimensions: number;
+    lazy: number;
+}
+export interface JsonLdBlock {
+    /** The raw script contents, elided at MAX_SEO_JSONLD_LENGTH. */
+    text: string;
+    truncated: boolean;
+}
+export interface AnchorSummary {
+    total: number;
+    internal: number;
+    external: number;
+    nofollow: number;
+    /** Links with neither text nor an accessible name — a dead end for a crawler. */
+    empty: number;
+}
+/**
+ * Everything read out of the rendered document, unjudged.
+ *
+ * Meta tags are kept as three raw maps rather than a curated set of named
+ * fields. `<meta name>` and `<meta property>` are different attributes and
+ * pages use them interchangeably (`og:title` shows up under both), so the
+ * rules look a key up in whichever map has it instead of the extraction
+ * deciding in advance which spellings exist.
+ */
+export interface PageSeo {
+    url: string;
+    title: string | null;
+    title_count: number;
+    lang: string;
+    dir: string;
+    charset: string;
+    named: Record<string, string[]>;
+    properties: Record<string, string[]>;
+    http_equiv: Record<string, string[]>;
+    links: Record<string, LinkTag[]>;
+    headings: HeadingNode[];
+    heading_total: number;
+    heading_counts: Record<string, number>;
+    images: ImageSummary;
+    jsonld: JsonLdBlock[];
+    jsonld_total: number;
+    /** Elements carrying microdata / RDFa, so "no JSON-LD" can say whether there is markup elsewhere. */
+    microdata: number;
+    word_count: number;
+    anchors: AnchorSummary;
+    /** Nodes in the document — Lighthouse's DOM-size warning, and a decent proxy for a page a crawler will struggle with. */
+    dom_nodes: number;
+}
+interface ExtractOptions {
+    max_headings: number;
+    max_images: number;
+    max_text: number;
+    max_jsonld: number;
+    max_jsonld_length: number;
+}
+/**
+ * Read the SEO-relevant parts of the rendered document.
+ *
+ * One `evaluate`, and everything it can find in one pass. It runs against the
+ * live DOM on purpose: a single-page app serves an empty `<div id="app">` in
+ * its HTML and fills in the title, the description and the structured data
+ * afterwards, so reading the source would report every client-rendered page as
+ * having no SEO at all.
+ *
+ * Written against `globalThis` because this package compiles with the Node lib
+ * only, and because a page can be mid-teardown when this lands in it.
+ */
+export declare function extractSeo(page: Page, options?: Partial<ExtractOptions>): Promise<PageSeo>;
+export interface RobotsFetch {
+    url: string;
+    status?: number;
+    text?: string;
+    /** Why there is no text: unreachable, timed out, or a protocol with no robots.txt. */
+    error?: string;
+}
+/**
+ * Fetch the origin's robots.txt.
+ *
+ * Through the browser context, so it goes out with the same cookies and proxy
+ * settings as the page did. A 404 is not a failure — it is the answer "there
+ * are no rules", which is what the rules module does with it.
+ */
+export declare function fetchRobots(context: BrowserContext, pageUrl: string, timeoutMs?: number): Promise<RobotsFetch>;
+export interface ImageProbe {
+    url: string;
+    ok: boolean;
+    status?: number;
+    content_type?: string;
+    bytes?: number;
+    width?: number;
+    height?: number;
+    error?: string;
+    /** The image itself, when it is small enough to hand back to the client. */
+    data?: Buffer;
+}
+/**
+ * Fetch a share image and measure it.
+ *
+ * An `og:image` pointing at a 404, or at a 40x40 favicon, is invisible from
+ * the page itself and shows up as a blank card on every network that renders
+ * the link — which is exactly the sort of thing nobody notices until someone
+ * shares the page. So it is fetched and measured rather than merely reported
+ * as present.
+ */
+export declare function probeImage(context: BrowserContext, url: string, timeoutMs?: number, maxBytes?: number): Promise<ImageProbe>;
+export interface ResourceGroup {
+    type: string;
+    count: number;
+    bytes: number;
+}
+export interface PerfMetrics {
+    ttfb_ms?: number;
+    dom_content_loaded_ms?: number;
+    load_ms?: number;
+    fcp_ms?: number;
+    lcp_ms?: number;
+    lcp_element?: string;
+    cls?: number;
+    long_tasks: number;
+    requests: number;
+    transfer_bytes: number;
+    /** True when at least one resource reported a transferSize of 0 — see `readPerformance`. */
+    transfer_incomplete: boolean;
+    resources: ResourceGroup[];
+}
+/**
+ * The observers that have to be running before the page loads.
+ *
+ * LCP, CLS and long tasks are only observable as they happen. `buffered: true`
+ * covers the gap between document start and this script running, but nothing
+ * covers a script that arrives after the event, so this goes in through
+ * `addInitScript` before the first navigation.
+ */
+export declare const PERF_INIT_SCRIPT: () => void;
+/**
+ * Read the metrics back once the page has settled.
+ *
+ * Everything else — navigation timing, paint timing, resource weight — is
+ * still in the performance buffer at this point and needs no observer.
+ *
+ * `transferSize` is 0 for a cross-origin resource that does not send
+ * `Timing-Allow-Origin`, which is indistinguishable from a cached response, so
+ * the total is reported alongside a flag saying it is a floor rather than a
+ * total.
+ */
+export declare function readPerformance(page: Page): Promise<PerfMetrics | undefined>;
+export {};

package/dist/engine/seo.js

@@ -0,0 +1,398 @@
+import { MAX_SEO_HEADINGS, MAX_SEO_IMAGES_LISTED, MAX_SEO_IMAGE_BYTES, MAX_SEO_JSONLD_BLOCKS, MAX_SEO_JSONLD_LENGTH, MAX_SEO_TEXT_LENGTH, SEO_FETCH_TIMEOUT_MS, } from "../constants.js";
+import { getDimensions } from "../utils/image.js";
+/**
+ * Read the SEO-relevant parts of the rendered document.
+ *
+ * One `evaluate`, and everything it can find in one pass. It runs against the
+ * live DOM on purpose: a single-page app serves an empty `<div id="app">` in
+ * its HTML and fills in the title, the description and the structured data
+ * afterwards, so reading the source would report every client-rendered page as
+ * having no SEO at all.
+ *
+ * Written against `globalThis` because this package compiles with the Node lib
+ * only, and because a page can be mid-teardown when this lands in it.
+ */
+export async function extractSeo(page, options = {}) {
+    const opts = {
+        max_headings: options.max_headings ?? MAX_SEO_HEADINGS,
+        max_images: options.max_images ?? MAX_SEO_IMAGES_LISTED,
+        max_text: options.max_text ?? MAX_SEO_TEXT_LENGTH,
+        max_jsonld: options.max_jsonld ?? MAX_SEO_JSONLD_BLOCKS,
+        max_jsonld_length: options.max_jsonld_length ?? MAX_SEO_JSONLD_LENGTH,
+    };
+    return page.evaluate((o) => {
+        const g = globalThis;
+        const doc = g.document;
+        const flat = (value) => String(value ?? "")
+            .replace(/\s+/g, " ")
+            .trim();
+        const elide = (value, max) => {
+            const text = flat(value);
+            return text.length > max ? `${text.slice(0, max)}…` : text;
+        };
+        const resolve = (href) => {
+            try {
+                return new g.URL(href, doc.baseURI ?? g.location.href).href;
+            }
+            catch {
+                return undefined;
+            }
+        };
+        const push = (map, key, value) => {
+            if (!key)
+                return;
+            (map[key] ??= []).push(value);
+        };
+        /* Meta tags — three maps, keyed exactly as the page spelled them. */
+        const named = {};
+        const properties = {};
+        const httpEquiv = {};
+        let charset = "";
+        for (const meta of doc.querySelectorAll("meta")) {
+            if (meta.hasAttribute("charset"))
+                charset = flat(meta.getAttribute("charset"));
+            const content = flat(meta.getAttribute("content"));
+            const name = flat(meta.getAttribute("name")).toLowerCase();
+            const property = flat(meta.getAttribute("property")).toLowerCase();
+            const equiv = flat(meta.getAttribute("http-equiv")).toLowerCase();
+            if (name)
+                push(named, name, content);
+            if (property)
+                push(properties, property, content);
+            if (equiv) {
+                push(httpEquiv, equiv, content);
+                if (equiv === "content-type" && !charset) {
+                    const match = /charset=([\w-]+)/i.exec(content);
+                    if (match)
+                        charset = match[1];
+                }
+            }
+        }
+        /* <link rel=…>, grouped by rel. One tag can carry several rels. */
+        const links = {};
+        for (const link of doc.querySelectorAll("link[rel]")) {
+            const href = flat(link.getAttribute("href"));
+            const tag = { href };
+            const resolved = href ? resolve(href) : undefined;
+            if (resolved)
+                tag.resolved = resolved;
+            const hreflang = flat(link.getAttribute("hreflang"));
+            if (hreflang)
+                tag.hreflang = hreflang;
+            const type = flat(link.getAttribute("type"));
+            if (type)
+                tag.type = type;
+            for (const rel of flat(link.getAttribute("rel")).toLowerCase().split(/\s+/)) {
+                if (rel)
+                    (links[rel] ??= []).push(tag);
+            }
+        }
+        /* Headings, in document order — the outline a crawler builds. */
+        const headings = [];
+        const headingCounts = { h1: 0, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 };
+        const headingElements = doc.querySelectorAll("h1, h2, h3, h4, h5, h6");
+        for (const heading of headingElements) {
+            const level = Number(heading.tagName.slice(1));
+            headingCounts[`h${level}`] = (headingCounts[`h${level}`] ?? 0) + 1;
+            if (headings.length >= o.max_headings)
+                continue;
+            // offsetParent is null for display:none and for position:fixed, so the
+            // rect is checked too — a fixed header's h1 is visible, not hidden.
+            const rect = heading.getBoundingClientRect?.();
+            const hidden = (heading.offsetParent === null && (!rect || (rect.width === 0 && rect.height === 0))) || false;
+            const text = flat(heading.textContent);
+            headings.push({ level, text: elide(text, o.max_text), hidden, empty: text.length === 0 });
+        }
+        /* Images. A missing alt attribute and alt="" are different findings. */
+        const imageElements = doc.querySelectorAll("img");
+        const missingAlt = [];
+        let missingAltTotal = 0;
+        let emptyAlt = 0;
+        let noDimensions = 0;
+        let lazy = 0;
+        for (const image of imageElements) {
+            const src = flat(image.getAttribute("src") || image.getAttribute("data-src") || image.currentSrc);
+            if (!image.hasAttribute("alt")) {
+                missingAltTotal++;
+                if (missingAlt.length < o.max_images) {
+                    const id = flat(image.getAttribute("id"));
+                    const cls = flat(image.getAttribute("class")).split(" ")[0];
+                    const description = id ? `#${id}` : cls ? `img.${cls}` : elide(src || "img", o.max_text);
+                    missingAlt.push({ src: elide(src, o.max_text), description });
+                }
+            }
+            else if (flat(image.getAttribute("alt")) === "") {
+                emptyAlt++;
+            }
+            if (!image.hasAttribute("width") || !image.hasAttribute("height"))
+                noDimensions++;
+            if (flat(image.getAttribute("loading")).toLowerCase() === "lazy")
+                lazy++;
+        }
+        /* Structured data: collected raw, parsed in Node where a syntax error can be reported. */
+        const scripts = doc.querySelectorAll('script[type="application/ld+json"], script[type="application/ld+json;charset=utf-8"]');
+        const jsonld = [];
+        for (const script of scripts) {
+            if (jsonld.length >= o.max_jsonld)
+                break;
+            const text = String(script.textContent ?? "");
+            jsonld.push({
+                text: text.length > o.max_jsonld_length ? text.slice(0, o.max_jsonld_length) : text,
+                truncated: text.length > o.max_jsonld_length,
+            });
+        }
+        /* Links out of the page. */
+        const anchors = doc.querySelectorAll("a[href]");
+        let internal = 0;
+        let external = 0;
+        let nofollow = 0;
+        let emptyAnchors = 0;
+        const origin = g.location?.origin;
+        for (const anchor of anchors) {
+            const href = flat(anchor.getAttribute("href"));
+            const resolved = resolve(href);
+            if (resolved) {
+                try {
+                    if (new g.URL(resolved).origin === origin)
+                        internal++;
+                    else
+                        external++;
+                }
+                catch {
+                    /* not a URL we can classify */
+                }
+            }
+            if (/\bnofollow\b/i.test(flat(anchor.getAttribute("rel"))))
+                nofollow++;
+            const label = flat(anchor.textContent) || flat(anchor.getAttribute("aria-label")) || flat(anchor.getAttribute("title"));
+            if (!label && anchor.querySelector("img[alt]:not([alt=''])") === null)
+                emptyAnchors++;
+        }
+        const bodyText = flat(doc.body?.innerText ?? "");
+        return {
+            url: String(g.location?.href ?? ""),
+            title: doc.title === undefined || doc.title === null ? null : flat(doc.title),
+            title_count: doc.querySelectorAll("title").length,
+            lang: flat(doc.documentElement?.getAttribute("lang")),
+            dir: flat(doc.documentElement?.getAttribute("dir")),
+            charset,
+            named,
+            properties,
+            http_equiv: httpEquiv,
+            links,
+            headings,
+            heading_total: headingElements.length,
+            heading_counts: headingCounts,
+            images: {
+                total: imageElements.length,
+                missing_alt: missingAlt,
+                missing_alt_total: missingAltTotal,
+                empty_alt: emptyAlt,
+                no_dimensions: noDimensions,
+                lazy,
+            },
+            jsonld,
+            jsonld_total: scripts.length,
+            microdata: doc.querySelectorAll("[itemscope]").length,
+            word_count: bodyText ? bodyText.split(" ").length : 0,
+            anchors: { total: anchors.length, internal, external, nofollow, empty: emptyAnchors },
+            dom_nodes: doc.getElementsByTagName("*").length,
+        };
+    }, opts);
+}
+/**
+ * Fetch the origin's robots.txt.
+ *
+ * Through the browser context, so it goes out with the same cookies and proxy
+ * settings as the page did. A 404 is not a failure — it is the answer "there
+ * are no rules", which is what the rules module does with it.
+ */
+export async function fetchRobots(context, pageUrl, timeoutMs = SEO_FETCH_TIMEOUT_MS) {
+    let robotsUrl;
+    try {
+        const parsed = new URL(pageUrl);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            return { url: pageUrl, error: `${parsed.protocol}// has no robots.txt` };
+        }
+        robotsUrl = new URL("/robots.txt", parsed.origin).href;
+    }
+    catch (error) {
+        return { url: pageUrl, error: firstLine(error) };
+    }
+    try {
+        const response = await context.request.get(robotsUrl, { timeout: timeoutMs, failOnStatusCode: false });
+        const status = response.status();
+        if (status >= 400)
+            return { url: robotsUrl, status };
+        return { url: robotsUrl, status, text: await response.text() };
+    }
+    catch (error) {
+        return { url: robotsUrl, error: firstLine(error) };
+    }
+}
+/**
+ * Fetch a share image and measure it.
+ *
+ * An `og:image` pointing at a 404, or at a 40x40 favicon, is invisible from
+ * the page itself and shows up as a blank card on every network that renders
+ * the link — which is exactly the sort of thing nobody notices until someone
+ * shares the page. So it is fetched and measured rather than merely reported
+ * as present.
+ */
+export async function probeImage(context, url, timeoutMs = SEO_FETCH_TIMEOUT_MS, maxBytes = MAX_SEO_IMAGE_BYTES) {
+    try {
+        const response = await context.request.get(url, { timeout: timeoutMs, failOnStatusCode: false });
+        const status = response.status();
+        const contentType = response.headers()["content-type"];
+        const probe = { url, ok: status < 400, status };
+        if (contentType)
+            probe.content_type = contentType;
+        if (!probe.ok)
+            return probe;
+        const body = await response.body();
+        probe.bytes = body.byteLength;
+        try {
+            const { width, height } = await getDimensions(body);
+            probe.width = width;
+            probe.height = height;
+            if (body.byteLength <= maxBytes)
+                probe.data = body;
+        }
+        catch (error) {
+            // Reachable but not an image this build can decode (an SVG on a libvips
+            // without librsvg, an HTML error page served as 200). Worth saying.
+            probe.error = firstLine(error);
+        }
+        return probe;
+    }
+    catch (error) {
+        return { url, ok: false, error: firstLine(error) };
+    }
+}
+/**
+ * The observers that have to be running before the page loads.
+ *
+ * LCP, CLS and long tasks are only observable as they happen. `buffered: true`
+ * covers the gap between document start and this script running, but nothing
+ * covers a script that arrives after the event, so this goes in through
+ * `addInitScript` before the first navigation.
+ */
+export const PERF_INIT_SCRIPT = () => {
+    const g = globalThis;
+    // Whole-page metrics: the main frame owns them.
+    if (g.top && g.top !== g)
+        return;
+    if (g.__framewatch_seo_perf)
+        return;
+    const state = { lcp: 0, lcp_element: "", cls: 0, long_tasks: 0 };
+    g.__framewatch_seo_perf = state;
+    if (typeof g.PerformanceObserver !== "function")
+        return;
+    const describe = (element) => {
+        if (!element || !element.tagName)
+            return "";
+        const tag = String(element.tagName).toLowerCase();
+        const id = element.id ? `#${element.id}` : "";
+        const cls = element.classList && element.classList.length > 0 ? `.${element.classList[0]}` : "";
+        return `${tag}${id}${cls}`;
+    };
+    const observe = (type, handle) => {
+        try {
+            new g.PerformanceObserver((list) => handle(list.getEntries())).observe({ type, buffered: true });
+        }
+        catch {
+            // This browser does not report this entry type; the metric is simply absent.
+        }
+    };
+    observe("largest-contentful-paint", (entries) => {
+        for (const entry of entries) {
+            // Each entry supersedes the last: LCP is the final one before interaction.
+            state.lcp = entry.startTime;
+            state.lcp_element = describe(entry.element);
+        }
+    });
+    observe("layout-shift", (entries) => {
+        for (const entry of entries) {
+            // Shifts within 500ms of a real interaction are the user's doing, and
+            // Chrome's CLS excludes them for the same reason.
+            if (!entry.hadRecentInput)
+                state.cls += entry.value;
+        }
+    });
+    observe("longtask", (entries) => {
+        state.long_tasks += entries.length;
+    });
+};
+/**
+ * Read the metrics back once the page has settled.
+ *
+ * Everything else — navigation timing, paint timing, resource weight — is
+ * still in the performance buffer at this point and needs no observer.
+ *
+ * `transferSize` is 0 for a cross-origin resource that does not send
+ * `Timing-Allow-Origin`, which is indistinguishable from a cached response, so
+ * the total is reported alongside a flag saying it is a floor rather than a
+ * total.
+ */
+export async function readPerformance(page) {
+    try {
+        return await page.evaluate(() => {
+            const g = globalThis;
+            const perf = g.performance;
+            const state = g.__framewatch_seo_perf ?? { lcp: 0, lcp_element: "", cls: 0, long_tasks: 0 };
+            const round = (value) => {
+                const n = Number(value);
+                return Number.isFinite(n) && n >= 0 ? Math.round(n) : undefined;
+            };
+            const metrics = {
+                long_tasks: state.long_tasks ?? 0,
+                requests: 0,
+                transfer_bytes: 0,
+                transfer_incomplete: false,
+                resources: [],
+            };
+            const nav = perf?.getEntriesByType?.("navigation")?.[0];
+            if (nav) {
+                metrics.ttfb_ms = round(nav.responseStart);
+                metrics.dom_content_loaded_ms = round(nav.domContentLoadedEventEnd);
+                metrics.load_ms = round(nav.loadEventEnd) || undefined;
+                if (nav.transferSize > 0)
+                    metrics.transfer_bytes += nav.transferSize;
+            }
+            for (const paint of perf?.getEntriesByType?.("paint") ?? []) {
+                if (paint.name === "first-contentful-paint")
+                    metrics.fcp_ms = round(paint.startTime);
+            }
+            if (state.lcp > 0) {
+                metrics.lcp_ms = round(state.lcp);
+                if (state.lcp_element)
+                    metrics.lcp_element = state.lcp_element;
+            }
+            if (typeof state.cls === "number")
+                metrics.cls = Math.round(state.cls * 1000) / 1000;
+            const byType = new Map();
+            for (const resource of perf?.getEntriesByType?.("resource") ?? []) {
+                metrics.requests++;
+                const size = Number(resource.transferSize) || 0;
+                if (size === 0)
+                    metrics.transfer_incomplete = true;
+                metrics.transfer_bytes += size;
+                const type = String(resource.initiatorType || "other");
+                const group = byType.get(type) ?? { type, count: 0, bytes: 0 };
+                group.count++;
+                group.bytes += size;
+                byType.set(type, group);
+            }
+            metrics.resources = [...byType.values()].sort((a, b) => b.bytes - a.bytes || b.count - a.count);
+            return metrics;
+        });
+    }
+    catch {
+        // Cosmetic: a page that dies before this is read still gets its audit.
+        return undefined;
+    }
+}
+function firstLine(error) {
+    return (error instanceof Error ? error.message : String(error)).split("\n")[0];
+}
+//# sourceMappingURL=seo.js.map

package/dist/engine/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.js","sourceRoot":"","sources":["../../src/engine/seo.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BrowserContext, Page } from \"playwright\";\nimport {\n  MAX_SEO_HEADINGS,\n  MAX_SEO_IMAGES_LISTED,\n  MAX_SEO_IMAGE_BYTES,\n  MAX_SEO_JSONLD_BLOCKS,\n  MAX_SEO_JSONLD_LENGTH,\n  MAX_SEO_TEXT_LENGTH,\n  SEO_FETCH_TIMEOUT_MS,\n} from \"../constants.js\";\nimport { getDimensions } from \"../utils/image.js\";\n\n/**\n * SEO engine.\n *\n * Everything here talks to the page or the network; nothing here decides\n * whether what it found is good or bad — that is `utils/seo-rules.ts`, which\n * is pure and therefore testable without a browser.\n *\n * The split matters more than it looks. What a crawler sees is a fact about\n * one particular page load: the DOM *after* the app has rendered (which is why\n * this reads the live document rather than the HTML source), the response\n * headers, robots.txt, and whether the share image actually resolves. What\n * counts as a problem is a judgement, and judgements need unit tests.\n */\n\n/* ── What the page says about itself ──────────────────────────────────── */\n\n/** A `<link rel=…>`, with its href resolved against the document. */\nexport interface LinkTag {\n  href: string;\n  resolved?: string;\n  hreflang?: string;\n  type?: string;\n}\n\nexport interface HeadingNode {\n  level: number;\n  text: string;\n  /** Not rendered — a visually-hidden h1 is still crawled, so this is context, not a verdict. */\n  hidden: boolean;\n  empty: boolean;\n}\n\nexport interface ImageNode {\n  src: string;\n  /** How the element is named in the report — `#hero`, `.logo`, or its source. */\n  description: string;\n}\n\nexport interface ImageSummary {\n  total: number;\n  /** Images with no `alt` attribute at all (not the same as `alt=\"\"`). */\n  missing_alt: ImageNode[];\n  missing_alt_total: number;\n  /** `alt=\"\"` — a decorative image, correctly marked. */\n  empty_alt: number;\n  /** No `width`/`height` attributes, so the browser cannot reserve space (layout shift). */\n  no_dimensions: number;\n  lazy: number;\n}\n\nexport interface JsonLdBlock {\n  /** The raw script contents, elided at MAX_SEO_JSONLD_LENGTH. */\n  text: string;\n  truncated: boolean;\n}\n\nexport interface AnchorSummary {\n  total: number;\n  internal: number;\n  external: number;\n  nofollow: number;\n  /** Links with neither text nor an accessible name — a dead end for a crawler. */\n  empty: number;\n}\n\n/**\n * Everything read out of the rendered document, unjudged.\n *\n * Meta tags are kept as three raw maps rather than a curated set of named\n * fields. `<meta name>` and `<meta property>` are different attributes and\n * pages use them interchangeably (`og:title` shows up under both), so the\n * rules look a key up in whichever map has it instead of the extraction\n * deciding in advance which spellings exist.\n */\nexport interface PageSeo {\n  url: string;\n  title: string | null;\n  title_count: number;\n  lang: string;\n  dir: string;\n  charset: string;\n  named: Record<string, string[]>;\n  properties: Record<string, string[]>;\n  http_equiv: Record<string, string[]>;\n  links: Record<string, LinkTag[]>;\n  headings: HeadingNode[];\n  heading_total: number;\n  heading_counts: Record<string, number>;\n  images: ImageSummary;\n  jsonld: JsonLdBlock[];\n  jsonld_total: number;\n  /** Elements carrying microdata / RDFa, so \"no JSON-LD\" can say whether there is markup elsewhere. */\n  microdata: number;\n  word_count: number;\n  anchors: AnchorSummary;\n  /** Nodes in the document — Lighthouse's DOM-size warning, and a decent proxy for a page a crawler will struggle with. */\n  dom_nodes: number;\n}\n\ninterface ExtractOptions {\n  max_headings: number;\n  max_images: number;\n  max_text: number;\n  max_jsonld: number;\n  max_jsonld_length: number;\n}\n\n/**\n * Read the SEO-relevant parts of the rendered document.\n *\n * One `evaluate`, and everything it can find in one pass. It runs against the\n * live DOM on purpose: a single-page app serves an empty `<div id=\"app\">` in\n * its HTML and fills in the title, the description and the structured data\n * afterwards, so reading the source would report every client-rendered page as\n * having no SEO at all.\n *\n * Written against `globalThis` because this package compiles with the Node lib\n * only, and because a page can be mid-teardown when this lands in it.\n */\nexport async function extractSeo(page: Page, options: Partial<ExtractOptions> = {}): Promise<PageSeo> {\n  const opts: ExtractOptions = {\n    max_headings: options.max_headings ?? MAX_SEO_HEADINGS,\n    max_images: options.max_images ?? MAX_SEO_IMAGES_LISTED,\n    max_text: options.max_text ?? MAX_SEO_TEXT_LENGTH,\n    max_jsonld: options.max_jsonld ?? MAX_SEO_JSONLD_BLOCKS,\n    max_jsonld_length: options.max_jsonld_length ?? MAX_SEO_JSONLD_LENGTH,\n  };\n\n  return page.evaluate((o: ExtractOptions): PageSeo => {\n    const g = globalThis as any;\n    const doc = g.document;\n\n    const flat = (value: unknown): string =>\n      String(value ?? \"\")\n        .replace(/\\s+/g, \" \")\n        .trim();\n    const elide = (value: unknown, max: number): string => {\n      const text = flat(value);\n      return text.length > max ? `${text.slice(0, max)}…` : text;\n    };\n    const resolve = (href: string): string | undefined => {\n      try {\n        return new g.URL(href, doc.baseURI ?? g.location.href).href;\n      } catch {\n        return undefined;\n      }\n    };\n    const push = (map: Record<string, string[]>, key: string, value: string): void => {\n      if (!key) return;\n      (map[key] ??= []).push(value);\n    };\n\n    /* Meta tags — three maps, keyed exactly as the page spelled them. */\n    const named: Record<string, string[]> = {};\n    const properties: Record<string, string[]> = {};\n    const httpEquiv: Record<string, string[]> = {};\n    let charset = \"\";\n    for (const meta of doc.querySelectorAll(\"meta\")) {\n      if (meta.hasAttribute(\"charset\")) charset = flat(meta.getAttribute(\"charset\"));\n      const content = flat(meta.getAttribute(\"content\"));\n      const name = flat(meta.getAttribute(\"name\")).toLowerCase();\n      const property = flat(meta.getAttribute(\"property\")).toLowerCase();\n      const equiv = flat(meta.getAttribute(\"http-equiv\")).toLowerCase();\n      if (name) push(named, name, content);\n      if (property) push(properties, property, content);\n      if (equiv) {\n        push(httpEquiv, equiv, content);\n        if (equiv === \"content-type\" && !charset) {\n          const match = /charset=([\\w-]+)/i.exec(content);\n          if (match) charset = match[1];\n        }\n      }\n    }\n\n    /* <link rel=…>, grouped by rel. One tag can carry several rels. */\n    const links: Record<string, LinkTag[]> = {};\n    for (const link of doc.querySelectorAll(\"link[rel]\")) {\n      const href = flat(link.getAttribute(\"href\"));\n      const tag: LinkTag = { href };\n      const resolved = href ? resolve(href) : undefined;\n      if (resolved) tag.resolved = resolved;\n      const hreflang = flat(link.getAttribute(\"hreflang\"));\n      if (hreflang) tag.hreflang = hreflang;\n      const type = flat(link.getAttribute(\"type\"));\n      if (type) tag.type = type;\n      for (const rel of flat(link.getAttribute(\"rel\")).toLowerCase().split(/\\s+/)) {\n        if (rel) (links[rel] ??= []).push(tag);\n      }\n    }\n\n    /* Headings, in document order — the outline a crawler builds. */\n    const headings: HeadingNode[] = [];\n    const headingCounts: Record<string, number> = { h1: 0, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 };\n    const headingElements = doc.querySelectorAll(\"h1, h2, h3, h4, h5, h6\");\n    for (const heading of headingElements) {\n      const level = Number(heading.tagName.slice(1));\n      headingCounts[`h${level}`] = (headingCounts[`h${level}`] ?? 0) + 1;\n      if (headings.length >= o.max_headings) continue;\n      // offsetParent is null for display:none and for position:fixed, so the\n      // rect is checked too — a fixed header's h1 is visible, not hidden.\n      const rect = heading.getBoundingClientRect?.();\n      const hidden = (heading.offsetParent === null && (!rect || (rect.width === 0 && rect.height === 0))) || false;\n      const text = flat(heading.textContent);\n      headings.push({ level, text: elide(text, o.max_text), hidden, empty: text.length === 0 });\n    }\n\n    /* Images. A missing alt attribute and alt=\"\" are different findings. */\n    const imageElements = doc.querySelectorAll(\"img\");\n    const missingAlt: ImageNode[] = [];\n    let missingAltTotal = 0;\n    let emptyAlt = 0;\n    let noDimensions = 0;\n    let lazy = 0;\n    for (const image of imageElements) {\n      const src = flat(image.getAttribute(\"src\") || image.getAttribute(\"data-src\") || image.currentSrc);\n      if (!image.hasAttribute(\"alt\")) {\n        missingAltTotal++;\n        if (missingAlt.length < o.max_images) {\n          const id = flat(image.getAttribute(\"id\"));\n          const cls = flat(image.getAttribute(\"class\")).split(\" \")[0];\n          const description = id ? `#${id}` : cls ? `img.${cls}` : elide(src || \"img\", o.max_text);\n          missingAlt.push({ src: elide(src, o.max_text), description });\n        }\n      } else if (flat(image.getAttribute(\"alt\")) === \"\") {\n        emptyAlt++;\n      }\n      if (!image.hasAttribute(\"width\") || !image.hasAttribute(\"height\")) noDimensions++;\n      if (flat(image.getAttribute(\"loading\")).toLowerCase() === \"lazy\") lazy++;\n    }\n\n    /* Structured data: collected raw, parsed in Node where a syntax error can be reported. */\n    const scripts = doc.querySelectorAll('script[type=\"application/ld+json\"], script[type=\"application/ld+json;charset=utf-8\"]');\n    const jsonld: JsonLdBlock[] = [];\n    for (const script of scripts) {\n      if (jsonld.length >= o.max_jsonld) break;\n      const text = String(script.textContent ?? \"\");\n      jsonld.push({\n        text: text.length > o.max_jsonld_length ? text.slice(0, o.max_jsonld_length) : text,\n        truncated: text.length > o.max_jsonld_length,\n      });\n    }\n\n    /* Links out of the page. */\n    const anchors = doc.querySelectorAll(\"a[href]\");\n    let internal = 0;\n    let external = 0;\n    let nofollow = 0;\n    let emptyAnchors = 0;\n    const origin = g.location?.origin;\n    for (const anchor of anchors) {\n      const href = flat(anchor.getAttribute(\"href\"));\n      const resolved = resolve(href);\n      if (resolved) {\n        try {\n          if (new g.URL(resolved).origin === origin) internal++;\n          else external++;\n        } catch {\n          /* not a URL we can classify */\n        }\n      }\n      if (/\\bnofollow\\b/i.test(flat(anchor.getAttribute(\"rel\")))) nofollow++;\n      const label = flat(anchor.textContent) || flat(anchor.getAttribute(\"aria-label\")) || flat(anchor.getAttribute(\"title\"));\n      if (!label && anchor.querySelector(\"img[alt]:not([alt=''])\") === null) emptyAnchors++;\n    }\n\n    const bodyText = flat(doc.body?.innerText ?? \"\");\n\n    return {\n      url: String(g.location?.href ?? \"\"),\n      title: doc.title === undefined || doc.title === null ? null : flat(doc.title),\n      title_count: doc.querySelectorAll(\"title\").length,\n      lang: flat(doc.documentElement?.getAttribute(\"lang\")),\n      dir: flat(doc.documentElement?.getAttribute(\"dir\")),\n      charset,\n      named,\n      properties,\n      http_equiv: httpEquiv,\n      links,\n      headings,\n      heading_total: headingElements.length,\n      heading_counts: headingCounts,\n      images: {\n        total: imageElements.length,\n        missing_alt: missingAlt,\n        missing_alt_total: missingAltTotal,\n        empty_alt: emptyAlt,\n        no_dimensions: noDimensions,\n        lazy,\n      },\n      jsonld,\n      jsonld_total: scripts.length,\n      microdata: doc.querySelectorAll(\"[itemscope]\").length,\n      word_count: bodyText ? bodyText.split(\" \").length : 0,\n      anchors: { total: anchors.length, internal, external, nofollow, empty: emptyAnchors },\n      dom_nodes: doc.getElementsByTagName(\"*\").length,\n    };\n  }, opts);\n}\n\n/* ── robots.txt ───────────────────────────────────────────────────────── */\n\nexport interface RobotsFetch {\n  url: string;\n  status?: number;\n  text?: string;\n  /** Why there is no text: unreachable, timed out, or a protocol with no robots.txt. */\n  error?: string;\n}\n\n/**\n * Fetch the origin's robots.txt.\n *\n * Through the browser context, so it goes out with the same cookies and proxy\n * settings as the page did. A 404 is not a failure — it is the answer \"there\n * are no rules\", which is what the rules module does with it.\n */\nexport async function fetchRobots(context: BrowserContext, pageUrl: string, timeoutMs = SEO_FETCH_TIMEOUT_MS): Promise<RobotsFetch> {\n  let robotsUrl: string;\n  try {\n    const parsed = new URL(pageUrl);\n    if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n      return { url: pageUrl, error: `${parsed.protocol}// has no robots.txt` };\n    }\n    robotsUrl = new URL(\"/robots.txt\", parsed.origin).href;\n  } catch (error) {\n    return { url: pageUrl, error: firstLine(error) };\n  }\n\n  try {\n    const response = await context.request.get(robotsUrl, { timeout: timeoutMs, failOnStatusCode: false });\n    const status = response.status();\n    if (status >= 400) return { url: robotsUrl, status };\n    return { url: robotsUrl, status, text: await response.text() };\n  } catch (error) {\n    return { url: robotsUrl, error: firstLine(error) };\n  }\n}\n\n/* ── The share image ──────────────────────────────────────────────────── */\n\nexport interface ImageProbe {\n  url: string;\n  ok: boolean;\n  status?: number;\n  content_type?: string;\n  bytes?: number;\n  width?: number;\n  height?: number;\n  error?: string;\n  /** The image itself, when it is small enough to hand back to the client. */\n  data?: Buffer;\n}\n\n/**\n * Fetch a share image and measure it.\n *\n * An `og:image` pointing at a 404, or at a 40x40 favicon, is invisible from\n * the page itself and shows up as a blank card on every network that renders\n * the link — which is exactly the sort of thing nobody notices until someone\n * shares the page. So it is fetched and measured rather than merely reported\n * as present.\n */\nexport async function probeImage(\n  context: BrowserContext,\n  url: string,\n  timeoutMs = SEO_FETCH_TIMEOUT_MS,\n  maxBytes = MAX_SEO_IMAGE_BYTES,\n): Promise<ImageProbe> {\n  try {\n    const response = await context.request.get(url, { timeout: timeoutMs, failOnStatusCode: false });\n    const status = response.status();\n    const contentType = response.headers()[\"content-type\"];\n    const probe: ImageProbe = { url, ok: status < 400, status };\n    if (contentType) probe.content_type = contentType;\n    if (!probe.ok) return probe;\n\n    const body = await response.body();\n    probe.bytes = body.byteLength;\n    try {\n      const { width, height } = await getDimensions(body);\n      probe.width = width;\n      probe.height = height;\n      if (body.byteLength <= maxBytes) probe.data = body;\n    } catch (error) {\n      // Reachable but not an image this build can decode (an SVG on a libvips\n      // without librsvg, an HTML error page served as 200). Worth saying.\n      probe.error = firstLine(error);\n    }\n    return probe;\n  } catch (error) {\n    return { url, ok: false, error: firstLine(error) };\n  }\n}\n\n/* ── Performance ──────────────────────────────────────────────────────── */\n\nexport interface ResourceGroup {\n  type: string;\n  count: number;\n  bytes: number;\n}\n\nexport interface PerfMetrics {\n  ttfb_ms?: number;\n  dom_content_loaded_ms?: number;\n  load_ms?: number;\n  fcp_ms?: number;\n  lcp_ms?: number;\n  lcp_element?: string;\n  cls?: number;\n  long_tasks: number;\n  requests: number;\n  transfer_bytes: number;\n  /** True when at least one resource reported a transferSize of 0 — see `readPerformance`. */\n  transfer_incomplete: boolean;\n  resources: ResourceGroup[];\n}\n\n/**\n * The observers that have to be running before the page loads.\n *\n * LCP, CLS and long tasks are only observable as they happen. `buffered: true`\n * covers the gap between document start and this script running, but nothing\n * covers a script that arrives after the event, so this goes in through\n * `addInitScript` before the first navigation.\n */\nexport const PERF_INIT_SCRIPT = (): void => {\n  const g = globalThis as any;\n  // Whole-page metrics: the main frame owns them.\n  if (g.top && g.top !== g) return;\n  if (g.__framewatch_seo_perf) return;\n  const state = { lcp: 0, lcp_element: \"\", cls: 0, long_tasks: 0 };\n  g.__framewatch_seo_perf = state;\n  if (typeof g.PerformanceObserver !== \"function\") return;\n\n  const describe = (element: any): string => {\n    if (!element || !element.tagName) return \"\";\n    const tag = String(element.tagName).toLowerCase();\n    const id = element.id ? `#${element.id}` : \"\";\n    const cls = element.classList && element.classList.length > 0 ? `.${element.classList[0]}` : \"\";\n    return `${tag}${id}${cls}`;\n  };\n\n  const observe = (type: string, handle: (entries: any[]) => void): void => {\n    try {\n      new g.PerformanceObserver((list: any) => handle(list.getEntries())).observe({ type, buffered: true });\n    } catch {\n      // This browser does not report this entry type; the metric is simply absent.\n    }\n  };\n\n  observe(\"largest-contentful-paint\", (entries) => {\n    for (const entry of entries) {\n      // Each entry supersedes the last: LCP is the final one before interaction.\n      state.lcp = entry.startTime;\n      state.lcp_element = describe(entry.element);\n    }\n  });\n  observe(\"layout-shift\", (entries) => {\n    for (const entry of entries) {\n      // Shifts within 500ms of a real interaction are the user's doing, and\n      // Chrome's CLS excludes them for the same reason.\n      if (!entry.hadRecentInput) state.cls += entry.value;\n    }\n  });\n  observe(\"longtask\", (entries) => {\n    state.long_tasks += entries.length;\n  });\n};\n\n/**\n * Read the metrics back once the page has settled.\n *\n * Everything else — navigation timing, paint timing, resource weight — is\n * still in the performance buffer at this point and needs no observer.\n *\n * `transferSize` is 0 for a cross-origin resource that does not send\n * `Timing-Allow-Origin`, which is indistinguishable from a cached response, so\n * the total is reported alongside a flag saying it is a floor rather than a\n * total.\n */\nexport async function readPerformance(page: Page): Promise<PerfMetrics | undefined> {\n  try {\n    return await page.evaluate((): PerfMetrics => {\n      const g = globalThis as any;\n      const perf = g.performance;\n      const state = g.__framewatch_seo_perf ?? { lcp: 0, lcp_element: \"\", cls: 0, long_tasks: 0 };\n      const round = (value: unknown): number | undefined => {\n        const n = Number(value);\n        return Number.isFinite(n) && n >= 0 ? Math.round(n) : undefined;\n      };\n\n      const metrics: PerfMetrics = {\n        long_tasks: state.long_tasks ?? 0,\n        requests: 0,\n        transfer_bytes: 0,\n        transfer_incomplete: false,\n        resources: [],\n      };\n\n      const nav = perf?.getEntriesByType?.(\"navigation\")?.[0];\n      if (nav) {\n        metrics.ttfb_ms = round(nav.responseStart);\n        metrics.dom_content_loaded_ms = round(nav.domContentLoadedEventEnd);\n        metrics.load_ms = round(nav.loadEventEnd) || undefined;\n        if (nav.transferSize > 0) metrics.transfer_bytes += nav.transferSize;\n      }\n\n      for (const paint of perf?.getEntriesByType?.(\"paint\") ?? []) {\n        if (paint.name === \"first-contentful-paint\") metrics.fcp_ms = round(paint.startTime);\n      }\n      if (state.lcp > 0) {\n        metrics.lcp_ms = round(state.lcp);\n        if (state.lcp_element) metrics.lcp_element = state.lcp_element;\n      }\n      if (typeof state.cls === \"number\") metrics.cls = Math.round(state.cls * 1000) / 1000;\n\n      const byType = new Map<string, ResourceGroup>();\n      for (const resource of perf?.getEntriesByType?.(\"resource\") ?? []) {\n        metrics.requests++;\n        const size = Number(resource.transferSize) || 0;\n        if (size === 0) metrics.transfer_incomplete = true;\n        metrics.transfer_bytes += size;\n        const type = String(resource.initiatorType || \"other\");\n        const group = byType.get(type) ?? { type, count: 0, bytes: 0 };\n        group.count++;\n        group.bytes += size;\n        byType.set(type, group);\n      }\n      metrics.resources = [...byType.values()].sort((a, b) => b.bytes - a.bytes || b.count - a.count);\n\n      return metrics;\n    });\n  } catch {\n    // Cosmetic: a page that dies before this is read still gets its audit.\n    return undefined;\n  }\n}\n\nfunction firstLine(error: unknown): string {\n  return (error instanceof Error ? error.message : String(error)).split(\"\\n\")[0];\n}\n"]}