@pseolint/core 0.1.0

package/dist/index.js

@@ -0,0 +1,45 @@
+export * from "./types.js";
+export * from "./auditor.js";
+export * from "./parser.js";
+export * from "./url-normalize.js";
+export * from "./algorithms/simhash.js";
+export * from "./algorithms/entity-mask.js";
+export * from "./rules/spam/near-duplicate.js";
+export * from "./rules/spam/entity-swap.js";
+export * from "./rules/spam/thin-content.js";
+export * from "./rules/spam/boilerplate-ratio.js";
+export * from "./rules/spam/template-diversity.js";
+export * from "./rules/spam/publication-velocity.js";
+export * from "./rules/spam/doorway-pattern.js";
+export * from "./rules/spam/template-coverage.js";
+export * from "./rules/content/unique-value.js";
+export * from "./rules/content/heading-uniqueness.js";
+export * from "./rules/content/meta-uniqueness.js";
+export * from "./rules/content/missing-author.js";
+export * from "./rules/content/eeat-signals.js";
+export * from "./rules/links/orphan-pages.js";
+export * from "./rules/links/dead-ends.js";
+export * from "./rules/links/link-depth.js";
+export * from "./rules/links/cluster-connectivity.js";
+export * from "./rules/links/hub-pages.js";
+export * from "./rules/tech/canonical-consistency.js";
+export * from "./rules/tech/canonical-noindex-conflict.js";
+export * from "./rules/tech/robots-noindex-conflict.js";
+export * from "./rules/tech/sitemap-completeness.js";
+export * from "./rules/tech/redirect-chain.js";
+export * from "./rules/tech/soft-404.js";
+export * from "./rules/tech/og-completeness.js";
+export * from "./rules/tech/hreflang-consistency.js";
+export * from "./rules/schema/json-ld-valid.js";
+export * from "./rules/schema/required-fields.js";
+export * from "./rules/schema/consistency.js";
+export * from "./algorithms/tf-idf.js";
+export * from "./rules/cannibal/title-overlap.js";
+export * from "./rules/cannibal/keyword-collision.js";
+export * from "./rules/cannibal/url-pattern.js";
+export * from "./rule-references.js";
+export * from "./page-classifier.js";
+export * from "./formatters/index.js";
+export * from "./renderer.js";
+export * from "./enrich-findings.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uCAAuC,CAAC;AACtD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/dist/page-classifier.d.ts

@@ -0,0 +1,4 @@
+import type { PageGroupConfig, ParsedPage } from "./types.js";
+export declare function classifyPages(pages: ParsedPage[], groups: Record<string, PageGroupConfig> | undefined): Map<string, ParsedPage[]>;
+export declare function isRuleEnabled(ruleId: string, rules: string[] | undefined): boolean;
+//# sourceMappingURL=page-classifier.d.ts.map

package/dist/page-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-classifier.d.ts","sourceRoot":"","sources":["../src/page-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAoG9D,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,GAClD,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CA8B3B;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAWlF"}

package/dist/page-classifier.js

