@rivi-software/agentic-seo-check 0.1.0 → 0.1.1

package/dist/core/rules/keyword.js

@@ -1,48 +1,74 @@
-import { includesKeyword, keywordOccurrences, normalizeForComparison, words } from '../html/text.js';
-import { defineRule } from './rule.js';
+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)),
+        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)),
+        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)),
+        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)),
+        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',
+        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')
+        if (!keyword || source === "html") {
             return null;
+        }
         let pathname = page.url;
         try {
             pathname = decodeURIComponent(new URL(page.url).pathname);
@@ -50,24 +76,35 @@ export const keywordRules = [
         catch {
             /* keep */
         }
-        const slug = pathname.replace(/[-_/.+]+/g, ' ');
-        return includesKeyword(slug, keyword) ? null : make(`URL path does not contain "${keyword}".`, { evidence: { path: pathname, keyword } });
+        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',
+        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)
+        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)) } })
+            ? make(`Keyword density is ${density.toFixed(1)}% (${occurrences} occurrences in ${page.wordCount} words).`, {
+                evidence: {
+                    occurrences,
+                    wordCount: page.wordCount,
+                    densityPercent: Number(density.toFixed(2)),
+                },
+            })
             : null;
     }),
 ];

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

@@ -1 +1 @@
-{"version":3,"file":"keyword.js","sourceRoot":"","sources":["../../../src/core/rules/keyword.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,CACR;QACE,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,kDAAkD;QAC/D,cAAc,EAAE,8EAA8E;QAC9F,QAAQ,EAAE,SAAS;KACpB,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,OAAO,IAAI,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9M;IACD,UAAU,CACR;QACE,EAAE,EAAE,mBAAmB;QACvB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,+CAA+C;QAC5D,cAAc,EAAE,iFAAiF;QACjG,QAAQ,EAAE,SAAS;KACpB,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,OAAO,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9N;IACD,UAAU,CACR;QACE,EAAE,EAAE,4BAA4B;QAChC,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,6DAA6D;QAC1E,cAAc,EAAE,4FAA4F;QAC5G,QAAQ,EAAE,SAAS;KACpB,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,sCAAsC,OAAO,IAAI,EAAE,EAAE,QAAQ,EAAE,iCAAiC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAC3P;IACD,UAAU,CACR;QACE,EAAE,EAAE,qBAAqB;QACzB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,8DAA8D;QAC3E,cAAc,EAAE,6EAA6E;QAC7F,QAAQ,EAAE,SAAS;KACpB,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,+BAA+B,OAAO,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7N;IACD,UAAU,CACR;QACE,EAAE,EAAE,oBAAoB;QACxB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,qDAAqD;QAClE,cAAc,EAAE,gGAAgG;QAChH,QAAQ,EAAE,SAAS;KACpB,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE;QAClC,IAAI,CAAC,OAAO,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAC/C,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC;YACH,QAAQ,GAAG,kBAAkB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,UAAU;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAChD,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,OAAO,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5I,CAAC,CACF;IACD,UAAU,CACR;QACE,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,uFAAuF;QACpG,cAAc,EAAE,mGAAmG;QACnH,QAAQ,EAAE,SAAS;KACpB,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE;QACtC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,GAAG,EAAE;YAAE,OAAO,IAAI,CAAC;QACjD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;QACjE,OAAO,OAAO,GAAG,UAAU,CAAC,wBAAwB;YAClD,CAAC,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,WAAW,mBAAmB,IAAI,CAAC,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAClN,CAAC,CAAC,IAAI,CAAC;IACX,CAAC,CACF;CACF,CAAC"}
+{"version":3,"file":"keyword.js","sourceRoot":"","sources":["../../../src/core/rules/keyword.ts"],"names":[],"mappings":"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"}

package/dist/core/rules/links.js

@@ -1,72 +1,107 @@
-import { isGenericAnchor } from '../html/text.js';
-import { cap, defineRule, GOOGLE_DOCS } from './rule.js';
+import { isGenericAnchor } from "../html/text.js";
+import { cap, defineRule, GOOGLE_DOCS } from "./rule.js";
 export const linkRules = [
     defineRule({
-        id: 'links.no-internal',
-        category: 'links',
-        severity: 'warning',
-        description: 'The page has no internal links, so crawlers cannot reach other pages from it and it passes no authority onward.',
-        recommendation: 'Link to related pages and the main navigation with plain <a href> elements.',
+        id: "links.no-internal",
+        category: "links",
+        severity: "warning",
+        description: "The page has no internal links, so crawlers cannot reach other pages from it and it passes no authority onward.",
+        recommendation: "Link to related pages and the main navigation with plain <a href> elements.",
         docs: GOOGLE_DOCS.links,
-    }, ({ page }, make) => (page.links.some((l) => l.internal) ? null : make('Page contains no internal links.', { evidence: { totalLinks: page.links.length } }))),
+    }, ({ page }, make) => page.links.some((l) => l.internal)
+        ? null
+        : make("Page contains no internal links.", {
+            evidence: { totalLinks: page.links.length },
+        })),
     defineRule({
-        id: 'links.empty-anchor',
-        category: 'links',
-        severity: 'warning',
-        description: 'Links without any accessible name (no text, aria-label, title or image alt).',
-        recommendation: 'Add descriptive link text, or aria-label for icon links. Empty links tell crawlers nothing about the target page.',
+        id: "links.empty-anchor",
+        category: "links",
+        severity: "warning",
+        description: "Links without any accessible name (no text, aria-label, title or image alt).",
+        recommendation: "Add descriptive link text, or aria-label for icon links. Empty links tell crawlers nothing about the target page.",
         docs: GOOGLE_DOCS.links,
     }, ({ page }, make) => {
         const empty = page.links.filter((l) => l.url && !l.hasAccessibleName);
-        return empty.length ? make(`${empty.length} link(s) have no accessible text.`, { evidence: { count: empty.length, examples: cap(empty.map((l) => l.href)) } }) : null;
+        return empty.length
+            ? make(`${empty.length} link(s) have no accessible text.`, {
+                evidence: {
+                    count: empty.length,
+                    examples: cap(empty.map((l) => l.href)),
+                },
+            })
+            : null;
     }),
     defineRule({
-        id: 'links.generic-anchor-text',
-        category: 'links',
-        severity: 'info',
+        id: "links.generic-anchor-text",
+        category: "links",
+        severity: "info",
         description: 'Links whose text is generic ("click here", "read more", "learn more").',
         recommendation: 'Use anchor text that describes the destination, e.g. "pricing plans" instead of "click here".',
         docs: GOOGLE_DOCS.links,
     }, ({ page }, make) => {
         const generic = page.links.filter((l) => l.url && l.text && isGenericAnchor(l.text));
         return generic.length
-            ? make(`${generic.length} link(s) use generic anchor text.`, { evidence: { count: generic.length, examples: cap(generic.map((l) => ({ text: l.text, href: l.href }))) } })
+            ? make(`${generic.length} link(s) use generic anchor text.`, {
+                evidence: {
+                    count: generic.length,
+                    examples: cap(generic.map((l) => ({ text: l.text, href: l.href }))),
+                },
+            })
             : null;
     }),
     defineRule({
-        id: 'links.uncrawlable-href',
-        category: 'links',
-        severity: 'info',
+        id: "links.uncrawlable-href",
+        category: "links",
+        severity: "info",
         description: 'Anchors whose href is "#", empty, or a javascript: URL. Crawlers cannot follow them.',
-        recommendation: 'Use <button> for actions. For navigation, give the anchor a real URL even when JavaScript intercepts the click.',
+        recommendation: "Use <button> for actions. For navigation, give the anchor a real URL even when JavaScript intercepts the click.",
         docs: GOOGLE_DOCS.links,
     }, ({ page }, make) => {
-        const bad = page.links.filter((l) => l.href === '' || l.href === '#' || /^javascript:/i.test(l.href));
-        return bad.length ? make(`${bad.length} anchor(s) have an uncrawlable href.`, { evidence: { count: bad.length, examples: cap(bad.map((l) => ({ href: l.href, text: l.text }))) } }) : null;
+        const bad = page.links.filter((l) => l.href === "" || l.href === "#" || /^javascript:/iu.test(l.href));
+        return bad.length
+            ? make(`${bad.length} anchor(s) have an uncrawlable href.`, {
+                evidence: {
+                    count: bad.length,
+                    examples: cap(bad.map((l) => ({ href: l.href, text: l.text }))),
+                },
+            })
+            : null;
     }),
     defineRule({
-        id: 'links.insecure-internal',
-        category: 'links',
-        severity: 'warning',
-        description: 'Internal links use http:// while the page is served over https://.',
-        recommendation: 'Update internal links to https:// (or use relative URLs) to avoid an extra redirect on every click and crawl.',
+        id: "links.insecure-internal",
+        category: "links",
+        severity: "warning",
+        description: "Internal links use http:// while the page is served over https://.",
+        recommendation: "Update internal links to https:// (or use relative URLs) to avoid an extra redirect on every click and crawl.",
         docs: GOOGLE_DOCS.redirects,
     }, ({ page, source }, make) => {
-        if (source !== 'url' || !page.url.startsWith('https://'))
+        if (source !== "url" || !page.url.startsWith("https://")) {
             return null;
-        const insecure = page.links.filter((l) => l.internal && l.url?.startsWith('http://'));
-        return insecure.length ? make(`${insecure.length} internal link(s) point to http:// URLs.`, { evidence: { count: insecure.length, examples: cap(insecure.map((l) => l.url)) } }) : null;
+        }
+        const insecure = page.links.filter((l) => l.internal && l.url?.startsWith("http://"));
+        return insecure.length
+            ? make(`${insecure.length} internal link(s) point to http:// URLs.`, {
+                evidence: {
+                    count: insecure.length,
+                    examples: cap(insecure.map((l) => l.url)),
+                },
+            })
+            : null;
     }),
     defineRule({
-        id: 'links.nofollow-internal',
-        category: 'links',
-        severity: 'info',
+        id: "links.nofollow-internal",
+        category: "links",
+        severity: "info",
         description: 'Internal links carry rel="nofollow".',
-        recommendation: 'Remove nofollow from internal links unless the target is intentionally kept out of the index; nofollow on internal links wastes crawl signals.',
+        recommendation: "Remove nofollow from internal links unless the target is intentionally kept out of the index; nofollow on internal links wastes crawl signals.",
         docs: GOOGLE_DOCS.links,
     }, ({ page }, make) => {
         const nf = page.links.filter((l) => l.internal && l.nofollow);
-        return nf.length ? make(`${nf.length} internal link(s) are rel="nofollow".`, { evidence: { count: nf.length, examples: cap(nf.map((l) => l.url)) } }) : null;
+        return nf.length
+            ? make(`${nf.length} internal link(s) are rel="nofollow".`, {
+                evidence: { count: nf.length, examples: cap(nf.map((l) => l.url)) },
+            })
+            : null;
     }),
 ];
 //# sourceMappingURL=links.js.map

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

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

