ax-audit 4.2.1 → 6.0.0

package/dist/checks/frontmatter.js

@@ -1,100 +0,0 @@
-/**
- * Minimal YAML frontmatter reader.
- *
- * ax-audit has two runtime dependencies and will not grow a YAML parser for
- * this. The documents it reads frontmatter from — SKILL.md, the Markdown
- * mirrors Vercel and Mintlify serve — use a flat `key: value` block by
- * convention, so a focused reader handles them exactly and reports anything
- * more elaborate as unparsed rather than guessing at it.
- *
- * Supported: `key: value`, single- and double-quoted values, `#` comments on
- * their own line or after a value, and inline flow sequences (`tags: [a, b]`).
- * Nested mappings and block sequences are recognised and skipped, with their
- * keys recorded in `skipped` so a caller can say what it could not read.
- */
-/** Strip matching surrounding quotes and unescape the pairs YAML defines inside them. */
-function unquote(value) {
-    const trimmed = value.trim();
-    if (trimmed.length >= 2 && trimmed.startsWith('"') && trimmed.endsWith('"')) {
-        return trimmed.slice(1, -1).replace(/\\(["\\n])/g, (_, c) => (c === 'n' ? '\n' : c));
-    }
-    if (trimmed.length >= 2 && trimmed.startsWith("'") && trimmed.endsWith("'")) {
-        return trimmed.slice(1, -1).replace(/''/g, "'");
-    }
-    return trimmed;
-}
-/** Remove a trailing `#` comment from an unquoted value. */
-function stripComment(value) {
-    const trimmed = value.trim();
-    if (trimmed.startsWith('"') || trimmed.startsWith("'"))
-        return trimmed;
-    const hash = trimmed.search(/\s#/);
-    return hash === -1 ? trimmed : trimmed.slice(0, hash).trim();
-}
-/**
- * Parse a leading `---` delimited frontmatter block.
- *
- * A document with no block returns `present: false` and its whole text as the
- * body, so callers can distinguish "no frontmatter" from "empty frontmatter".
- */
-export function parseFrontmatter(document) {
-    const empty = { frontmatter: {}, lists: {}, skipped: [], body: document, present: false };
-    // Tolerate a BOM and leading blank lines before the opening delimiter.
-    const text = document.replace(/^\uFEFF/, '');
-    const opening = text.match(/^\s*---[ \t]*\r?\n/);
-    if (!opening)
-        return empty;
-    const rest = text.slice(opening[0].length);
-    const closing = rest.match(/^---[ \t]*(?:\r?\n|$)/m);
-    if (!closing || closing.index === undefined)
-        return empty;
-    const block = rest.slice(0, closing.index);
-    const body = rest.slice(closing.index + closing[0].length);
-    const frontmatter = {};
-    const lists = {};
-    const skipped = [];
-    const lines = block.split(/\r?\n/);
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.trim() === '' || line.trim().startsWith('#'))
-            continue;
-        // Indented lines belong to a structure the previous key opened.
-        if (/^\s/.test(line))
-            continue;
-        const match = line.match(/^([A-Za-z0-9_.-]+)\s*:\s*(.*)$/);
-        if (!match)
-            continue;
-        const key = match[1].toLowerCase();
-        const raw = match[2];
-        if (raw.trim() === '') {
-            // A key with no inline value opens a nested mapping or block sequence.
-            const next = lines[i + 1] ?? '';
-            if (/^\s*-\s+/.test(next)) {
-                const items = [];
-                for (let j = i + 1; j < lines.length && /^\s*-\s+/.test(lines[j]); j++) {
-                    items.push(unquote(stripComment(lines[j].replace(/^\s*-\s+/, ''))));
-                }
-                lists[key] = items;
-            }
-            else if (/^\s+\S/.test(next)) {
-                skipped.push(key);
-            }
-            else {
-                frontmatter[key] = '';
-            }
-            continue;
-        }
-        const value = stripComment(raw);
-        const flow = value.match(/^\[(.*)\]$/);
-        if (flow) {
-            lists[key] = flow[1]
-                .split(',')
-                .map((v) => unquote(v))
-                .filter((v) => v !== '');
-            continue;
-        }
-        frontmatter[key] = unquote(value);
-    }
-    return { frontmatter, lists, skipped, body, present: true };
-}
-//# sourceMappingURL=frontmatter.js.map

package/dist/checks/frontmatter.js.map

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

package/dist/checks/html-rendering.d.ts

@@ -1,21 +0,0 @@
-import type { CheckContext, CheckResult, CheckMeta } from '../types.js';
-/**
- * "html-rendering" — does the HTML delivered to a non-JS agent actually contain content?
- *
- * Most AI crawlers (GPTBot, ClaudeBot, CCBot, etc.) do **not** execute JavaScript. A site
- * built as a client-rendered SPA returns an empty `<div id="root"></div>` shell to those
- * agents, and is effectively invisible regardless of how good its `llms.txt` and structured
- * data are. This check estimates server-side rendering by inspecting the static HTML body.
- *
- * Signals (each contributes to the score):
- * - Visible text length and word count (low → likely JS-rendered shell)
- * - Text-to-markup ratio against structural markup (high JS, no text → SPA)
- * - Presence of semantic landmarks (`<main>`, `<article>`, `<header>`, `<footer>`, `<nav>`)
- * - Single, meaningful `<h1>`
- * - `<noscript>` fallback for JS-only frameworks
- * - Non-empty SPA root containers (`#root`, `#app`, `#__next`)
- * - Image `alt` attribute coverage
- */
-export declare const meta: CheckMeta;
-export default function check(ctx: CheckContext): Promise<CheckResult>;
-//# sourceMappingURL=html-rendering.d.ts.map

package/dist/checks/html-rendering.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"html-rendering.d.ts","sourceRoot":"","sources":["../../src/checks/html-rendering.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAW,MAAM,aAAa,CAAC;AAUjF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI,EAAE,SAIlB,CAAC;AAOF,wBAA8B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6L3E"}

package/dist/checks/html-rendering.js

@@ -1,221 +0,0 @@
-import { guideUrl } from '../guide-urls.js';
-import { countExecutableScripts, extractVisibleText, findOpeningTag, getMetaContent, structuralMarkupLength, } from './html-utils.js';
-import { buildResult } from './utils.js';
-/**
- * "html-rendering" — does the HTML delivered to a non-JS agent actually contain content?
- *
- * Most AI crawlers (GPTBot, ClaudeBot, CCBot, etc.) do **not** execute JavaScript. A site
- * built as a client-rendered SPA returns an empty `<div id="root"></div>` shell to those
- * agents, and is effectively invisible regardless of how good its `llms.txt` and structured
- * data are. This check estimates server-side rendering by inspecting the static HTML body.
- *
- * Signals (each contributes to the score):
- * - Visible text length and word count (low → likely JS-rendered shell)
- * - Text-to-markup ratio against structural markup (high JS, no text → SPA)
- * - Presence of semantic landmarks (`<main>`, `<article>`, `<header>`, `<footer>`, `<nav>`)
- * - Single, meaningful `<h1>`
- * - `<noscript>` fallback for JS-only frameworks
- * - Non-empty SPA root containers (`#root`, `#app`, `#__next`)
- * - Image `alt` attribute coverage
- */
-export const meta = {
-    id: 'html-rendering',
-    name: 'HTML Rendering',
-    description: 'Checks server-rendered content, semantic landmarks, and SPA-shell heuristics',
-};
-const MIN_TEXT_LENGTH = 500;
-const MIN_WORD_COUNT = 80;
-const MIN_TEXT_TO_HTML_RATIO = 0.05;
-const SPA_ROOT_IDS = ['root', 'app', '__next', '__nuxt', 'svelte', 'gatsby', 'gatsby-focus-wrapper'];
-export default async function check(ctx) {
-    const start = performance.now();
-    const findings = [];
-    let score = 100;
-    const html = ctx.html;
-    if (!html) {
-        findings.push({
-            status: 'fail',
-            message: 'Could not fetch homepage HTML',
-            hint: 'The homepage did not return any HTML body. Verify your server returns 200 OK with a non-empty response on the root URL.',
-            learnMoreUrl: guideUrl(meta.id, 'no-html'),
-        });
-        return buildResult(meta, 0, findings, start);
-    }
-    const visibleText = extractVisibleText(html);
-    const wordCount = visibleText ? visibleText.split(/\s+/).filter(Boolean).length : 0;
-    const textOk = visibleText.length >= MIN_TEXT_LENGTH && wordCount >= MIN_WORD_COUNT;
-    // Against the markup that could have carried text — script and style
-    // bodies, svg interiors and the head excluded (see structuralMarkupLength).
-    const markup = structuralMarkupLength(html);
-    const ratio = markup > 0 ? visibleText.length / markup : 0;
-    if (textOk) {
-        findings.push({
-            status: 'pass',
-            message: `Server-rendered content detected (${wordCount} words, ${visibleText.length} chars of visible text)`,
-        });
-    }
-    else if (visibleText.length > 0) {
-        findings.push({
-            status: 'warn',
-            message: `Sparse server-rendered content (${wordCount} words, ${visibleText.length} chars)`,
-            detail: `Below thresholds: ${MIN_WORD_COUNT} words, ${MIN_TEXT_LENGTH} chars`,
-            hint: 'Render at least the main page content server-side. Many AI crawlers (GPTBot, ClaudeBot, CCBot) do not execute JavaScript and will see only the static HTML.',
-            learnMoreUrl: guideUrl(meta.id, 'sparse-content'),
-        });
-        score -= 25;
-    }
-    else {
-        findings.push({
-            status: 'fail',
-            message: 'No visible text content in static HTML',
-            hint: 'Your homepage appears to be a JavaScript-only shell. Add server-side rendering (Next.js SSR/SSG, Astro, Remix, or a static prerender) so AI agents that do not execute JS can read your content.',
-            learnMoreUrl: guideUrl(meta.id, 'js-shell'),
-        });
-        score -= 50;
-    }
-    if (ratio >= MIN_TEXT_TO_HTML_RATIO) {
-        findings.push({
-            status: 'pass',
-            message: `Text-to-markup ratio is healthy (${(ratio * 100).toFixed(1)}% of structural markup)`,
-        });
-    }
-    else if (textOk) {
-        // The ratio exists as a shell symptom, and the text thresholds just
-        // proved this page is not a shell: the words are demonstrably there.
-        // What a low ratio still says is that the structure around them is
-        // expensive for an agent consuming raw HTML — worth saying, not
-        // worth charging for twice.
-        findings.push({
-            status: 'warn',
-            message: `Markup-heavy page (text is ${(ratio * 100).toFixed(1)}% of structural markup)`,
-            detail: `Recommended minimum: ${(MIN_TEXT_TO_HTML_RATIO * 100).toFixed(0)}%. The content thresholds are met, so this does not move the score.`,
-            hint: 'The visible text clears the content thresholds, so agents can read this page. Trimming wrapper markup would still make it cheaper to consume.',
-            learnMoreUrl: guideUrl(meta.id, 'low-ratio'),
-        });
-    }
-    else {
-        findings.push({
-            status: 'warn',
-            message: `Low text-to-markup ratio (${(ratio * 100).toFixed(1)}%)`,
-            detail: `Recommended minimum: ${(MIN_TEXT_TO_HTML_RATIO * 100).toFixed(0)}% of structural markup (script/style bodies and svg interiors excluded)`,
-            hint: 'A very low text-to-markup ratio is a typical SPA-shell symptom. Inline more content directly into the HTML response.',
-            learnMoreUrl: guideUrl(meta.id, 'low-ratio'),
-        });
-        score -= 10;
-    }
-    const emptyShell = SPA_ROOT_IDS.find((id) => {
-        const re = new RegExp(`<[^>]+\\bid\\s*=\\s*["']${id}["'][^>]*>\\s*</[^>]+>`, 'i');
-        return re.test(html);
-    });
-    if (emptyShell) {
-        findings.push({
-            status: 'fail',
-            message: `Empty SPA mount point detected: #${emptyShell}`,
-            hint: 'The static HTML contains an empty SPA mount node, which means content is rendered only client-side. Enable SSR/SSG so the initial HTML response includes meaningful content.',
-            learnMoreUrl: guideUrl(meta.id, 'empty-spa'),
-        });
-        score -= 20;
-    }
-    const semanticLandmarks = ['main', 'article', 'section', 'header', 'footer', 'nav'];
-    const presentLandmarks = semanticLandmarks.filter((tag) => findOpeningTag(html, tag) !== null);
-    if (presentLandmarks.length >= 3) {
-        findings.push({
-            status: 'pass',
-            message: `Semantic landmarks present (${presentLandmarks.join(', ')})`,
-        });
-    }
-    else if (presentLandmarks.length > 0) {
-        findings.push({
-            status: 'warn',
-            message: `Only ${presentLandmarks.length} semantic landmark(s) found`,
-            detail: `Found: ${presentLandmarks.join(', ')}. Missing: ${semanticLandmarks.filter((t) => !presentLandmarks.includes(t)).join(', ')}`,
-            hint: 'Use semantic HTML tags so AI agents can understand page structure: <header>, <nav>, <main>, <article>, <section>, <footer>.',
-            learnMoreUrl: guideUrl(meta.id, 'few-landmarks'),
-        });
-        score -= 10;
-    }
-    else {
-        findings.push({
-            status: 'warn',
-            message: 'No semantic HTML landmarks found',
-            hint: 'Replace generic <div> structures with semantic tags: <main>, <article>, <header>, <nav>, <footer>. Agents use these to identify the primary content region.',
-            learnMoreUrl: guideUrl(meta.id, 'no-landmarks'),
-        });
-        score -= 15;
-    }
-    const h1Matches = [...html.matchAll(/<h1\b[^>]*>([\s\S]*?)<\/h1>/gi)];
-    if (h1Matches.length === 1) {
-        const h1Text = extractVisibleText(h1Matches[0][1]);
-        if (h1Text.length > 0) {
-            findings.push({ status: 'pass', message: `Single <h1> heading: "${truncate(h1Text, 60)}"` });
-        }
-        else {
-            findings.push({
-                status: 'warn',
-                message: '<h1> is empty',
-                hint: 'Add meaningful text inside your <h1> element so agents can identify the page topic.',
-                learnMoreUrl: guideUrl(meta.id, 'empty-h1'),
-            });
-            score -= 5;
-        }
-    }
-    else if (h1Matches.length > 1) {
-        findings.push({
-            status: 'warn',
-            message: `${h1Matches.length} <h1> headings found (recommend exactly 1)`,
-            hint: 'Use a single <h1> per page to clearly mark the primary topic. Demote secondary headings to <h2>+.',
-            learnMoreUrl: guideUrl(meta.id, 'multiple-h1'),
-        });
-        score -= 5;
-    }
-    else {
-        findings.push({
-            status: 'warn',
-            message: 'No <h1> heading found',
-            hint: 'Add a single <h1> describing the page. Agents and search engines treat the H1 as the primary topic indicator.',
-            learnMoreUrl: guideUrl(meta.id, 'no-h1'),
-        });
-        score -= 10;
-    }
-    const heavyJs = countExecutableScripts(html) > 15;
-    const hasNoscript = /<noscript\b[^>]*>[\s\S]*?<\/noscript>/i.test(html);
-    if (heavyJs && !hasNoscript) {
-        findings.push({
-            status: 'warn',
-            message: 'Heavy JavaScript with no <noscript> fallback',
-            detail: `${countExecutableScripts(html)} executable <script> tags`,
-            hint: 'Provide a <noscript> fallback that explains the site or links to a non-JS variant. This helps agents that disable JS.',
-            learnMoreUrl: guideUrl(meta.id, 'no-noscript'),
-        });
-        score -= 5;
-    }
-    const imgs = [...html.matchAll(/<img\b([^>]*)>/gi)];
-    if (imgs.length > 0) {
-        const withAlt = imgs.filter((m) => /\balt\s*=/i.test(m[1])).length;
-        const coverage = withAlt / imgs.length;
-        if (coverage >= 0.9) {
-            findings.push({
-                status: 'pass',
-                message: `${withAlt}/${imgs.length} <img> tags have alt attributes`,
-            });
-        }
-        else {
-            findings.push({
-                status: 'warn',
-                message: `Only ${withAlt}/${imgs.length} <img> tags have alt attributes`,
-                hint: 'Add descriptive alt="" to every <img>. Agents use alt text to understand images they cannot process visually.',
-                learnMoreUrl: guideUrl(meta.id, 'missing-alt'),
-            });
-            score -= 5;
-        }
-    }
-    const generator = getMetaContent(html, 'generator');
-    if (generator) {
-        findings.push({ status: 'pass', message: `Generator: ${generator}` });
-    }
-    return buildResult(meta, score, findings, start);
-}
-function truncate(value, max) {
-    return value.length > max ? `${value.slice(0, max - 1)}…` : value;
-}
-//# sourceMappingURL=html-rendering.js.map

package/dist/checks/html-rendering.js.map

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

package/dist/checks/html-utils.d.ts

@@ -1,66 +0,0 @@
-/**
- * Shared HTML parsing primitives used by checks that need to inspect homepage markup.
- *
- * These are deliberately regex-based (no DOM dependency) so the audit stays free of
- * heavyweight HTML parsers. They are designed for resilience over completeness — every
- * helper returns `null` / empty values on malformed input rather than throwing.
- */
-/** Escape a string for safe inclusion inside a `RegExp` source. */
-export declare function escapeRegex(value: string): string;
-/** Decode the small set of HTML entities that show up most often inside attribute values. */
-export declare function unescapeHtml(value: string): string;
-/**
- * Match the first opening tag (`<tag ...>`) and return its raw attribute string.
- * Returns `null` if the tag is absent.
- */
-export declare function findOpeningTag(html: string, tagName: string): string | null;
-/** Pull a single attribute out of a raw attribute fragment (the `...` in `<tag ...>`). */
-export declare function getAttribute(attrFragment: string, attrName: string): string | null;
-/** Convenience: read an attribute from the first matching opening tag. */
-export declare function getTagAttribute(html: string, tagName: string, attrName: string): string | null;
-/**
- * Extract the `content` value of the first `<meta name="..."|property="..."|http-equiv="...">`
- * matching `key`. Searches `name`, `property`, and `http-equiv` (case-insensitive).
- */
-export declare function getMetaContent(html: string, key: string): string | null;
-/** Match every `<meta>` tag whose name/property begins with `prefix` (e.g. `og:`, `twitter:`). */
-export declare function findMetaTagsByPrefix(html: string, prefix: string): string[];
-/** Match every `<link rel="...">` tag with the requested `rel` value. */
-export declare function findLinkTags(html: string, rel: string): string[];
-/**
- * Strip `<script>` / `<style>` blocks and HTML tags to produce a rough text-content estimate.
- * Returns the trimmed plain text — used for content-density / SSR heuristics.
- */
-export declare function extractVisibleText(html: string): string;
-/**
- * Extract the contents of every `<script type="application/ld+json">` block.
- *
- * Attribute order matters here, and it is easy to get wrong: a pattern anchored
- * on `<script type=...` misses `<script id="org-json-ld" type="application/ld+json">`,
- * which is how several frameworks emit it. That mistake reads as "no structured
- * data found" on a site whose markup is perfectly good, so the matcher tolerates
- * any attributes before `type`.
- */
-export declare function findJsonLdBlocks(html: string): string[];
-/** Count `<script>` tags (excluding `type="application/ld+json"` data blocks). */
-export declare function countExecutableScripts(html: string): number;
-/**
- * How much of the document is markup that could have carried visible text.
- *
- * The denominator for the text-to-markup ratio. Three element classes are
- * emptied rather than counted, because their contents are not markup an
- * agent parses for content: script bodies are code or serialized data (a
- * framework's hydration payload alone can be ten times the page), style
- * bodies are presentation, and svg interiors are drawing instructions —
- * the inline twin of image bytes, which nobody would count against an
- * `<img>`. Comments likewise. The head is metadata by definition — much
- * of it demanded by other checks in this engine — so the measurement
- * starts at `<body>` when one exists.
- *
- * Measured against the raw document instead, vercel.com, stripe.com and
- * nextjs.org all sat under the 5% threshold while serving hundreds of
- * words of visible text: the raw ratio graded framework choice, not
- * agent experience.
- */
-export declare function structuralMarkupLength(html: string): number;
-//# sourceMappingURL=html-utils.d.ts.map

package/dist/checks/html-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"html-utils.d.ts","sourceRoot":"","sources":["../../src/checks/html-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3E;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlF;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvE;AAED,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3E;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQvD;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ3D"}

package/dist/checks/html-utils.js

@@ -1,139 +0,0 @@
-/**
- * Shared HTML parsing primitives used by checks that need to inspect homepage markup.
- *
- * These are deliberately regex-based (no DOM dependency) so the audit stays free of
- * heavyweight HTML parsers. They are designed for resilience over completeness — every
- * helper returns `null` / empty values on malformed input rather than throwing.
- */
-/** Escape a string for safe inclusion inside a `RegExp` source. */
-export function escapeRegex(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-/** Decode the small set of HTML entities that show up most often inside attribute values. */
-export function unescapeHtml(value) {
-    return value
-        .replace(/&/g, '&')
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"')
-        .replace(/&#39;/g, "'")
-        .replace(/&#x27;/g, "'")
-        .replace(/&#x2F;/g, '/');
-}
-/**
- * Match the first opening tag (`<tag ...>`) and return its raw attribute string.
- * Returns `null` if the tag is absent.
- */
-export function findOpeningTag(html, tagName) {
-    const re = new RegExp(`<${escapeRegex(tagName)}\\b([^>]*)>`, 'i');
-    const m = html.match(re);
-    return m ? m[1] : null;
-}
-/** Pull a single attribute out of a raw attribute fragment (the `...` in `<tag ...>`). */
-export function getAttribute(attrFragment, attrName) {
-    const re = new RegExp(`\\b${escapeRegex(attrName)}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+))`, 'i');
-    const m = attrFragment.match(re);
-    if (!m)
-        return null;
-    return unescapeHtml(m[1] ?? m[2] ?? m[3] ?? '');
-}
-/** Convenience: read an attribute from the first matching opening tag. */
-export function getTagAttribute(html, tagName, attrName) {
-    const frag = findOpeningTag(html, tagName);
-    return frag === null ? null : getAttribute(frag, attrName);
-}
-/**
- * Extract the `content` value of the first `<meta name="..."|property="..."|http-equiv="...">`
- * matching `key`. Searches `name`, `property`, and `http-equiv` (case-insensitive).
- */
-export function getMetaContent(html, key) {
-    const escaped = escapeRegex(key);
-    const re = new RegExp(`<meta\\s+[^>]*\\b(?:name|property|http-equiv)\\s*=\\s*["']${escaped}["'][^>]*>`, 'i');
-    const m = html.match(re);
-    if (!m)
-        return null;
-    return getAttribute(m[0], 'content');
-}
-/** Match every `<meta>` tag whose name/property begins with `prefix` (e.g. `og:`, `twitter:`). */
-export function findMetaTagsByPrefix(html, prefix) {
-    const re = new RegExp(`<meta\\s+[^>]*\\b(?:name|property)\\s*=\\s*["']${escapeRegex(prefix)}[^"']*["'][^>]*>`, 'gi');
-    return [...html.matchAll(re)].map((m) => m[0]);
-}
-/** Match every `<link rel="...">` tag with the requested `rel` value. */
-export function findLinkTags(html, rel) {
-    const re = new RegExp(`<link\\s+[^>]*\\brel\\s*=\\s*["'][^"']*\\b${escapeRegex(rel)}\\b[^"']*["'][^>]*>`, 'gi');
-    return [...html.matchAll(re)].map((m) => m[0]);
-}
-/**
- * Strip `<script>` / `<style>` blocks and HTML tags to produce a rough text-content estimate.
- * Returns the trimmed plain text — used for content-density / SSR heuristics.
- */
-export function extractVisibleText(html) {
-    return html
-        .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, ' ')
-        .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, ' ')
-        .replace(/<noscript\b[^>]*>[\s\S]*?<\/noscript>/gi, ' ')
-        .replace(/<!--[\s\S]*?-->/g, ' ')
-        .replace(/<[^>]+>/g, ' ')
-        .replace(/\s+/g, ' ')
-        .trim();
-}
-/**
- * Extract the contents of every `<script type="application/ld+json">` block.
- *
- * Attribute order matters here, and it is easy to get wrong: a pattern anchored
- * on `<script type=...` misses `<script id="org-json-ld" type="application/ld+json">`,
- * which is how several frameworks emit it. That mistake reads as "no structured
- * data found" on a site whose markup is perfectly good, so the matcher tolerates
- * any attributes before `type`.
- */
-export function findJsonLdBlocks(html) {
-    const re = /<script\b([^>]*)>([\s\S]*?)<\/script>/gi;
-    const blocks = [];
-    for (const m of html.matchAll(re)) {
-        const type = (getAttribute(m[1], 'type') ?? '').toLowerCase();
-        if (type.includes('application/ld+json'))
-            blocks.push(m[2]);
-    }
-    return blocks;
-}
-/** Count `<script>` tags (excluding `type="application/ld+json"` data blocks). */
-export function countExecutableScripts(html) {
-    const re = /<script\b([^>]*)>/gi;
-    let count = 0;
-    for (const m of html.matchAll(re)) {
-        const type = getAttribute(m[1], 'type') ?? '';
-        if (/json|template/i.test(type))
-            continue;
-        count++;
-    }
-    return count;
-}
-/**
- * How much of the document is markup that could have carried visible text.
- *
- * The denominator for the text-to-markup ratio. Three element classes are
- * emptied rather than counted, because their contents are not markup an
- * agent parses for content: script bodies are code or serialized data (a
- * framework's hydration payload alone can be ten times the page), style
- * bodies are presentation, and svg interiors are drawing instructions —
- * the inline twin of image bytes, which nobody would count against an
- * `<img>`. Comments likewise. The head is metadata by definition — much
- * of it demanded by other checks in this engine — so the measurement
- * starts at `<body>` when one exists.
- *
- * Measured against the raw document instead, vercel.com, stripe.com and
- * nextjs.org all sat under the 5% threshold while serving hundreds of
- * words of visible text: the raw ratio graded framework choice, not
- * agent experience.
- */
-export function structuralMarkupLength(html) {
-    const stripped = html
-        .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, '<script></script>')
-        .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, '<style></style>')
-        .replace(/<svg\b[\s\S]*?<\/svg>/gi, '<svg></svg>')
-        .replace(/<!--[\s\S]*?-->/g, '');
-    const body = stripped.match(/<body[\s\S]*<\/body>/i);
-    return (body ? body[0] : stripped).length;
-}
-//# sourceMappingURL=html-utils.js.map

package/dist/checks/html-utils.js.map

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

package/dist/checks/http-headers.d.ts

@@ -1,11 +0,0 @@
-import type { CheckContext, CheckResult, CheckMeta } from '../types.js';
-interface LinkEntry {
-    url: string;
-    params: Record<string, string>;
-}
-/** Parse an RFC 5988 Link header into structured entries. */
-export declare function parseLinkHeader(header: string): LinkEntry[];
-export declare const meta: CheckMeta;
-export default function check(ctx: CheckContext): Promise<CheckResult>;
-export {};
-//# sourceMappingURL=http-headers.d.ts.map

package/dist/checks/http-headers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-headers.d.ts","sourceRoot":"","sources":["../../src/checks/http-headers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAW,MAAM,aAAa,CAAC;AAGjF,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CA2B3D;AAsFD,eAAO,MAAM,IAAI,EAAE,SAKlB,CAAC;AAwBF,wBAA8B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAoH3E"}