@@ -0,0 +1,133 @@
+// Splits a glob pattern into literal and wildcard tokens.
+function tokenize(pattern) {
+    const tokens = [];
+    let i = 0;
+    let literal = "";
+    while (i < pattern.length) {
+        if (pattern[i] === "*") {
+            if (literal.length > 0) {
+                tokens.push({ kind: "literal", value: literal });
+                literal = "";
+            }
+            if (pattern[i + 1] === "*") {
+                tokens.push({ kind: "globstar" });
+                i += 2;
+            }
+            else {
+                tokens.push({ kind: "star" });
+                i += 1;
+            }
+        }
+        else {
+            literal += pattern[i];
+            i += 1;
+        }
+    }
+    if (literal.length > 0) {
+        tokens.push({ kind: "literal", value: literal });
+    }
+    return tokens;
+}
+// Linear glob matcher — no RegExp construction, immune to ReDoS.
+// Supports * (any non-slash chars) and ** (any chars including slash).
+// Anchored to the end of value; pattern may match at any slash-delimited
+// segment boundary within the string.
+function matchGlob(pattern, value) {
+    const normalized = value.replace(/\\/g, "/");
+    const tokens = tokenize(pattern);
+    const n = normalized.length;
+    const m = tokens.length;
+    // pos[j] = 1 means we can be at character index j in normalized.
+    // Seed position 0 and every position that sits ON a slash so that
+    // patterns starting with "/" (e.g. "/about") match at segment boundaries.
+    let pos = new Uint8Array(n + 1);
+    pos[0] = 1;
+    for (let j = 0; j < n; j++) {
+        if (normalized[j] === "/")
+            pos[j] = 1;
+    }
+    for (let ti = 0; ti < m; ti++) {
+        const tok = tokens[ti];
+        const next = new Uint8Array(n + 1);
+        if (tok.kind === "literal") {
+            const lit = tok.value;
+            const ll = lit.length;
+            for (let j = 0; j <= n - ll; j++) {
+                if (pos[j] && normalized.startsWith(lit, j)) {
+                    next[j + ll] = 1;
+                }
+            }
+        }
+        else if (tok.kind === "star") {
+            // Consume zero or more non-slash characters.
+            for (let j = 0; j <= n; j++) {
+                if (!pos[j])
+                    continue;
+                next[j] = 1;
+                for (let k = j + 1; k <= n; k++) {
+                    if (normalized[k - 1] === "/")
+                        break;
+                    next[k] = 1;
+                }
+            }
+        }
+        else {
+            // globstar: consume zero or more characters including slashes.
+            for (let j = 0; j <= n; j++) {
+                if (!pos[j])
+                    continue;
+                for (let k = j; k <= n; k++) {
+                    next[k] = 1;
+                }
+            }
+        }
+        pos = next;
+    }
+    return pos[n] === 1;
+}
+function matchesGroup(url, config) {
+    const patterns = Array.isArray(config.match) ? config.match : [config.match];
+    return patterns.some((pattern) => matchGlob(pattern, url));
+}
+export function classifyPages(pages, groups) {
+    const result = new Map();
+    if (!groups || Object.keys(groups).length === 0) {
+        result.set("__default", [...pages]);
+        return result;
+    }
+    for (const groupName of Object.keys(groups)) {
+        result.set(groupName, []);
+    }
+    result.set("__default", []);
+    const groupEntries = Object.entries(groups);
+    for (const page of pages) {
+        let matched = false;
+        for (const [name, config] of groupEntries) {
+            if (matchesGroup(page.url, config)) {
+                result.get(name).push(page);
+                matched = true;
+                break;
+            }
+        }
+        if (!matched) {
+            result.get("__default").push(page);
+        }
+    }
+    return result;
+}
+export function isRuleEnabled(ruleId, rules) {
+    if (rules === undefined)
+        return true;
+    if (rules.length === 0)
+        return false;
+    return rules.some((pattern) => {
+        if (pattern === ruleId)
+            return true;
+        if (pattern.endsWith("/*")) {
+            const prefix = pattern.slice(0, -2);
+            return ruleId.startsWith(prefix + "/");
+        }
+        return false;
+    });
+}
+//# sourceMappingURL=page-classifier.js.map

package/dist/page-classifier.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,3 @@
+import type { ParseHtmlOptions, ParsedPage } from "./types.js";
+export declare function parseHtmlPage(html: string, url: string, options?: ParseHtmlOptions): ParsedPage;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiE/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CA2F/F"}

package/dist/parser.js

