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

package/dist/core/rules/headings.js

@@ -0,0 +1,81 @@
+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[];

package/dist/core/rules/hreflang.js

@@ -0,0 +1,100 @@
+import { normalizeUrl } from "../url.js";
+import { cap, defineRule, GOOGLE_DOCS } from "./rule.js";
+const HREFLANG_CODE = /^(?:x-default|[a-zA-Z]{2,3}(?:-[a-zA-Z]{4})?(?:-(?:[a-zA-Z]{2}|\d{3}))?)$/u;
+export const hreflangRules = [
+    defineRule({
+        id: "hreflang.invalid-code",
+        category: "international",
+        severity: "warning",
+        description: "hreflang values that are not valid ISO 639-1 language codes with an optional ISO 3166-1 region (or x-default).",
+        recommendation: 'Use codes like "en", "en-gb", "nl-nl", "zh-hant" or "x-default". Country codes alone ("uk", "eu") are invalid.',
+        docs: GOOGLE_DOCS.hreflang,
+    }, ({ page }, make) => {
+        const bad = page.hreflang.filter((h) => !HREFLANG_CODE.test(h.lang));
+        return bad.length
+            ? make(`${bad.length} hreflang value(s) are invalid.`, {
+                selector: 'link[rel="alternate"][hreflang]',
+                evidence: { invalid: cap(bad.map((h) => h.lang)) },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "hreflang.relative-url",
+        category: "international",
+        severity: "warning",
+        description: "hreflang links must use absolute URLs.",
+        recommendation: "Use fully qualified URLs (https://example.com/nl/) in every hreflang link.",
+        docs: GOOGLE_DOCS.hreflang,
+    }, ({ page }, make) => {
+        const rel = page.hreflang.filter((h) => !/^https?:\/\//iu.test(h.href));
+        return rel.length
+            ? make(`${rel.length} hreflang link(s) use relative URLs.`, {
+                selector: 'link[rel="alternate"][hreflang]',
+                evidence: { examples: cap(rel.map((h) => h.href)) },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "hreflang.duplicate-lang",
+        category: "international",
+        severity: "warning",
+        description: "The same hreflang value appears more than once with different URLs.",
+        recommendation: "Each language/region code may map to exactly one URL per page.",
+        docs: GOOGLE_DOCS.hreflang,
+    }, ({ page }, make) => {
+        const seen = new Map();
+        for (const h of page.hreflang) {
+            const key = h.lang.toLowerCase();
+            const urls = seen.get(key) ?? new Set();
+            urls.add(h.url ?? h.href);
+            seen.set(key, urls);
+        }
+        const dupes = [...seen.entries()].flatMap(([lang, urls]) => urls.size > 1 ? [lang] : []);
+        return dupes.length
+            ? make(`hreflang codes with conflicting URLs: ${dupes.join(", ")}.`, {
+                selector: 'link[rel="alternate"][hreflang]',
+                evidence: { codes: dupes },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "hreflang.missing-self",
+        category: "international",
+        severity: "warning",
+        description: "The hreflang set does not include this page itself (self-referencing entry).",
+        recommendation: "Every page in an hreflang cluster must list itself as well as its alternates, otherwise the annotations may be ignored.",
+        docs: GOOGLE_DOCS.hreflang,
+    }, ({ page }, make) => {
+        if (page.hreflang.length === 0) {
+            return null;
+        }
+        const self = new Set([
+            normalizeUrl(page.url),
+            page.canonical ? normalizeUrl(page.canonical) : null,
+        ].filter(Boolean));
+        const hasSelf = page.hreflang.some((h) => h.url && self.has(normalizeUrl(h.url)));
+        return hasSelf
+            ? null
+            : make("hreflang set has no entry pointing at this page.", {
+                selector: 'link[rel="alternate"][hreflang]',
+                evidence: {
+                    page: page.url,
+                    alternates: cap(page.hreflang.map((h) => `${h.lang} → ${h.href}`)),
+                },
+            });
+    }),
+    defineRule({
+        id: "hreflang.missing-x-default",
+        category: "international",
+        severity: "info",
+        description: "The hreflang set has no x-default entry.",
+        recommendation: 'Add <link rel="alternate" hreflang="x-default" href="..."> pointing at the language-selector or default version.',
+        docs: GOOGLE_DOCS.hreflang,
+    }, ({ page }, make) => page.hreflang.length > 0 &&
+        !page.hreflang.some((h) => h.lang.toLowerCase() === "x-default")
+        ? make("hreflang set has no x-default entry.", {
+            selector: 'link[rel="alternate"][hreflang]',
+        })
+        : null),
+];
+//# sourceMappingURL=hreflang.js.map

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

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

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

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

package/dist/core/rules/images.js

@@ -0,0 +1,77 @@
+import { cap, defineRule, GOOGLE_DOCS } from "./rule.js";
+const FILENAME_ALT = /^(?:img|image|dsc|dscn|dcim|photo|screenshot|screen shot|untitled)[-_ ]?\d*|\.(?:jpe?g|png|gif|webp|avif|svg)$/iu;
+export const imageRules = [
+    defineRule({
+        id: "img.alt-missing",
+        category: "images",
+        severity: "warning",
+        description: "Images without an alt attribute.",
+        recommendation: 'Give every <img> an alt attribute: a short description for meaningful images, alt="" for purely decorative ones. Alt text is used for image search and accessibility.',
+        docs: GOOGLE_DOCS.images,
+    }, ({ page }, make) => {
+        const missing = page.images.filter((i) => i.alt === null);
+        return missing.length
+            ? make(`${missing.length} of ${page.images.length} images have no alt attribute.`, {
+                selector: "img:not([alt])",
+                evidence: {
+                    count: missing.length,
+                    total: page.images.length,
+                    examples: cap(missing.map((i) => i.src ?? "(no src)")),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "img.alt-filename",
+        category: "images",
+        severity: "info",
+        description: "Image alt text looks like a filename (IMG_1234.jpg, screenshot.png).",
+        recommendation: "Replace filename-style alt text with a description of what the image shows.",
+        docs: GOOGLE_DOCS.images,
+    }, ({ page }, make) => {
+        const bad = page.images.filter((i) => i.alt && FILENAME_ALT.test(i.alt.trim()));
+        return bad.length
+            ? make(`${bad.length} image(s) have filename-like alt text.`, {
+                evidence: {
+                    examples: cap(bad.map((i) => ({ src: i.src, alt: i.alt }))),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "img.dimensions-missing",
+        category: "images",
+        severity: "info",
+        description: "Images without explicit width and height attributes, which causes layout shift (CLS) while they load.",
+        recommendation: "Add width and height attributes (or CSS aspect-ratio) to <img> elements so the browser can reserve space before the image loads.",
+        docs: GOOGLE_DOCS.cwv,
+    }, ({ page }, make) => {
+        const missing = page.images.filter((i) => i.src && (!i.width || !i.height));
+        return missing.length
+            ? make(`${missing.length} of ${page.images.length} images lack width/height attributes.`, {
+                selector: "img:not([width]), img:not([height])",
+                evidence: {
+                    count: missing.length,
+                    examples: cap(missing.map((i) => i.src)),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "img.src-missing",
+        category: "images",
+        severity: "info",
+        description: "Images without a src attribute (usually lazy-loading via data-src without a fallback).",
+        recommendation: 'Use native loading="lazy" with a real src, or ensure the lazy-loader also works without JavaScript, so crawlers can discover the images.',
+        docs: GOOGLE_DOCS.images,
+    }, ({ page }, make) => {
+        const missing = page.images.filter((i) => !i.src);
+        return missing.length
+            ? make(`${missing.length} image(s) have no src attribute.`, {
+                selector: "img:not([src])",
+                evidence: { count: missing.length },
+            })
+            : null;
+    }),
+];
+//# sourceMappingURL=images.js.map

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

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

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

@@ -0,0 +1,14 @@
+import type { Finding, RuleMeta } from "../types.js";
+import type { PageContext, Rule } from "./rule.js";
+export type { PageContext, Rule } from "./rule.js";
+/** Rules evaluated against a single HTML document. */
+export declare const PAGE_RULES: Rule[];
+/** Metadata for every rule the tool can emit, including rules implemented outside the page-rule loop. */
+export declare const ALL_RULES: RuleMeta[];
+export interface RunRulesOptions {
+    /** Rule ids to skip. */
+    disable?: Set<string>;
+}
+export declare const sortFindings: (findings: Finding[]) => Finding[];
+export declare const runPageRules: (ctx: PageContext, options?: RunRulesOptions) => Finding[];
+export declare const findRule: (id: string) => RuleMeta | undefined;

package/dist/core/rules/index.js

@@ -0,0 +1,77 @@
+import { PERFORMANCE_RULES } from "../performance-rules.js";
+import { RENDER_RULES } from "../render-rules.js";
+import { SITE_RULES } from "../site-rules.js";
+import { canonicalRules } from "./canonical.js";
+import { contentRules } from "./content.js";
+import { documentRules } from "./document.js";
+import { headingRules } from "./headings.js";
+import { hreflangRules } from "./hreflang.js";
+import { imageRules } from "./images.js";
+import { indexingRules } from "./indexing.js";
+import { keywordRules } from "./keyword.js";
+import { linkRules } from "./links.js";
+import { metaRules } from "./meta.js";
+import { responseRules } from "./response.js";
+import { socialRules } from "./social.js";
+import { structuredDataRules } from "./structured-data.js";
+import { titleRules } from "./title.js";
+/** Rules evaluated against a single HTML document. */
+export const PAGE_RULES = [
+    ...titleRules,
+    ...metaRules,
+    ...headingRules,
+    ...canonicalRules,
+    ...indexingRules,
+    ...documentRules,
+    ...socialRules,
+    ...imageRules,
+    ...linkRules,
+    ...hreflangRules,
+    ...structuredDataRules,
+    ...contentRules,
+    ...keywordRules,
+    ...responseRules,
+];
+/** Metadata for every rule the tool can emit, including rules implemented outside the page-rule loop. */
+export const ALL_RULES = [
+    ...PAGE_RULES.map((r) => r.meta),
+    ...RENDER_RULES,
+    ...PERFORMANCE_RULES,
+    ...SITE_RULES,
+];
+export const sortFindings = (findings) => {
+    const rank = { error: 0, warning: 1, info: 2 };
+    return findings.toSorted((a, b) => rank[a.severity] - rank[b.severity] || a.rule.localeCompare(b.rule));
+};
+export const runPageRules = (ctx, options = {}) => {
+    const findings = [];
+    for (const rule of PAGE_RULES) {
+        if (options.disable?.has(rule.meta.id)) {
+            continue;
+        }
+        if (rule.meta.requires === "keyword" && !ctx.keyword) {
+            continue;
+        }
+        try {
+            for (const f of rule.check(ctx)) {
+                if (!f.url) {
+                    f.url = ctx.response?.finalUrl ?? ctx.page.url;
+                }
+                findings.push(f);
+            }
+        }
+        catch (error) {
+            findings.push({
+                rule: "tool.rule-error",
+                severity: "info",
+                category: "tool",
+                message: `Rule ${rule.meta.id} failed: ${error instanceof Error ? error.message : String(error)}`,
+                recommendation: "Report this as a bug at https://github.com/rivi-software/agentic-seo-check/issues; the rest of the audit is unaffected.",
+                url: ctx.page.url,
+            });
+        }
+    }
+    return sortFindings(findings);
+};
+export const findRule = (id) => ALL_RULES.find((r) => r.id === id);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { ExtractedPage, ResponseInfo } from "../types.js";
+export interface RobotsDirectives {
+    noindex: boolean;
+    nofollow: boolean;
+    sources: string[];
+    directives: string[];
+}
+/** Combine <meta name="robots"> / googlebot and the X-Robots-Tag header. */
+export declare const robotsDirectives: (page: ExtractedPage, response?: ResponseInfo) => RobotsDirectives;
+export declare const indexingRules: import("./rule.js").Rule[];

package/dist/core/rules/indexing.js

@@ -0,0 +1,75 @@
+import { defineRule, GOOGLE_DOCS } from "./rule.js";
+/** Combine <meta name="robots"> / googlebot and the X-Robots-Tag header. */
+export const robotsDirectives = (page, response) => {
+    const directives = [];
+    const sources = [];
+    for (const content of page.metaRobots) {
+        for (const d of content
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)) {
+            directives.push(d);
+            sources.push("meta");
+        }
+    }
+    const header = response?.headers["x-robots-tag"];
+    if (header) {
+        for (const d of header
+            .toLowerCase()
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)) {
+            // "googlebot: noindex" form
+            directives.push(d.includes(":") ? (d.split(":").pop() ?? d).trim() : d);
+            sources.push("header");
+        }
+    }
+    const noindex = directives.some((d) => d === "noindex" || d === "none");
+    const nofollow = directives.some((d) => d === "nofollow" || d === "none");
+    return {
+        noindex,
+        nofollow,
+        sources: [...new Set(sources)],
+        directives: [...new Set(directives)],
+    };
+};
+export const indexingRules = [
+    defineRule({
+        id: "robots.noindex",
+        category: "indexing",
+        severity: "warning",
+        description: "The page tells search engines not to index it (meta robots or X-Robots-Tag).",
+        recommendation: "If this page should appear in search results, remove the noindex directive. Preview/staging hosts often add X-Robots-Tag: noindex at the platform level; verify on production. If the page is intentionally private (login, thank-you, internal search), this is correct.",
+        docs: GOOGLE_DOCS.robotsMeta,
+    }, ({ page, response }, make) => {
+        const r = robotsDirectives(page, response);
+        return r.noindex
+            ? make(`Page is set to noindex via ${r.sources.join(" and ")}.`, {
+                selector: r.sources.includes("meta")
+                    ? 'head > meta[name="robots"]'
+                    : undefined,
+                evidence: {
+                    directives: r.directives,
+                    sources: r.sources,
+                    xRobotsTag: response?.headers["x-robots-tag"] ?? null,
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "robots.nofollow",
+        category: "indexing",
+        severity: "info",
+        description: "The page tells search engines not to follow its links.",
+        recommendation: "Remove nofollow unless you deliberately want link equity to stop at this page; it also hides linked pages from discovery.",
+        docs: GOOGLE_DOCS.robotsMeta,
+    }, ({ page, response }, make) => {
+        const r = robotsDirectives(page, response);
+        return r.nofollow
+            ? make(`Page-level nofollow is set via ${r.sources.join(" and ")}.`, {
+                evidence: { directives: r.directives },
+            })
+            : null;
+    }),
+];
+//# sourceMappingURL=indexing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.js","sourceRoot":"","sources":["../../../src/core/rules/indexing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AASpD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,IAAmB,EACnB,QAAuB,EACL,EAAE;IACpB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,OAAO;aACpB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjD,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,IAAI,MAAM;aACnB,WAAW,EAAE;aACb,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACnB,4BAA4B;YAC5B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC;IAE1E,OAAO;QACL,OAAO;QACP,QAAQ;QACR,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9B,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;KACrC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU,CACR;QACE,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,SAAS;QACnB,WAAW,EACT,8EAA8E;QAChF,cAAc,EACZ,2QAA2Q;QAC7Q,IAAI,EAAE,WAAW,CAAC,UAAU;KAC7B,EACD,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAE3C,OAAO,CAAC,CAAC,OAAO;YACd,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC7D,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAClC,CAAC,CAAC,4BAA4B;oBAC9B,CAAC,CAAC,SAAS;gBACb,QAAQ,EAAE;oBACR,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,IAAI,IAAI;iBACtD;aACF,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC;IACX,CAAC,CACF;IACD,UAAU,CACR;QACE,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,wDAAwD;QACrE,cAAc,EACZ,2HAA2H;QAC7H,IAAI,EAAE,WAAW,CAAC,UAAU;KAC7B,EACD,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAE3C,OAAO,CAAC,CAAC,QAAQ;YACf,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBACjE,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE;aACvC,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC;IACX,CAAC,CACF;CACF,CAAC"}

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

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

package/dist/core/rules/keyword.js

@@ -0,0 +1,111 @@
+import { includesKeyword, keywordOccurrences, normalizeForComparison, words, } from "../html/text.js";
+import { defineRule } from "./rule.js";
+export const keywordRules = [
+    defineRule({
+        id: "keyword.not-in-title",
+        category: "keyword",
+        severity: "warning",
+        description: "The target keyword does not appear in the title.",
+        recommendation: "Include the target keyword (or a close variant) near the start of the title.",
+        requires: "keyword",
+    }, ({ page, keyword }, make) => keyword && !includesKeyword(page.title, keyword)
+        ? make(`Title does not contain "${keyword}".`, {
+            selector: "head > title",
+            evidence: { title: page.title, keyword },
+        })
+        : null),
+    defineRule({
+        id: "keyword.not-in-h1",
+        category: "keyword",
+        severity: "warning",
+        description: "The target keyword does not appear in any H1.",
+        recommendation: "Use the target keyword in the H1 so the main heading matches the search intent.",
+        requires: "keyword",
+    }, ({ page, keyword }, make) => keyword &&
+        page.h1s.length > 0 &&
+        !page.h1s.some((h) => includesKeyword(h, keyword))
+        ? make(`No <h1> contains "${keyword}".`, {
+            selector: "h1",
+            evidence: { h1s: page.h1s, keyword },
+        })
+        : null),
+    defineRule({
+        id: "keyword.not-in-description",
+        category: "keyword",
+        severity: "info",
+        description: "The target keyword does not appear in the meta description.",
+        recommendation: "Mention the keyword in the meta description; matching terms are bolded in search snippets.",
+        requires: "keyword",
+    }, ({ page, keyword }, make) => keyword &&
+        page.metaDescription &&
+        !includesKeyword(page.metaDescription, keyword)
+        ? make(`Meta description does not contain "${keyword}".`, {
+            selector: 'head > meta[name="description"]',
+            evidence: { keyword },
+        })
+        : null),
+    defineRule({
+        id: "keyword.not-in-body",
+        category: "keyword",
+        severity: "warning",
+        description: "The target keyword does not appear in the visible body text.",
+        recommendation: "Use the keyword naturally in the body copy, ideally in the first paragraph.",
+        requires: "keyword",
+    }, ({ page, keyword }, make) => keyword &&
+        page.wordCount > 0 &&
+        keywordOccurrences(page.text, keyword) === 0
+        ? make(`Body text does not contain "${keyword}".`, {
+            evidence: { keyword, wordCount: page.wordCount },
+        })
+        : null),
+    defineRule({
+        id: "keyword.not-in-url",
+        category: "keyword",
+        severity: "info",
+        description: "The target keyword does not appear in the URL path.",
+        recommendation: "Where the URL is still changeable, use a short slug containing the keyword (hyphen-separated).",
+        requires: "keyword",
+    }, ({ page, keyword, source }, make) => {
+        if (!keyword || source === "html") {
+            return null;
+        }
+        let pathname = page.url;
+        try {
+            pathname = decodeURIComponent(new URL(page.url).pathname);
+        }
+        catch {
+            /* keep */
+        }
+        const slug = pathname.replaceAll(/[-_/.+]+/gu, " ");
+        return includesKeyword(slug, keyword)
+            ? null
+            : make(`URL path does not contain "${keyword}".`, {
+                evidence: { path: pathname, keyword },
+            });
+    }),
+    defineRule({
+        id: "keyword.density-high",
+        category: "keyword",
+        severity: "info",
+        description: "The target keyword makes up an unusually large share of the body text (default > 3%).",
+        recommendation: "Reduce repetition; write for readers and use synonyms. Keyword stuffing can trigger spam filters.",
+        requires: "keyword",
+    }, ({ page, keyword, thresholds }, make) => {
+        if (!keyword || page.wordCount < 50) {
+            return null;
+        }
+        const occurrences = keywordOccurrences(page.text, keyword);
+        const kwWords = words(normalizeForComparison(keyword)).length || 1;
+        const density = ((occurrences * kwWords) / page.wordCount) * 100;
+        return density > thresholds.maxKeywordDensityPercent
+            ? make(`Keyword density is ${density.toFixed(1)}% (${occurrences} occurrences in ${page.wordCount} words).`, {
+                evidence: {
+                    occurrences,
+                    wordCount: page.wordCount,
+                    densityPercent: Number(density.toFixed(2)),
+                },
+            })
+            : null;
+    }),
+];
+//# sourceMappingURL=keyword.js.map

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

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

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

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