@rivi-software/agentic-seo-check 0.0.0-stage → 0.1.1

package/dist/core/render.js

@@ -0,0 +1,79 @@
+import { DEFAULT_USER_AGENT } from "./fetch.js";
+export class RenderUnavailableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RenderUnavailableError";
+    }
+}
+export const RENDER_INSTALL_HINT = "Install Playwright to enable rendering: `pnpm add -D playwright && pnpm exec playwright install chromium` (or npm/npx equivalents).";
+const launchSystemBrowser = async (playwright) => {
+    for (const channel of ["chrome", "msedge"]) {
+        try {
+            // oxlint-disable-next-line eslint/no-await-in-loop -- one browser at a time, in order of preference
+            return await playwright.chromium.launch({ headless: true, channel });
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return null;
+};
+const firstLine = (message) => message.split("\n")[0] ?? message;
+/** Load the page in headless Chromium and return the rendered DOM. */
+export const renderPage = async (url, options = {}) => {
+    let playwright;
+    try {
+        playwright = await import("playwright");
+    }
+    catch {
+        throw new RenderUnavailableError(`Playwright is not installed. ${RENDER_INSTALL_HINT}`);
+    }
+    let browser;
+    try {
+        browser = await playwright.chromium.launch({ headless: true });
+    }
+    catch (error) {
+        // No downloaded Playwright browser: fall back to an installed Google Chrome / Edge.
+        const fallback = await launchSystemBrowser(playwright);
+        if (!fallback) {
+            throw new RenderUnavailableError(`Could not launch Chromium: ${firstLine(error instanceof Error ? error.message : String(error))}. ${RENDER_INSTALL_HINT}`);
+        }
+        browser = fallback;
+    }
+    const timeout = options.timeoutMs ?? 30_000;
+    const consoleErrors = [];
+    try {
+        const context = await browser.newContext({
+            userAgent: options.userAgent ?? DEFAULT_USER_AGENT,
+            viewport: options.viewport ?? { width: 1366, height: 900 },
+            extraHTTPHeaders: options.headers,
+        });
+        const page = await context.newPage();
+        page.on("console", (msg) => {
+            if (msg.type() === "error") {
+                consoleErrors.push(msg.text().slice(0, 300));
+            }
+        });
+        page.on("pageerror", (err) => consoleErrors.push(err.message.slice(0, 300)));
+        try {
+            await page.goto(url, {
+                waitUntil: options.waitUntil ?? "networkidle",
+                timeout,
+            });
+        }
+        catch (error) {
+            // networkidle can time out on pages with long-polling; fall back to whatever has loaded.
+            if (!(error instanceof Error) || !/Timeout/iu.test(error.message)) {
+                throw error;
+            }
+        }
+        await page.waitForTimeout(250);
+        const html = await page.content();
+        return { html, finalUrl: page.url(), consoleErrors };
+    }
+    finally {
+        // A browser that fails to close must not replace the page's result or its error.
+        await browser.close().catch(() => null);
+    }
+};
+//# sourceMappingURL=render.js.map

package/dist/core/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/core/render.ts"],"names":[],"mappings":"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"}

package/dist/core/report/markdown.d.ts

@@ -0,0 +1,2 @@
+import type { Audit } from "../types.js";
+export declare const renderMarkdown: (audit: Audit) => string;

package/dist/core/report/markdown.js

@@ -0,0 +1,131 @@
+import { MAKER, MAKER_URL, REPOSITORY_URL } from "../../brand.js";
+import { VERSION } from "../../version.js";
+const cell = (value) => {
+    if (!value) {
+        return "—";
+    }
+    return value.replaceAll("|", "\\|").replaceAll("\n", " ").slice(0, 120);
+};
+const ms = (value) => value === null ? "—" : `${Math.round(value)} ms`;
+const countsLine = (c) => `${c.error} error(s), ${c.warning} warning(s), ${c.info} info`;
+const findingLines = (f) => {
+    const out = [
+        `- **\`${f.rule}\`** ${f.message}`,
+        `  - Fix: ${f.recommendation}`,
+    ];
+    if (f.selector) {
+        out.push(`  - Where: \`${f.selector}\``);
+    }
+    if (f.evidence && Object.keys(f.evidence).length) {
+        out.push(`  - Evidence: \`${JSON.stringify(f.evidence).slice(0, 400)}\``);
+    }
+    return out;
+};
+const SEVERITY_HEADINGS = {
+    error: "Errors",
+    warning: "Warnings",
+    info: "Info",
+};
+const findingsSection = (findings, heading) => {
+    const lines = [`${heading}# Findings`, ""];
+    if (!findings.length) {
+        lines.push("No issues found.");
+        return lines;
+    }
+    for (const severity of ["error", "warning", "info"]) {
+        const group = findings.filter((f) => f.severity === severity);
+        if (!group.length) {
+            continue;
+        }
+        lines.push(`${heading}## ${SEVERITY_HEADINGS[severity]} (${group.length})`, "");
+        for (const f of group) {
+            lines.push(...findingLines(f));
+        }
+        lines.push("");
+    }
+    return lines;
+};
+const pageMarkdown = (audit, heading = "#") => {
+    const lines = [
+        `${heading} SEO audit: ${audit.url}`,
+        "",
+        `Score **${audit.score}/100** · ${countsLine(audit.counts)}${audit.response?.status ? ` · HTTP ${audit.response.status}` : ""}${audit.response?.timeMs ? ` · ${audit.response.timeMs} ms` : ""}`,
+        "",
+    ];
+    const s = audit.summary;
+    lines.push(`${heading}# Summary`, "", "| Field | Value |", "| --- | --- |", `| Title | ${cell(s.title)} (${s.titleLength} chars) |`, `| Meta description | ${cell(s.metaDescription)} (${s.metaDescriptionLength} chars) |`, `| Canonical | ${cell(s.canonical)} |`, `| Indexable | ${s.indexable ? "yes" : "no"}${s.robots.length ? ` (${s.robots.join(", ")})` : ""} |`, `| Language | ${cell(s.lang)} |`, `| H1 | ${s.h1.length ? s.h1.map(cell).join(" / ") : "—"} |`, `| Words | ${s.wordCount} |`, `| Images | ${s.images.total} (${s.images.missingAlt} without alt) |`, `| Links | ${s.links.internal} internal, ${s.links.external} external |`, `| Structured data | ${s.structuredDataTypes.length ? s.structuredDataTypes.join(", ") : "—"} |`, `| Open Graph | ${Object.keys(s.openGraph).length
+        ? Object.keys(s.openGraph)
+            .map((k) => `og:${k}`)
+            .join(", ")
+        : "—"} |`, "");
+    if (audit.performance) {
+        const m = audit.performance.metrics;
+        lines.push(`${heading}# Lighthouse (${audit.performance.formFactor})`, "", "| Metric | Value |", "| --- | --- |", `| Performance score | ${m.performanceScore ?? "—"} |`, `| SEO score | ${m.seoScore ?? "—"} |`, `| LCP | ${ms(m.lcpMs)} |`, `| CLS | ${m.cls === null ? "—" : m.cls.toFixed(3)} |`, `| TBT | ${ms(m.tbtMs)} |`, `| FCP | ${ms(m.fcpMs)} |`, `| Speed Index | ${ms(m.speedIndexMs)} |`, `| TTFB | ${ms(m.ttfbMs)} |`, "");
+    }
+    if (audit.rendering) {
+        const r = audit.rendering;
+        lines.push(`${heading}# Rendered vs server HTML`, "", "| Field | Server HTML | Rendered DOM |", "| --- | --- | --- |", `| Title | ${cell(r.raw.title)} | ${cell(r.rendered.title)} |`, `| Meta description | ${cell(r.raw.metaDescription)} | ${cell(r.rendered.metaDescription)} |`, `| Canonical | ${cell(r.raw.canonical)} | ${cell(r.rendered.canonical)} |`, `| Robots | ${r.raw.robots.join(", ") || "—"} | ${r.rendered.robots.join(", ") || "—"} |`, `| H1 count | ${r.raw.h1Count} | ${r.rendered.h1Count} |`, `| Words | ${r.raw.wordCount} | ${r.rendered.wordCount} |`, `| Internal links | ${r.raw.internalLinks} | ${r.rendered.internalLinks} |`, `| Structured data items | ${r.raw.structuredDataCount} | ${r.rendered.structuredDataCount} |`, "");
+    }
+    lines.push(...findingsSection(audit.findings, heading));
+    return lines.join("\n");
+};
+const robotsTxtResult = (audit) => {
+    if (!audit.robotsTxt) {
+        return "not checked";
+    }
+    if (audit.robotsTxt.found) {
+        return `found (${audit.robotsTxt.sitemaps.length} sitemap(s) declared)`;
+    }
+    return `not found (HTTP ${audit.robotsTxt.status ?? "n/a"})`;
+};
+const siteMarkdown = (audit) => {
+    const lines = [
+        `# SEO site audit: ${audit.target}`,
+        "",
+        `Score **${audit.score}/100** · ${countsLine(audit.counts)} · ${audit.crawl.pagesCrawled} pages audited, ${audit.crawl.pagesDiscovered} discovered${audit.crawl.hitPageLimit ? ` (page limit ${audit.crawl.maxPages} reached)` : ""} · ${(audit.crawl.durationMs / 1000).toFixed(1)} s`,
+        "",
+        "| Check | Result |",
+        "| --- | --- |",
+        `| robots.txt | ${robotsTxtResult(audit)} |`,
+        `| Sitemaps | ${audit.sitemaps.sources.length ? `${audit.sitemaps.sources.length} file(s), ${audit.sitemaps.urlCount} URLs` : "none found"}${audit.sitemaps.errors.length ? `, ${audit.sitemaps.errors.length} error(s)` : ""} |`,
+        "",
+    ];
+    if (audit.siteFindings.length) {
+        lines.push("## Site-wide findings", "");
+        for (const f of audit.siteFindings) {
+            lines.push(...findingLines(f));
+        }
+        lines.push("");
+    }
+    if (audit.issues.length) {
+        lines.push("## Page issues by rule", "", "| Severity | Rule | Pages | Example |", "| --- | --- | --- | --- |");
+        for (const i of audit.issues) {
+            lines.push(`| ${i.severity} | \`${i.rule}\` | ${i.pages} | ${i.examples[0] ?? ""} |`);
+        }
+        lines.push("");
+    }
+    lines.push("## Pages", "", "| Score | E/W/I | URL | Title |", "| --- | --- | --- | --- |");
+    for (const p of audit.pages) {
+        lines.push(`| ${p.score} | ${p.counts.error}/${p.counts.warning}/${p.counts.info} | ${p.url} | ${cell(p.summary.title)} |`);
+    }
+    lines.push("");
+    const detailed = audit.pages.filter((p) => p.findings.length > 0);
+    if (detailed.length) {
+        lines.push("## Page details", "");
+        for (const p of detailed) {
+            lines.push(`### ${p.url}`, "", `Score ${p.score}/100 · ${countsLine(p.counts)}`, "");
+            for (const f of p.findings) {
+                lines.push(...findingLines(f));
+            }
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+};
+/** One line under every report: which tool and version wrote it, and who makes it. */
+const footer = `_Audited with [agentic-seo-check](${REPOSITORY_URL}) ${VERSION}, made by [${MAKER}](${MAKER_URL})._`;
+export const renderMarkdown = (audit) => {
+    const body = audit.kind === "page" ? pageMarkdown(audit) : siteMarkdown(audit);
+    return `${body.trimEnd()}\n\n---\n\n${footer}\n`;
+};
+//# sourceMappingURL=markdown.js.map

package/dist/core/report/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/core/report/markdown.ts"],"names":[],"mappings":"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"}

package/dist/core/robots.d.ts

@@ -0,0 +1,11 @@
+import type { FetchOptions } from "./fetch.js";
+import type { RobotsTxtInfo } from "./types.js";
+export interface RobotsResult {
+    info: RobotsTxtInfo;
+    /** Returns true when crawling the URL is allowed (unknown/missing robots.txt allows everything). */
+    allows: (url: string) => boolean;
+}
+export declare const buildRobots: (url: string, status: number | null, error: string | undefined, text: string | null, userAgent: string) => RobotsResult;
+export declare const loadRobotsTxt: (origin: string, userAgent: string, options?: FetchOptions) => Promise<RobotsResult>;
+/** Short bot token used for robots.txt matching, derived from the full UA string. */
+export declare const robotsUserAgentToken: (userAgent: string) => string;

package/dist/core/robots.js

@@ -0,0 +1,48 @@
+import { createRequire } from "node:module";
+import { fetchPage } from "./fetch.js";
+// robots-parser is CommonJS; require() avoids ESM default-export interop mismatches.
+// SAFETY: require() returns the package's module.exports, which is the parser function that its
+// index.d.ts declares as the default export.
+const robotsParser = createRequire(import.meta.url)("robots-parser");
+export const buildRobots = (url, status, error, text, userAgent) => {
+    const info = {
+        url,
+        status,
+        found: text !== null,
+        sitemaps: [],
+        text: text ? text.slice(0, 20_000) : null,
+    };
+    if (error) {
+        info.error = error;
+    }
+    if (text === null) {
+        return { info, allows: () => true };
+    }
+    const robot = robotsParser(url, text);
+    info.sitemaps = robot.getSitemaps();
+    return {
+        info,
+        allows: (target) => {
+            const allowed = robot.isAllowed(target, userAgent);
+            return allowed === undefined ? true : allowed;
+        },
+    };
+};
+export const loadRobotsTxt = async (origin, userAgent, options = {}) => {
+    const url = new URL("/robots.txt", origin).href;
+    const res = await fetchPage(url, {
+        ...options,
+        timeoutMs: Math.min(options.timeoutMs ?? 10_000, 10_000),
+    });
+    const found = res.status === 200 &&
+        res.body !== null &&
+        !res.error &&
+        !/<html/iu.test(res.body.slice(0, 500));
+    return buildRobots(url, res.status, res.error, found ? res.body : null, userAgent);
+};
+/** Short bot token used for robots.txt matching, derived from the full UA string. */
+export const robotsUserAgentToken = (userAgent) => {
+    const match = /agentic-seo-check|Googlebot|bingbot/iu.exec(userAgent);
+    return match ? match[0] : userAgent;
+};
+//# sourceMappingURL=robots.js.map

package/dist/core/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../../src/core/robots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC,qFAAqF;AACrF,gGAAgG;AAChG,6CAA6C;AAC7C,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CACjD,eAAe,CAC0B,CAAC;AAQ5C,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,GAAW,EACX,MAAqB,EACrB,KAAyB,EACzB,IAAmB,EACnB,SAAiB,EACH,EAAE;IAChB,MAAM,IAAI,GAAkB;QAC1B,GAAG;QACH,MAAM;QACN,KAAK,EAAE,IAAI,KAAK,IAAI;QACpB,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;KAC1C,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEpC,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,CAAC,MAAc,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAEnD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,MAAc,EACd,SAAiB,EACjB,OAAO,GAAiB,EAAE,EACH,EAAE;IACzB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC;IAEhD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;QAC/B,GAAG,OAAO;QACV,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,MAAM,CAAC;KACzD,CAAC,CAAC;IAEH,MAAM,KAAK,GACT,GAAG,CAAC,MAAM,KAAK,GAAG;QAClB,GAAG,CAAC,IAAI,KAAK,IAAI;QACjB,CAAC,GAAG,CAAC,KAAK;QACV,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAE1C,OAAO,WAAW,CAChB,GAAG,EACH,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,KAAK,EACT,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EACvB,SAAS,CACV,CAAC;AACJ,CAAC,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAiB,EAAU,EAAE;IAChE,MAAM,KAAK,GAAG,uCAAuC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC,CAAC"}

package/dist/core/rules/canonical.d.ts

@@ -0,0 +1,2 @@
+export declare const isLocalHost: (url: string) => boolean;
+export declare const canonicalRules: import("./rule.js").Rule[];

package/dist/core/rules/canonical.js

@@ -0,0 +1,141 @@
+import { hostOf, normalizeUrl, samePath } from "../url.js";
+import { cap, defineRule, GOOGLE_DOCS } from "./rule.js";
+const SELECTOR = 'head > link[rel="canonical"]';
+const LOCAL_HOSTS = new Set([
+    "localhost",
+    "127.0.0.1",
+    "0.0.0.0",
+    "::1",
+    "[::1]",
+]);
+export const isLocalHost = (url) => {
+    const host = hostOf(url);
+    if (!host) {
+        return false;
+    }
+    return (LOCAL_HOSTS.has(host) ||
+        host.endsWith(".local") ||
+        host.endsWith(".localhost") ||
+        host.endsWith(".test"));
+};
+const stripTrailingSlash = (url) => url.endsWith("/") && new URL(url).pathname !== "/" ? url.slice(0, -1) : url;
+export const canonicalRules = [
+    defineRule({
+        id: "canonical.missing",
+        category: "canonical",
+        severity: "warning",
+        description: 'No <link rel="canonical"> is present.',
+        recommendation: "Add a self-referencing canonical with the absolute preferred URL (scheme, host, trailing slash) so duplicate URLs (query strings, www/non-www) consolidate to it.",
+        docs: GOOGLE_DOCS.canonical,
+    }, ({ page }, make) => page.canonicals.length === 0
+        ? make("Page has no canonical link.", { selector: SELECTOR })
+        : null),
+    defineRule({
+        id: "canonical.multiple",
+        category: "canonical",
+        severity: "error",
+        description: "More than one canonical link is present. When they disagree, search engines ignore all of them.",
+        recommendation: "Emit exactly one canonical link per page. Check for a framework default plus a hand-written one.",
+        docs: GOOGLE_DOCS.canonical,
+    }, ({ page }, make) => {
+        if (page.canonicals.length <= 1) {
+            return null;
+        }
+        const distinct = new Set(page.canonicals.map((c) => c.trim()));
+        return make(`Page has ${page.canonicals.length} canonical links${distinct.size > 1 ? " with different targets" : " (identical)"}.`, {
+            selector: SELECTOR,
+            severity: distinct.size > 1 ? "error" : "warning",
+            evidence: { canonicals: cap(page.canonicals) },
+        });
+    }),
+    defineRule({
+        id: "canonical.invalid",
+        category: "canonical",
+        severity: "error",
+        description: "The canonical href is empty or cannot be resolved to an http(s) URL.",
+        recommendation: "Set the canonical href to a valid absolute URL such as https://www.example.com/path/.",
+        docs: GOOGLE_DOCS.canonical,
+    }, ({ page }, make) => {
+        const [first] = page.canonicals;
+        if (first === undefined) {
+            return null;
+        }
+        return page.canonical
+            ? null
+            : make(`Canonical href "${first}" is not a valid URL.`, {
+                selector: SELECTOR,
+                evidence: { href: first },
+            });
+    }),
+    defineRule({
+        id: "canonical.relative",
+        category: "canonical",
+        severity: "warning",
+        description: "The canonical href is a relative URL.",
+        recommendation: "Use an absolute URL in the canonical link. Relative canonicals are error-prone and some crawlers resolve them unexpectedly.",
+        docs: GOOGLE_DOCS.canonical,
+    }, ({ page }, make) => {
+        const [first] = page.canonicals;
+        if (!first || !page.canonical) {
+            return null;
+        }
+        return /^https?:\/\//iu.test(first)
+            ? null
+            : make(`Canonical href "${first}" is relative.`, {
+                selector: SELECTOR,
+                evidence: { href: first, resolved: page.canonical },
+            });
+    }),
+    defineRule({
+        id: "canonical.protocol-mismatch",
+        category: "canonical",
+        severity: "warning",
+        description: "The page is served over https but the canonical points to http.",
+        recommendation: "Point the canonical at the https URL.",
+        docs: GOOGLE_DOCS.canonical,
+    }, ({ page, source }, make) => {
+        if (source !== "url" || !page.canonical) {
+            return null;
+        }
+        return page.url.startsWith("https://") &&
+            page.canonical.startsWith("http://")
+            ? make("Canonical uses http:// while the page is served over https://.", {
+                selector: SELECTOR,
+                evidence: { canonical: page.canonical, page: page.url },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "canonical.other-page",
+        category: "canonical",
+        severity: "info",
+        description: "The canonical points to a different URL, so search engines will treat this page as a duplicate of that URL.",
+        recommendation: "If this page should rank on its own, make the canonical self-referencing. If it is intentionally a duplicate (print view, filtered list, tracking URL), this is correct.",
+        docs: GOOGLE_DOCS.canonical,
+    }, ({ page, source }, make) => {
+        if (!page.canonical) {
+            return null;
+        }
+        const pageUrl = normalizeUrl(page.url);
+        const canon = normalizeUrl(page.canonical);
+        if (!pageUrl || !canon) {
+            return null;
+        }
+        // For files and local dev servers the host is synthetic; compare paths only.
+        const pathOnly = source !== "url" || isLocalHost(page.url);
+        const same = pathOnly
+            ? samePath(pageUrl, canon)
+            : stripTrailingSlash(pageUrl) === stripTrailingSlash(canon);
+        return same
+            ? null
+            : make(`Canonical points to ${page.canonical}, not to this page.`, {
+                selector: SELECTOR,
+                evidence: {
+                    canonical: page.canonical,
+                    page: page.url,
+                    comparedBy: pathOnly ? "path" : "url",
+                },
+            });
+    }),
+];
+//# sourceMappingURL=canonical.js.map

package/dist/core/rules/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../../src/core/rules/canonical.ts"],"names":[],"mappings":"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"}

package/dist/core/rules/content.d.ts

@@ -0,0 +1 @@
+export declare const contentRules: import("./rule.js").Rule[];

package/dist/core/rules/content.js

@@ -0,0 +1,55 @@
+import { fleschReadingEase, hasPlaceholderText } from "../html/text.js";
+import { defineRule, GOOGLE_DOCS } from "./rule.js";
+export const contentRules = [
+    defineRule({
+        id: "content.empty",
+        category: "content",
+        severity: "warning",
+        description: "The HTML contains no visible text.",
+        recommendation: "If the page is rendered client-side, use server-side rendering or static generation so the HTML carries the content. Re-run with render enabled to compare the rendered DOM.",
+        docs: GOOGLE_DOCS.javascript,
+    }, ({ page }, make) => page.wordCount === 0
+        ? make("Page body has no visible text in the HTML response.")
+        : null),
+    defineRule({
+        id: "content.thin",
+        category: "content",
+        severity: "warning",
+        description: "The page has very little text (default: fewer than 300 words).",
+        recommendation: "Add substantive, useful content, or set noindex if the page is a utility page (login, cart, thank-you). Thin pages rarely rank and can drag down site quality signals.",
+    }, ({ page, thresholds }, make) => page.wordCount > 0 && page.wordCount < thresholds.thinContentWords
+        ? make(`Page has only ${page.wordCount} words of visible text (threshold ${thresholds.thinContentWords}).`, {
+            evidence: {
+                wordCount: page.wordCount,
+                threshold: thresholds.thinContentWords,
+            },
+        })
+        : null),
+    defineRule({
+        id: "content.placeholder-text",
+        category: "content",
+        severity: "error",
+        description: 'Placeholder text ("lorem ipsum") is present in the page.',
+        recommendation: "Replace the placeholder copy with real content before publishing.",
+    }, ({ page }, make) => hasPlaceholderText(page.text)
+        ? make('Page contains "lorem ipsum" placeholder text.')
+        : null),
+    defineRule({
+        id: "content.readability-low",
+        category: "content",
+        severity: "info",
+        description: "Flesch Reading Ease below 30 (very difficult). Only evaluated for English or unspecified language, 100+ words.",
+        recommendation: "Shorten sentences and prefer common words. Aim for a Flesch score of 50-70 for general audiences.",
+    }, ({ page }, make) => {
+        if (page.lang && !page.lang.toLowerCase().startsWith("en")) {
+            return null;
+        }
+        const score = fleschReadingEase(page.text);
+        return score !== null && score < 30
+            ? make(`Flesch Reading Ease is ${score} (very difficult).`, {
+                evidence: { fleschReadingEase: score, wordCount: page.wordCount },
+            })
+            : null;
+    }),
+];
+//# sourceMappingURL=content.js.map

package/dist/core/rules/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/core/rules/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,CACR;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,oCAAoC;QACjD,cAAc,EACZ,8KAA8K;QAChL,IAAI,EAAE,WAAW,CAAC,UAAU;KAC7B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CACjB,IAAI,CAAC,SAAS,KAAK,CAAC;QAClB,CAAC,CAAC,IAAI,CAAC,qDAAqD,CAAC;QAC7D,CAAC,CAAC,IAAI,CACX;IACD,UAAU,CACR;QACE,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,WAAW,EACT,gEAAgE;QAClE,cAAc,EACZ,wKAAwK;KAC3K,EACD,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,gBAAgB;QAChE,CAAC,CAAC,IAAI,CACF,iBAAiB,IAAI,CAAC,SAAS,qCAAqC,UAAU,CAAC,gBAAgB,IAAI,EACnG;YACE,QAAQ,EAAE;gBACR,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,UAAU,CAAC,gBAAgB;aACvC;SACF,CACF;QACH,CAAC,CAAC,IAAI,CACX;IACD,UAAU,CACR;QACE,EAAE,EAAE,0BAA0B;QAC9B,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,0DAA0D;QACvE,cAAc,EACZ,mEAAmE;KACtE,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CACjB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3B,CAAC,CAAC,IAAI,CAAC,+CAA+C,CAAC;QACvD,CAAC,CAAC,IAAI,CACX;IACD,UAAU,CACR;QACE,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,MAAM;QAChB,WAAW,EACT,gHAAgH;QAClH,cAAc,EACZ,mGAAmG;KACtG,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE;QACjB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,EAAE;YACjC,CAAC,CAAC,IAAI,CAAC,0BAA0B,KAAK,oBAAoB,EAAE;gBACxD,QAAQ,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;aAClE,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC;IACX,CAAC,CACF;CACF,CAAC"}

package/dist/core/rules/document.d.ts

@@ -0,0 +1 @@
+export declare const documentRules: import("./rule.js").Rule[];

package/dist/core/rules/document.js

@@ -0,0 +1,83 @@
+import { defineRule, GOOGLE_DOCS } from "./rule.js";
+const BCP47 = /^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8})*$/u;
+export const documentRules = [
+    defineRule({
+        id: "html.lang-missing",
+        category: "document",
+        severity: "warning",
+        description: "The <html> element has no lang attribute.",
+        recommendation: 'Set <html lang="xx"> (for example "en", "nl", "en-GB") so search engines and screen readers know the content language.',
+    }, ({ page }, make) => page.lang
+        ? null
+        : make("<html> has no lang attribute.", { selector: "html" })),
+    defineRule({
+        id: "html.lang-invalid",
+        category: "document",
+        severity: "warning",
+        description: "The <html lang> value is not a valid BCP 47 language tag.",
+        recommendation: 'Use a BCP 47 tag such as "en", "en-US" or "pt-BR".',
+    }, ({ page }, make) => page.lang && !BCP47.test(page.lang)
+        ? make(`<html lang="${page.lang}"> is not a valid language tag.`, {
+            selector: "html",
+            evidence: { lang: page.lang },
+        })
+        : null),
+    defineRule({
+        id: "viewport.missing",
+        category: "document",
+        severity: "warning",
+        description: 'No <meta name="viewport"> is present, so the page is not mobile-friendly.',
+        recommendation: 'Add <meta name="viewport" content="width=device-width, initial-scale=1"> to <head>. Google indexes the mobile version of pages first.',
+        docs: GOOGLE_DOCS.mobile,
+    }, ({ page }, make) => page.viewport
+        ? null
+        : make("Page has no viewport meta tag.", {
+            selector: 'head > meta[name="viewport"]',
+        })),
+    defineRule({
+        id: "viewport.not-scalable",
+        category: "document",
+        severity: "info",
+        description: "The viewport disables user zoom (user-scalable=no or maximum-scale=1).",
+        recommendation: "Remove user-scalable=no and maximum-scale limits; blocking zoom is an accessibility problem flagged by Lighthouse.",
+    }, ({ page }, make) => {
+        const v = (page.viewport ?? "").toLowerCase().replaceAll(/\s/gu, "");
+        return /user-scalable=(?:no|0)/u.test(v) ||
+            /maximum-scale=1(?:\.0*)?(?:,|$)/u.test(v)
+            ? make("Viewport prevents users from zooming.", {
+                selector: 'head > meta[name="viewport"]',
+                evidence: { viewport: page.viewport },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "charset.missing",
+        category: "document",
+        severity: "info",
+        description: "No character encoding is declared.",
+        recommendation: 'Add <meta charset="utf-8"> as the first element in <head>.',
+    }, ({ page }, make) => page.charset
+        ? null
+        : make("No <meta charset> declaration found.", {
+            selector: "head > meta[charset]",
+        })),
+    defineRule({
+        id: "doctype.missing",
+        category: "document",
+        severity: "info",
+        description: "The document does not start with <!DOCTYPE html>.",
+        recommendation: "Start the document with <!DOCTYPE html> to avoid quirks-mode rendering.",
+    }, ({ page }, make) => page.hasDoctype ? null : make("Document has no HTML5 doctype.")),
+    defineRule({
+        id: "document.html-too-large",
+        category: "document",
+        severity: "info",
+        description: "The HTML document is larger than 1.5 MB.",
+        recommendation: "Reduce inline scripts/styles/data (large JSON state, inline SVG sprites). Very large documents slow parsing and may be truncated by crawlers.",
+    }, ({ page }, make) => page.htmlBytes > 1_500_000
+        ? make(`HTML is ${(page.htmlBytes / 1_000_000).toFixed(1)} MB.`, {
+            evidence: { bytes: page.htmlBytes },
+        })
+        : null),
+];
+//# sourceMappingURL=document.js.map

package/dist/core/rules/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/core/rules/document.ts"],"names":[],"mappings":"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"}

package/dist/core/rules/headings.d.ts

@@ -0,0 +1 @@
+export declare const headingRules: import("./rule.js").Rule[];