package/dist/core/rules/meta.js

@@ -1,60 +1,81 @@
-import { normalizeForComparison } from '../html/text.js';
-import { defineRule, GOOGLE_DOCS } from './rule.js';
+import { normalizeForComparison } from "../html/text.js";
+import { defineRule, GOOGLE_DOCS } from "./rule.js";
 const SELECTOR = 'head > meta[name="description"]';
 export const metaRules = [
     defineRule({
-        id: 'meta-description.missing',
-        category: 'meta',
-        severity: 'warning',
+        id: "meta-description.missing",
+        category: "meta",
+        severity: "warning",
         description: 'No <meta name="description"> is present or it is empty.',
-        recommendation: 'Add a unique meta description (about 70-160 characters) that summarises the page and invites the click. Search engines may show it as the snippet.',
+        recommendation: "Add a unique meta description (about 70-160 characters) that summarises the page and invites the click. Search engines may show it as the snippet.",
         docs: GOOGLE_DOCS.snippets,
-    }, ({ page }, make) => (page.metaDescription ? null : make('Page has no meta description.', { selector: SELECTOR }))),
+    }, ({ page }, make) => page.metaDescription
+        ? null
+        : make("Page has no meta description.", { selector: SELECTOR })),
     defineRule({
-        id: 'meta-description.multiple',
-        category: 'meta',
-        severity: 'warning',
-        description: 'More than one meta description is present.',
-        recommendation: 'Keep a single meta description; remove or merge the others.',
+        id: "meta-description.multiple",
+        category: "meta",
+        severity: "warning",
+        description: "More than one meta description is present.",
+        recommendation: "Keep a single meta description; remove or merge the others.",
         docs: GOOGLE_DOCS.snippets,
     }, ({ page }, make) => page.metaDescriptions.length > 1
-        ? make(`Page has ${page.metaDescriptions.length} meta description tags.`, { selector: SELECTOR, evidence: { descriptions: page.metaDescriptions } })
+        ? make(`Page has ${page.metaDescriptions.length} meta description tags.`, {
+            selector: SELECTOR,
+            evidence: { descriptions: page.metaDescriptions },
+        })
         : null),
     defineRule({
-        id: 'meta-description.too-long',
-        category: 'meta',
-        severity: 'warning',
-        description: 'Meta description exceeds the configured maximum (default 160 characters) and will be truncated.',
-        recommendation: 'Trim the description to about 160 characters, front-loading the key message.',
+        id: "meta-description.too-long",
+        category: "meta",
+        severity: "warning",
+        description: "Meta description exceeds the configured maximum (default 160 characters) and will be truncated.",
+        recommendation: "Trim the description to about 160 characters, front-loading the key message.",
         docs: GOOGLE_DOCS.snippets,
-    }, ({ page, thresholds }, make) => page.metaDescription && page.metaDescription.length > thresholds.descriptionMaxChars
+    }, ({ page, thresholds }, make) => page.metaDescription &&
+        page.metaDescription.length > thresholds.descriptionMaxChars
         ? make(`Meta description is ${page.metaDescription.length} characters (max ${thresholds.descriptionMaxChars}).`, {
             selector: SELECTOR,
-            evidence: { description: page.metaDescription, length: page.metaDescription.length, max: thresholds.descriptionMaxChars },
+            evidence: {
+                description: page.metaDescription,
+                length: page.metaDescription.length,
+                max: thresholds.descriptionMaxChars,
+            },
         })
         : null),
     defineRule({
-        id: 'meta-description.too-short',
-        category: 'meta',
-        severity: 'info',
-        description: 'Meta description is shorter than the configured minimum (default 70 characters).',
-        recommendation: 'Expand the description so it summarises the page content and its value to the visitor.',
+        id: "meta-description.too-short",
+        category: "meta",
+        severity: "info",
+        description: "Meta description is shorter than the configured minimum (default 70 characters).",
+        recommendation: "Expand the description so it summarises the page content and its value to the visitor.",
         docs: GOOGLE_DOCS.snippets,
-    }, ({ page, thresholds }, make) => page.metaDescription && page.metaDescription.length < thresholds.descriptionMinChars
+    }, ({ page, thresholds }, make) => page.metaDescription &&
+        page.metaDescription.length < thresholds.descriptionMinChars
         ? make(`Meta description is only ${page.metaDescription.length} characters (recommended at least ${thresholds.descriptionMinChars}).`, {
             selector: SELECTOR,
-            evidence: { description: page.metaDescription, length: page.metaDescription.length, min: thresholds.descriptionMinChars },
+            evidence: {
+                description: page.metaDescription,
+                length: page.metaDescription.length,
+                min: thresholds.descriptionMinChars,
+            },
         })
         : null),
     defineRule({
-        id: 'meta-description.same-as-title',
-        category: 'meta',
-        severity: 'info',
-        description: 'Meta description is identical to the title.',
-        recommendation: 'Write a description that adds information beyond the title instead of repeating it.',
+        id: "meta-description.same-as-title",
+        category: "meta",
+        severity: "info",
+        description: "Meta description is identical to the title.",
+        recommendation: "Write a description that adds information beyond the title instead of repeating it.",
         docs: GOOGLE_DOCS.snippets,
-    }, ({ page }, make) => page.metaDescription && page.title && normalizeForComparison(page.metaDescription) === normalizeForComparison(page.title)
-        ? make('Meta description repeats the title verbatim.', { selector: SELECTOR, evidence: { title: page.title } })
+    }, ({ page }, make) => page.metaDescription &&
+        page.title &&
+        normalizeForComparison(page.metaDescription) ===
+            normalizeForComparison(page.title)
+        ? make("Meta description repeats the title verbatim.", {
+            selector: SELECTOR,
+            evidence: { title: page.title },
+        })
         : null),
 ];
 //# sourceMappingURL=meta.js.map

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

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