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

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 function renderMarkdown(audit: Audit): string;

package/dist/core/report/markdown.js

@@ -0,0 +1,152 @@
+export function renderMarkdown(audit) {
+    return audit.kind === 'page' ? pageMarkdown(audit) : siteMarkdown(audit);
+}
+function pageMarkdown(audit, heading = '#') {
+    const lines = [];
+    lines.push(`${heading} SEO audit: ${audit.url}`);
+    lines.push('');
+    lines.push(`Score **${audit.score}/100** · ${countsLine(audit.counts)}${audit.response?.status ? ` · HTTP ${audit.response.status}` : ''}${audit.response?.timeMs ? ` · ${audit.response.timeMs} ms` : ''}`);
+    lines.push('');
+    const s = audit.summary;
+    lines.push(`${heading}# Summary`);
+    lines.push('');
+    lines.push('| Field | Value |');
+    lines.push('| --- | --- |');
+    lines.push(`| Title | ${cell(s.title)} (${s.titleLength} chars) |`);
+    lines.push(`| Meta description | ${cell(s.metaDescription)} (${s.metaDescriptionLength} chars) |`);
+    lines.push(`| Canonical | ${cell(s.canonical)} |`);
+    lines.push(`| Indexable | ${s.indexable ? 'yes' : 'no'}${s.robots.length ? ` (${s.robots.join(', ')})` : ''} |`);
+    lines.push(`| Language | ${cell(s.lang)} |`);
+    lines.push(`| H1 | ${s.h1.length ? s.h1.map(cell).join(' / ') : '—'} |`);
+    lines.push(`| Words | ${s.wordCount} |`);
+    lines.push(`| Images | ${s.images.total} (${s.images.missingAlt} without alt) |`);
+    lines.push(`| Links | ${s.links.internal} internal, ${s.links.external} external |`);
+    lines.push(`| Structured data | ${s.structuredDataTypes.length ? s.structuredDataTypes.join(', ') : '—'} |`);
+    lines.push(`| Open Graph | ${Object.keys(s.openGraph).length ? Object.keys(s.openGraph).map((k) => `og:${k}`).join(', ') : '—'} |`);
+    lines.push('');
+    if (audit.performance) {
+        const m = audit.performance.metrics;
+        lines.push(`${heading}# Lighthouse (${audit.performance.formFactor})`);
+        lines.push('');
+        lines.push('| Metric | Value |');
+        lines.push('| --- | --- |');
+        lines.push(`| Performance score | ${m.performanceScore ?? '—'} |`);
+        lines.push(`| SEO score | ${m.seoScore ?? '—'} |`);
+        lines.push(`| LCP | ${ms(m.lcpMs)} |`);
+        lines.push(`| CLS | ${m.cls === null ? '—' : m.cls.toFixed(3)} |`);
+        lines.push(`| TBT | ${ms(m.tbtMs)} |`);
+        lines.push(`| FCP | ${ms(m.fcpMs)} |`);
+        lines.push(`| Speed Index | ${ms(m.speedIndexMs)} |`);
+        lines.push(`| TTFB | ${ms(m.ttfbMs)} |`);
+        lines.push('');
+    }
+    if (audit.rendering) {
+        const r = audit.rendering;
+        lines.push(`${heading}# Rendered vs server HTML`);
+        lines.push('');
+        lines.push('| Field | Server HTML | Rendered DOM |');
+        lines.push('| --- | --- | --- |');
+        lines.push(`| Title | ${cell(r.raw.title)} | ${cell(r.rendered.title)} |`);
+        lines.push(`| Meta description | ${cell(r.raw.metaDescription)} | ${cell(r.rendered.metaDescription)} |`);
+        lines.push(`| Canonical | ${cell(r.raw.canonical)} | ${cell(r.rendered.canonical)} |`);
+        lines.push(`| Robots | ${r.raw.robots.join(', ') || '—'} | ${r.rendered.robots.join(', ') || '—'} |`);
+        lines.push(`| H1 count | ${r.raw.h1Count} | ${r.rendered.h1Count} |`);
+        lines.push(`| Words | ${r.raw.wordCount} | ${r.rendered.wordCount} |`);
+        lines.push(`| Internal links | ${r.raw.internalLinks} | ${r.rendered.internalLinks} |`);
+        lines.push(`| Structured data items | ${r.raw.structuredDataCount} | ${r.rendered.structuredDataCount} |`);
+        lines.push('');
+    }
+    lines.push(...findingsSection(audit.findings, heading));
+    return lines.join('\n');
+}
+function siteMarkdown(audit) {
+    const lines = [];
+    lines.push(`# SEO site audit: ${audit.target}`);
+    lines.push('');
+    lines.push(`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`);
+    lines.push('');
+    lines.push('| Check | Result |');
+    lines.push('| --- | --- |');
+    lines.push(`| robots.txt | ${audit.robotsTxt ? (audit.robotsTxt.found ? `found (${audit.robotsTxt.sitemaps.length} sitemap(s) declared)` : `not found (HTTP ${audit.robotsTxt.status ?? 'n/a'})`) : 'not checked'} |`);
+    lines.push(`| 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)` : ''} |`);
+    lines.push('');
+    if (audit.siteFindings.length) {
+        lines.push('## Site-wide findings');
+        lines.push('');
+        for (const f of audit.siteFindings)
+            lines.push(...findingLines(f));
+        lines.push('');
+    }
+    if (audit.issues.length) {
+        lines.push('## Page issues by rule');
+        lines.push('');
+        lines.push('| Severity | Rule | Pages | Example |');
+        lines.push('| --- | --- | --- | --- |');
+        for (const i of audit.issues)
+            lines.push(`| ${i.severity} | \`${i.rule}\` | ${i.pages} | ${i.examples[0] ?? ''} |`);
+        lines.push('');
+    }
+    lines.push('## Pages');
+    lines.push('');
+    lines.push('| Score | E/W/I | URL | Title |');
+    lines.push('| --- | --- | --- | --- |');
+    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');
+        lines.push('');
+        for (const p of detailed) {
+            lines.push(`### ${p.url}`);
+            lines.push('');
+            lines.push(`Score ${p.score}/100 · ${countsLine(p.counts)}`);
+            lines.push('');
+            for (const f of p.findings)
+                lines.push(...findingLines(f));
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+function findingsSection(findings, heading) {
+    const lines = [];
+    lines.push(`${heading}# Findings`);
+    lines.push('');
+    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 === 'error' ? 'Errors' : severity === 'warning' ? 'Warnings' : 'Info'} (${group.length})`);
+        lines.push('');
+        for (const f of group)
+            lines.push(...findingLines(f));
+        lines.push('');
+    }
+    return lines;
+}
+function findingLines(f) {
+    const out = [`- **\`${f.rule}\`** ${f.message}`];
+    out.push(`  - 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;
+}
+function countsLine(c) {
+    return `${c.error} error(s), ${c.warning} warning(s), ${c.info} info`;
+}
+function cell(value) {
+    if (!value)
+        return '—';
+    return value.replace(/\|/g, '\\|').replace(/\n/g, ' ').slice(0, 120);
+}
+function ms(value) {
+    return value === null ? '—' : `${Math.round(value)} ms`;
+}
+//# 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 { RobotsTxtInfo } from './types.js';
+import { type FetchOptions } from './fetch.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 function loadRobotsTxt(origin: string, userAgent: string, options?: FetchOptions): Promise<RobotsResult>;
+export declare function buildRobots(url: string, status: number | null, error: string | undefined, text: string | null, userAgent: string): RobotsResult;
+/** Short bot token used for robots.txt matching, derived from the full UA string. */
+export declare function robotsUserAgentToken(userAgent: string): string;

package/dist/core/robots.js

@@ -0,0 +1,33 @@
+import { createRequire } from 'node:module';
+import { fetchPage } from './fetch.js';
+// robots-parser is CommonJS; require() avoids ESM default-export interop mismatches.
+const robotsParser = createRequire(import.meta.url)('robots-parser');
+export async function loadRobotsTxt(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 && typeof res.body === 'string' && !res.error && !/<html/i.test(res.body.slice(0, 500));
+    return buildRobots(url, res.status, res.error, found ? res.body : null, userAgent);
+}
+export function 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;
+        },
+    };
+}
+/** Short bot token used for robots.txt matching, derived from the full UA string. */
+export function robotsUserAgentToken(userAgent) {
+    const match = /agentic-seo-check|Googlebot|bingbot/i.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;AAE5C,OAAO,EAAE,SAAS,EAAqB,MAAM,YAAY,CAAC;AAI1D,qFAAqF;AACrF,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,eAAe,CAA8C,CAAC;AAQlH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,SAAiB,EAAE,UAAwB,EAAE;IAC/F,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3G,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACzH,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAAqB,EAAE,KAAyB,EAAE,IAAmB,EAAE,SAAiB;IAC/H,MAAM,IAAI,GAAkB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,KAAK,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3H,IAAI,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,CAAC,MAAc,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACnD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,KAAK,GAAG,sCAAsC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC"}

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

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

package/dist/core/rules/canonical.js

@@ -0,0 +1,105 @@
+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 function isLocalHost(url) {
+    const host = hostOf(url);
+    if (!host)
+        return false;
+    return LOCAL_HOSTS.has(host) || host.endsWith('.local') || host.endsWith('.localhost') || host.endsWith('.test');
+}
+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[0];
+        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[0];
+        if (!first || !page.canonical)
+            return null;
+        return /^https?:\/\//i.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' },
+            });
+    }),
+];
+function stripTrailingSlash(url) {
+    return url.endsWith('/') && new URL(url).pathname !== '/' ? url.slice(0, -1) : 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,41 @@
+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,EAAE,8KAA8K;QAC9L,IAAI,EAAE,WAAW,CAAC,UAAU;KAC7B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAChH;IACD,UAAU,CACR;QACE,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,gEAAgE;QAC7E,cAAc,EAAE,wKAAwK;KACzL,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,CAAC,iBAAiB,IAAI,CAAC,SAAS,qCAAqC,UAAU,CAAC,gBAAgB,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAChM,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,EAAE,mEAAmE;KACpF,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CACnH;IACD,UAAU,CACR;QACE,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,gHAAgH;QAC7H,cAAc,EAAE,mGAAmG;KACpH,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;YAAE,OAAO,IAAI,CAAC;QACxE,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,KAAK,oBAAoB,EAAE,EAAE,QAAQ,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChL,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,60 @@
+import { defineRule, GOOGLE_DOCS } from './rule.js';
+const BCP47 = /^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$/;
+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().replace(/\s/g, '');
+        return /user-scalable=(no|0)/.test(v) || /maximum-scale=1(\.0*)?(,|$)/.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[];

package/dist/core/rules/headings.js

@@ -0,0 +1,61 @@
+import { cap, defineRule } from './rule.js';
+export const headingRules = [
+    defineRule({
+        id: 'h1.missing',
+        category: 'headings',
+        severity: 'warning',
+        description: 'The page has no <h1>.',
+        recommendation: 'Add one <h1> that states the main topic of the page. It is usually the visible page heading.',
+    }, ({ page }, make) => (page.h1s.length === 0 ? make('Page has no <h1> heading.', { selector: 'h1' }) : null)),
+    defineRule({
+        id: 'h1.multiple',
+        category: 'headings',
+        severity: 'info',
+        description: 'The page has more than one <h1>.',
+        recommendation: 'Prefer a single <h1> for the main topic and use <h2>-<h6> for sections. Multiple H1s are valid HTML but make the main topic less clear.',
+    }, ({ page }, make) => page.h1s.length > 1 ? make(`Page has ${page.h1s.length} <h1> headings.`, { selector: 'h1', evidence: { h1s: cap(page.h1s) } }) : null),
+    defineRule({
+        id: 'h1.empty',
+        category: 'headings',
+        severity: 'warning',
+        description: 'An <h1> exists but contains no text.',
+        recommendation: 'Put the page heading text inside the <h1>. If it wraps only an image, give the image descriptive alt text.',
+    }, ({ page }, make) => (page.h1s.length > 0 && page.h1s.every((h) => !h) ? make('All <h1> elements are empty.', { selector: 'h1' }) : null)),
+    defineRule({
+        id: 'h1.too-long',
+        category: 'headings',
+        severity: 'info',
+        description: 'The <h1> is longer than the configured maximum (default 70 characters).',
+        recommendation: 'Keep the H1 concise; move detail into the intro paragraph.',
+    }, ({ page, thresholds }, make) => {
+        const long = page.h1s.filter((h) => h.length > thresholds.h1MaxChars);
+        return long.length ? make(`${long.length} <h1> heading(s) exceed ${thresholds.h1MaxChars} characters.`, { selector: 'h1', evidence: { h1s: cap(long) } }) : null;
+    }),
+    defineRule({
+        id: 'headings.empty',
+        category: 'headings',
+        severity: 'warning',
+        description: 'Heading elements (h2-h6) with no text content.',
+        recommendation: 'Remove empty heading tags or fill them with text. Empty headings confuse outline parsers and screen readers.',
+    }, ({ page }, make) => {
+        const empty = page.headings.filter((h) => h.level > 1 && !h.text);
+        return empty.length ? make(`${empty.length} empty heading element(s) found.`, { evidence: { levels: cap(empty.map((h) => `h${h.level}`)) } }) : null;
+    }),
+    defineRule({
+        id: 'headings.skipped-level',
+        category: 'headings',
+        severity: 'info',
+        description: 'Heading levels are skipped (for example an <h2> followed directly by an <h4>).',
+        recommendation: 'Use heading levels in order (h1 > h2 > h3) so the document outline reflects the content structure.',
+    }, ({ page }, make) => {
+        const skips = [];
+        let prev = 0;
+        for (const h of page.headings) {
+            if (prev > 0 && h.level > prev + 1)
+                skips.push(`h${prev} → h${h.level} ("${h.text.slice(0, 40)}")`);
+            prev = h.level;
+        }
+        return skips.length ? make(`${skips.length} heading level skip(s) found.`, { evidence: { skips: cap(skips) } }) : null;
+    }),
+];
+//# sourceMappingURL=headings.js.map

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

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

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

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