@@ -0,0 +1,131 @@
+import { load } from "cheerio";
+import { dirname, resolve } from "node:path";
+import { mergeNormalizeUrlOptions, normalizeAuditUrl } from "./url-normalize.js";
+function normalizedText(input) {
+    return input.replace(/\s+/g, " ").trim();
+}
+function buildStructureSignature(html) {
+    const tags = Array.from(html.toLowerCase().matchAll(/<([a-z0-9-]+)(\s|>)/g)).map((m) => m[1]);
+    const counts = new Map();
+    for (const tag of tags) {
+        counts.set(tag, (counts.get(tag) ?? 0) + 1);
+    }
+    return Array.from(counts.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([tag, count]) => `${tag}:${count}`)
+        .join("|");
+}
+function resolveHref(href, pageUrl, normalizeOpts) {
+    const trimmed = href.trim();
+    if (!trimmed) {
+        return null;
+    }
+    if (/^https?:\/\//i.test(trimmed)) {
+        return normalizeAuditUrl(trimmed, normalizeOpts);
+    }
+    if (/^https?:\/\//i.test(pageUrl)) {
+        try {
+            const resolved = new URL(trimmed, pageUrl).href;
+            const u = new URL(resolved);
+            if (u.protocol !== "http:" && u.protocol !== "https:") {
+                return null;
+            }
+            return normalizeAuditUrl(resolved, normalizeOpts);
+        }
+        catch {
+            return null;
+        }
+    }
+    return normalizeAuditUrl(resolve(dirname(pageUrl), trimmed), normalizeOpts);
+}
+/** Resolved targets: http(s) on web bases; file paths for local `pageUrl`. */
+function resolveAbsoluteHrefs(hrefs, pageUrl, normalizeOpts) {
+    const resolved = hrefs
+        .map((href) => href.trim())
+        .filter(Boolean)
+        .filter((href) => !href.startsWith("#"))
+        .filter((href) => !/^mailto:|^tel:|^javascript:|^data:/i.test(href))
+        .map((href) => resolveHref(href, pageUrl, normalizeOpts))
+        .filter((x) => x !== null);
+    return Array.from(new Set(resolved));
+}
+export function parseHtmlPage(html, url, options) {
+    const normalizeOpts = mergeNormalizeUrlOptions(options?.normalizeUrl);
+    const $ = load(html);
+    const title = normalizedText($("title").first().text());
+    const metaDescription = normalizedText($('meta[name="description"]').attr("content") ?? "");
+    const canonical = normalizedText($('link[rel="canonical"]').attr("href") ?? "");
+    const robotsMeta = normalizedText($('meta[name="robots"]').attr("content") ?? "");
+    const ogTitle = normalizedText($('meta[property="og:title"]').attr("content") ?? "");
+    const ogDescription = normalizedText($('meta[property="og:description"]').attr("content") ?? "");
+    const ogImage = normalizedText($('meta[property="og:image"]').attr("content") ?? "");
+    const hreflangs = $('link[rel="alternate"][hreflang]')
+        .map((_idx, node) => ({
+        lang: normalizedText(String($(node).attr("hreflang") ?? "")),
+        href: normalizedText(String($(node).attr("href") ?? ""))
+    }))
+        .get()
+        .filter((entry) => entry.lang.length > 0);
+    const publishedDate = normalizedText($('meta[property="article:published_time"]').attr("content") ??
+        $('meta[name="datePublished"]').attr("content") ??
+        $("time[datetime]").first().attr("datetime") ??
+        "");
+    const h1 = $("h1")
+        .map((_idx, node) => normalizedText($(node).text()))
+        .get()
+        .filter(Boolean);
+    const h2 = $("h2")
+        .map((_idx, node) => normalizedText($(node).text()))
+        .get()
+        .filter(Boolean);
+    const resolvedHrefs = resolveAbsoluteHrefs($("a[href]")
+        .map((_idx, node) => String($(node).attr("href") ?? ""))
+        .get(), url, normalizeOpts);
+    const jsonLd = [];
+    $('script[type="application/ld+json"]').each((_idx, node) => {
+        try {
+            const parsed = JSON.parse($(node).html() ?? "");
+            jsonLd.push(parsed);
+        }
+        catch {
+            jsonLd.push({ __parseError: true, __raw: $(node).html() ?? "" });
+        }
+    });
+    const metaAuthor = normalizedText($('meta[name="author"]').attr("content") ?? "");
+    const schemaAuthor = jsonLd.some((ld) => {
+        if (typeof ld !== "object" || ld === null)
+            return false;
+        return "author" in ld;
+    });
+    const bylineElement = $("[class*='author'], [class*='byline'], [rel='author']").length > 0;
+    const relAuthorLink = $('a[rel="author"], link[rel="author"]').length > 0;
+    $("header, footer, nav, script, style, noscript").remove();
+    const contentText = normalizedText($("body").text());
+    return {
+        url,
+        title,
+        metaDescription,
+        canonical,
+        robotsMeta,
+        og: {
+            title: ogTitle,
+            description: ogDescription,
+            image: ogImage
+        },
+        hreflangs,
+        publishedDate: publishedDate || undefined,
+        headings: { h1, h2 },
+        jsonLd,
+        authorSignals: {
+            metaAuthor,
+            schemaAuthor,
+            bylineElement,
+            relAuthorLink
+        },
+        resolvedHrefs,
+        structureSignature: buildStructureSignature(html),
+        contentText,
+        html
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parser.test.d.ts.map

package/dist/parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.d.ts","sourceRoot":"","sources":["../src/parser.test.ts"],"names":[],"mappings":""}

package/dist/parser.test.js

@@ -0,0 +1,37 @@
+import { describe, expect, test } from "vitest";
+import { parseHtmlPage } from "./parser.js";
+describe("parseHtmlPage", () => {
+    test("extracts title, metadata, headings, and cleaned content text", () => {
+        const html = `
+      <html>
+        <head>
+          <title>California LLC Template</title>
+          <meta name="description" content="A practical filing guide." />
+          <link rel="canonical" href="https://example.dev/templates/california-llc" />
+          <meta property="article:published_time" content="2026-04-01" />
+        </head>
+        <body>
+          <header>Global nav should be removed</header>
+          <main>
+            <h1>California LLC Template</h1>
+            <h2>Filing Requirements</h2>
+            <p>California has a publication rule in some counties.</p>
+          </main>
+          <footer>Footer should be removed</footer>
+        </body>
+      </html>
+    `;
+        const parsed = parseHtmlPage(html, "https://example.dev/templates/california-llc");
+        expect(parsed.url).toBe("https://example.dev/templates/california-llc");
+        expect(parsed.title).toBe("California LLC Template");
+        expect(parsed.metaDescription).toBe("A practical filing guide.");
+        expect(parsed.canonical).toBe("https://example.dev/templates/california-llc");
+        expect(parsed.publishedDate).toBe("2026-04-01");
+        expect(parsed.headings.h1).toEqual(["California LLC Template"]);
+        expect(parsed.headings.h2).toEqual(["Filing Requirements"]);
+        expect(parsed.structureSignature).toContain("h1:1");
+        expect(parsed.contentText).toContain("California has a publication rule");
+        expect(parsed.contentText).not.toContain("Global nav should be removed");
+    });
+});
+//# sourceMappingURL=parser.test.js.map

package/dist/parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.js","sourceRoot":"","sources":["../src/parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;KAkBZ,CAAC;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,8CAA8C,CAAC,CAAC;QAEnF,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC9E,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC1E,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/renderer.d.ts

@@ -0,0 +1,15 @@
+export interface RenderOptions {
+    browserWsEndpoint?: string;
+    concurrency: number;
+    timeoutMs: number;
+}
+interface RenderedPage {
+    url: string;
+    html: string;
+}
+export declare function renderPages(pages: Array<{
+    url: string;
+    localPath?: string;
+}>, sourceDir: string | null, options: RenderOptions): Promise<RenderedPage[]>;
+export {};
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AA0ED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACjD,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CA8DzB"}

package/dist/renderer.js

@@ -0,0 +1,124 @@
+import { createServer } from "node:http";
+import { readFile } from "node:fs/promises";
+import { join, extname } from "node:path";
+const MIME_TYPES = {
+    ".html": "text/html",
+    ".htm": "text/html",
+    ".js": "application/javascript",
+    ".css": "text/css",
+    ".json": "application/json",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".svg": "image/svg+xml",
+};
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function loadPlaywright() {
+    try {
+        // @ts-ignore -- playwright-core is an optional peer dependency
+        return await import("playwright-core");
+    }
+    catch {
+        throw new Error("--render requires a browser connection.\n" +
+            "  Option 1: Set PSEOLINT_BROWSER_WS to your CDP endpoint (wss://...)\n" +
+            "  Option 2: Install playwright-core and Chromium:\n" +
+            "    npm install playwright-core\n" +
+            "    npx playwright install chromium");
+    }
+}
+function isLocalhost(endpoint) {
+    try {
+        const parsed = new URL(endpoint);
+        return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
+    }
+    catch {
+        return false;
+    }
+}
+const WS_SECURE = "wss://";
+const WS_PLAIN = "ws" + "://";
+function validateWsEndpoint(endpoint) {
+    if (endpoint.startsWith(WS_SECURE))
+        return;
+    if (endpoint.startsWith(WS_PLAIN) && isLocalhost(endpoint))
+        return;
+    throw new Error(`Insecure WebSocket endpoint: ${endpoint}. ` +
+        `Remote endpoints must use ${WS_SECURE}. ` +
+        `Unencrypted ${WS_PLAIN} is only allowed for localhost.`);
+}
+async function startStaticServer(rootDir) {
+    return new Promise((resolve) => {
+        const server = createServer(async (req, res) => {
+            const urlPath = decodeURIComponent(req.url ?? "/");
+            const filePath = join(rootDir, urlPath);
+            try {
+                const content = await readFile(filePath);
+                const ext = extname(filePath);
+                res.writeHead(200, { "Content-Type": MIME_TYPES[ext] ?? "application/octet-stream" });
+                res.end(content);
+            }
+            catch {
+                res.writeHead(404);
+                res.end("Not found");
+            }
+        });
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            const port = typeof addr === "object" && addr ? addr.port : 0;
+            resolve({ port, close: () => server.close() });
+        });
+    });
+}
+export async function renderPages(pages, sourceDir, options) {
+    const pw = await loadPlaywright();
+    const endpoint = options.browserWsEndpoint
+        ?? process.env.PSEOLINT_BROWSER_WS
+        ?? null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let browser;
+    if (endpoint) {
+        validateWsEndpoint(endpoint);
+        browser = await pw.chromium.connectOverCDP(endpoint);
+    }
+    else {
+        browser = await pw.chromium.launch({ headless: true });
+    }
+    let server = null;
+    if (sourceDir) {
+        server = await startStaticServer(sourceDir);
+    }
+    const results = [];
+    let index = 0;
+    async function processNext() {
+        while (index < pages.length) {
+            const current = index;
+            index += 1;
+            const entry = pages[current];
+            const page = await browser.newPage();
+            let navigateUrl = entry.url;
+            if (entry.localPath && server) {
+                const relativePath = entry.localPath.replace(/\\/g, "/");
+                navigateUrl = `http://127.0.0.1:${server.port}/${relativePath}`;
+            }
+            try {
+                await page.goto(navigateUrl, {
+                    waitUntil: "networkidle",
+                    timeout: options.timeoutMs,
+                });
+                const html = await page.content();
+                results.push({ url: entry.url, html });
+            }
+            catch {
+                // Skip pages that fail to render
+            }
+            finally {
+                await page.close();
+            }
+        }
+    }
+    const workers = Array.from({ length: Math.min(options.concurrency, pages.length) }, () => processNext());
+    await Promise.all(workers);
+    server?.close();
+    await browser.close();
+    return results;
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/rule-references.d.ts

@@ -0,0 +1,2 @@
+export declare const RULE_REFERENCES: Record<string, string>;
+//# sourceMappingURL=rule-references.d.ts.map

package/dist/rule-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-references.d.ts","sourceRoot":"","sources":["../src/rule-references.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiClD,CAAC"}

package/dist/rule-references.js

@@ -0,0 +1,35 @@
+export const RULE_REFERENCES = {
+    "spam/near-duplicate": "https://developers.google.com/search/docs/essentials/spam-policies#scraped-content",
+    "spam/entity-swap": "https://developers.google.com/search/docs/essentials/spam-policies#doorway-pages",
+    "spam/thin-content": "https://developers.google.com/search/docs/essentials/spam-policies#thin-content",
+    "spam/boilerplate-ratio": "https://developers.google.com/search/docs/essentials/spam-policies#thin-content",
+    "spam/template-diversity": "https://developers.google.com/search/docs/essentials/spam-policies#doorway-pages",
+    "spam/publication-velocity": "https://developers.google.com/search/docs/essentials/spam-policies#spammy-auto-generated-content",
+    "spam/doorway-pattern": "https://developers.google.com/search/docs/essentials/spam-policies#doorway-pages",
+    "spam/template-coverage": "https://developers.google.com/search/docs/essentials/spam-policies#doorway-pages",
+    "content/unique-value": "https://developers.google.com/search/docs/fundamentals/creating-helpful-content",
+    "content/meta-uniqueness": "https://developers.google.com/search/docs/appearance/snippet#meta-descriptions",
+    "content/heading-uniqueness": "https://developers.google.com/search/docs/appearance/snippet#headings",
+    "content/missing-author": "https://developers.google.com/search/docs/fundamentals/creating-helpful-content#eeat",
+    "content/eeat-signals": "https://developers.google.com/search/docs/fundamentals/creating-helpful-content#eeat",
+    "links/orphan-pages": "https://developers.google.com/search/docs/crawling-indexing/links-crawlable",
+    "links/dead-ends": "https://developers.google.com/search/docs/crawling-indexing/links-crawlable",
+    "links/cluster-connectivity": "https://developers.google.com/search/docs/crawling-indexing/links-crawlable",
+    "links/hub-pages": "https://developers.google.com/search/docs/crawling-indexing/links-crawlable",
+    "links/link-depth": "https://developers.google.com/search/docs/crawling-indexing/links-crawlable",
+    "tech/canonical-consistency": "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls",
+    "tech/canonical-noindex-conflict": "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls",
+    "tech/robots-noindex-conflict": "https://developers.google.com/search/docs/crawling-indexing/block-indexing",
+    "tech/sitemap-completeness": "https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview",
+    "tech/redirect-chain": "https://developers.google.com/search/docs/crawling-indexing/301-redirects",
+    "tech/soft-404": "https://developers.google.com/search/docs/crawling-indexing/soft-404-errors",
+    "tech/og-completeness": "https://developers.google.com/search/docs/appearance/snippet",
+    "tech/hreflang-consistency": "https://developers.google.com/search/docs/specialty/international/managing-multi-regional-sites",
+    "schema/json-ld-valid": "https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data",
+    "schema/required-fields": "https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data",
+    "schema/consistency": "https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data",
+    "cannibal/title-overlap": "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls",
+    "cannibal/keyword-collision": "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls",
+    "cannibal/url-pattern": "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls",
+};
+//# sourceMappingURL=rule-references.js.map

package/dist/rule-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-references.js","sourceRoot":"","sources":["../src/rule-references.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,qBAAqB,EAAE,oFAAoF;IAC3G,kBAAkB,EAAE,kFAAkF;IACtG,mBAAmB,EAAE,iFAAiF;IACtG,wBAAwB,EAAE,iFAAiF;IAC3G,yBAAyB,EAAE,kFAAkF;IAC7G,2BAA2B,EAAE,kGAAkG;IAC/H,sBAAsB,EAAE,kFAAkF;IAC1G,wBAAwB,EAAE,kFAAkF;IAC5G,sBAAsB,EAAE,iFAAiF;IACzG,yBAAyB,EAAE,gFAAgF;IAC3G,4BAA4B,EAAE,uEAAuE;IACrG,wBAAwB,EAAE,sFAAsF;IAChH,sBAAsB,EAAE,sFAAsF;IAC9G,oBAAoB,EAAE,6EAA6E;IACnG,iBAAiB,EAAE,6EAA6E;IAChG,4BAA4B,EAAE,6EAA6E;IAC3G,iBAAiB,EAAE,6EAA6E;IAChG,kBAAkB,EAAE,6EAA6E;IACjG,4BAA4B,EAAE,wFAAwF;IACtH,iCAAiC,EAAE,wFAAwF;IAC3H,8BAA8B,EAAE,4EAA4E;IAC5G,2BAA2B,EAAE,+EAA+E;IAC5G,qBAAqB,EAAE,2EAA2E;IAClG,eAAe,EAAE,6EAA6E;IAC9F,sBAAsB,EAAE,8DAA8D;IACtF,2BAA2B,EAAE,iGAAiG;IAC9H,sBAAsB,EAAE,4FAA4F;IACpH,wBAAwB,EAAE,4FAA4F;IACtH,oBAAoB,EAAE,4FAA4F;IAClH,wBAAwB,EAAE,wFAAwF;IAClH,4BAA4B,EAAE,wFAAwF;IACtH,sBAAsB,EAAE,wFAAwF;CACjH,CAAC"}

package/dist/rules/cannibal/keyword-collision.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function keywordCollisionRule(pages: ParsedPage[], minShared?: number): RuleResult[];
+//# sourceMappingURL=keyword-collision.d.ts.map

package/dist/rules/cannibal/keyword-collision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-collision.d.ts","sourceRoot":"","sources":["../../../src/rules/cannibal/keyword-collision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,GAAE,MAAU,GACpB,UAAU,EAAE,CAwBd"}