@rivi-software/agentic-seo-check 0.4.0 → 0.5.0

package/dist/core/rules/keyword.js

@@ -1,5 +1,83 @@
 import { includesKeyword, keywordOccurrences, normalizeForComparison, words, } from "../html/text.js";
+import { addHtml, replaceHtml, setAttributeEdit, slot, withContent, } from "./fix.js";
+import { bestBlock, permanentRedirect, rewriteBlock, statusLine, } from "./page-fixes.js";
 import { defineRule } from "./rule.js";
+/** The <title> search engines read rewritten around the keyword, or a new one when the page has none. */
+const titleEdit = (page, keyword) => {
+    const index = page.title === null ? -1 : page.titles.indexOf(page.title);
+    const tag = page.markup.titles[Math.max(index, 0)];
+    const content = slot("title with the keyword");
+    const write = `A title of 30-60 characters with "${keyword}" (or a close variant) near the start.`;
+    return tag === undefined
+        ? addHtml("head", `<title>${content}</title>`, write)
+        : replaceHtml(tag, withContent(tag, content) ?? `<title>${content}</title>`, {
+            at: "head > title",
+            write,
+        });
+};
+/** The first <h1>, rewritten around the keyword. */
+const h1Edit = (page, keyword) => {
+    const index = page.headings.findIndex((h) => h.level === 1);
+    const tag = page.markup.headings[index];
+    const content = slot("heading with the keyword");
+    const write = `The page's main heading, using "${keyword}" the way a visitor would say it.`;
+    return tag === undefined
+        ? addHtml("main, body", `<h1>${content}</h1>`, write)
+        : replaceHtml(tag, withContent(tag, content) ?? `<h1>${content}</h1>`, {
+            at: "h1",
+            write,
+        });
+};
+/** A path segment for the keyword: lowercase words joined with hyphens. */
+const slugOf = (keyword) => words(normalizeForComparison(keyword))
+    .join("-")
+    .replaceAll(/[^\p{L}\p{N}-]/gu, "");
+/**
+ * The page moved to a path with the keyword in it. Renaming an indexed URL costs what search
+ * engines know about it, so the edit says to do it only for a new page.
+ */
+const urlEdits = (page, source, status, keyword) => {
+    let url;
+    try {
+        url = new URL(page.url);
+    }
+    catch {
+        return [
+            addHtml("body", slot("page at a path with the keyword"), `Serve the page at a path with "${keyword}" in it, such as /${slugOf(keyword)}/, if it is not indexed yet.`),
+        ];
+    }
+    const segments = url.pathname.split("/");
+    const last = segments.findLastIndex(Boolean);
+    const slug = slugOf(keyword);
+    // The home page keeps "/": the topic gets a page of its own, linked from it.
+    if (last === -1) {
+        return [
+            addHtml("nav, main", `<a href="/${slug}/">${slot("link text")}</a>`, `A home page's URL stays "/". Give "${keyword}" a page of its own at /${slug}/ and link to it with words a visitor would click.`),
+        ];
+    }
+    segments[last] = slug;
+    const moved = new URL(segments.join("/"), url).href;
+    return [
+        {
+            in: "http",
+            action: "replace",
+            at: "status line",
+            current: statusLine(status ?? 200),
+            code: permanentRedirect(source === "url" ? moved : new URL(moved).pathname),
+            write: `Only for a page that is not indexed or linked to yet: serve it at ${new URL(moved).pathname} and redirect the old path there. Leave an indexed URL as it is; a rename resets what search engines know about the page.`,
+        },
+    ];
+};
+/**
+ * The paragraph that repeats the keyword most, rewritten whole; when no block holds it, new copy,
+ * since words cut from the joined page text would not be in the source as written.
+ */
+const densityFix = (page, keyword, maxPercent) => {
+    const block = bestBlock(page.markup.blocks, (b) => keywordOccurrences(b.text, keyword));
+    return block
+        ? rewriteBlock(block, "the same paragraph, the keyword fewer times", `Write "${keyword}" fewer times: use a synonym, a pronoun or nothing, as a reader would write it. Do the same in other paragraphs until it is under ${maxPercent}% of the words.`)
+        : addHtml("body", slot("copy with fewer repetitions"), `Rewrite the copy so "${keyword}" is under ${maxPercent}% of the words.`);
+};
 export const keywordRules = [
     defineRule({
         id: "keyword.not-in-title",
@@ -10,6 +88,7 @@ export const keywordRules = [
         requires: "keyword",
     }, ({ page, keyword }, make) => keyword && !includesKeyword(page.title, keyword)
         ? make(`Title does not contain "${keyword}".`, {
+            fix: [titleEdit(page, keyword)],
             selector: "head > title",
             evidence: { title: page.title, keyword },
         })
@@ -25,6 +104,7 @@ export const keywordRules = [
         page.h1s.length > 0 &&
         !page.h1s.some((h) => includesKeyword(h, keyword))
         ? make(`No <h1> contains "${keyword}".`, {
+            fix: [h1Edit(page, keyword)],
             selector: "h1",
             evidence: { h1s: page.h1s, keyword },
         })
@@ -40,6 +120,9 @@ export const keywordRules = [
         page.metaDescription &&
         !includesKeyword(page.metaDescription, keyword)
         ? make(`Meta description does not contain "${keyword}".`, {
+            fix: [
+                setAttributeEdit(page.markup.metaDescriptions[Math.max(page.metaDescriptions.indexOf(page.metaDescription), 0)] ?? null, 'head > meta[name="description"]', "content", slot("description with the keyword"), `The description (70-160 characters) with "${keyword}" worked in where it reads naturally; search engines bold the words a searcher typed.`),
+            ],
             selector: 'head > meta[name="description"]',
             evidence: { description: page.metaDescription, keyword },
         })
@@ -55,6 +138,9 @@ export const keywordRules = [
         page.wordCount > 0 &&
         keywordOccurrences(page.text, keyword) === 0
         ? make(`Body text does not contain "${keyword}".`, {
+            fix: [
+                addHtml("main p, body p", slot("sentence with the keyword"), `A sentence in the first paragraph that uses "${keyword}" naturally, as part of what the page says.`),
+            ],
             evidence: { keyword, wordCount: page.wordCount },
         })
         : null),
@@ -65,7 +151,7 @@ export const keywordRules = [
         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) => {
+    }, ({ page, keyword, source, response }, make) => {
         if (!keyword || source === "html") {
             return null;
         }
@@ -80,6 +166,7 @@ export const keywordRules = [
         return includesKeyword(slug, keyword)
             ? null
             : make(`URL path does not contain "${keyword}".`, {
+                fix: urlEdits(page, source, response?.status ?? null, keyword),
                 evidence: { path: pathname, keyword },
             });
     }),
@@ -99,6 +186,9 @@ export const keywordRules = [
         const density = ((occurrences * kwWords) / page.wordCount) * 100;
         return density > thresholds.maxKeywordDensityPercent
             ? make(`Keyword density is ${density.toFixed(1)}% (${occurrences} occurrences in ${page.wordCount} words).`, {
+                fix: [
+                    densityFix(page, keyword, thresholds.maxKeywordDensityPercent),
+                ],
                 evidence: {
                     occurrences,
                     wordCount: page.wordCount,

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

@@ -1 +1 @@
-{"version":3,"file":"keyword.js","sourceRoot":"","sources":["../../../src/core/rules/keyword.ts"],"names":[],"mappings":"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"}
+{"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,5 +1,24 @@
 import { isGenericAnchor } from "../html/text.js";
+import { addHtml, escapeAttribute, replaceHtml, setAttributeEdit, slot, withContent, withoutAttribute, } from "./fix.js";
+import { withAttributeSelector } from "./quoted-tags.js";
 import { cap, defineRule, GOOGLE_DOCS } from "./rule.js";
+/** The selector of one link, by its href as written. */
+const linkAt = (link) => withAttributeSelector("a", "href", link.href);
+/** The link's start tag with rel="nofollow" taken out, keeping its other rel values. */
+const withoutNofollow = (link) => {
+    const rel = (link.rel ?? "")
+        .split(/\s+/u)
+        .filter((token) => token && token.toLowerCase() !== "nofollow");
+    const at = linkAt(link);
+    const write = "Unless the target page is kept out of search on purpose; then link to it less, or noindex it.";
+    if (rel.length > 0) {
+        return setAttributeEdit(link.tag, at, "rel", escapeAttribute(rel.join(" ")), write);
+    }
+    const code = withoutAttribute(link.tag, "rel");
+    return code
+        ? replaceHtml(link.tag, code, { at, write })
+        : setAttributeEdit(null, at, "rel", "", write);
+};
 export const linkRules = [
     defineRule({
         id: "links.no-internal",
@@ -11,6 +30,9 @@ export const linkRules = [
     }, ({ page }, make) => page.links.some((l) => l.internal)
         ? null
         : make("Page contains no internal links.", {
+            fix: [
+                addHtml("body", `<a href="${slot("/path-of-a-related-page/")}">${slot("its name")}</a>`, "A plain <a href> to a page of this site a visitor would want next, with text that names it; the site's navigation or footer with links to the main sections does the same for every page. The href is a path on this site (/pricing/), not a JavaScript click handler."),
+            ],
             evidence: { totalLinks: page.links.length },
         })),
     defineRule({
@@ -24,6 +46,7 @@ export const linkRules = [
         const empty = page.links.filter((l) => l.url && !l.hasAccessibleName);
         return empty.length
             ? make(`${empty.length} link(s) have no accessible text.`, {
+                fix: empty.map((l) => setAttributeEdit(l.tag, linkAt(l), "aria-label", slot("where the link goes"), `What the link to ${l.href.slice(0, 120)} leads to, in a few words ("Instagram", "Cart"). Visible text inside the link does the same and also gives search engines anchor text.`)),
                 evidence: {
                     count: empty.length,
                     examples: cap(empty.map((l) => l.href)),
@@ -40,8 +63,20 @@ export const linkRules = [
         docs: GOOGLE_DOCS.links,
     }, ({ page }, make) => {
         const generic = page.links.filter((l) => l.url && l.text && isGenericAnchor(l.text));
+        // The whole link as written; when it was cut short, its text, with `at` saying which link.
+        const fix = generic.map((l) => {
+            const write = `Text that names the destination of ${l.href.slice(0, 120)}, such as "pricing plans" instead of "${l.text.slice(0, 40)}".`;
+            const rewritten = withContent(l.outer, slot("what the link leads to"));
+            return rewritten
+                ? replaceHtml(l.outer, rewritten, { at: linkAt(l), write })
+                : replaceHtml(l.text, slot("what the link leads to"), {
+                    at: linkAt(l),
+                    write,
+                });
+        });
         return generic.length
             ? make(`${generic.length} link(s) use generic anchor text.`, {
+                fix,
                 evidence: {
                     count: generic.length,
                     examples: cap(generic.map((l) => ({ text: l.text, href: l.href }))),
@@ -60,6 +95,7 @@ export const linkRules = [
         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.`, {
+                fix: bad.map((l) => setAttributeEdit(l.tag, linkAt(l), "href", slot("URL the link opens"), `The URL of the page this link opens, even when JavaScript handles the click. If it runs an action instead of opening a page${l.text ? ` ("${l.text.slice(0, 40)}")` : ""}, make it a <button type="button"> and its </a> a </button>.`)),
                 evidence: {
                     count: bad.length,
                     examples: cap(bad.map((l) => ({ href: l.href, text: l.text }))),
@@ -79,8 +115,13 @@ export const linkRules = [
             return null;
         }
         const insecure = page.links.filter((l) => l.internal && l.url?.startsWith("http://"));
+        // The href as written with https; one that is not written as http:// gets the full URL.
+        const fix = insecure.map((l) => setAttributeEdit(l.tag, linkAt(l), "href", escapeAttribute(/^http:/iu.test(l.href)
+            ? l.href.replace(/^http:/iu, "https:")
+            : (l.url ?? l.href).replace(/^http:/iu, "https:"))));
         return insecure.length
             ? make(`${insecure.length} internal link(s) point to http:// URLs.`, {
+                fix,
                 evidence: {
                     count: insecure.length,
                     examples: cap(insecure.map((l) => l.url)),
@@ -99,6 +140,7 @@ export const linkRules = [
         const nf = page.links.filter((l) => l.internal && l.nofollow);
         return nf.length
             ? make(`${nf.length} internal link(s) are rel="nofollow".`, {
+                fix: nf.map((l) => withoutNofollow(l)),
                 evidence: { count: nf.length, examples: cap(nf.map((l) => l.url)) },
             })
             : null;

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/loading.js

@@ -1,6 +1,25 @@
 import { isHomePage } from "../aeo/page.js";
 import { isLocalHost } from "./canonical.js";
+import { addEdit, addHtml, escapeAttribute, replaceHtml, setAttributeEdit, slot, withAttribute, withoutAttribute, } from "./fix.js";
 import { cap, defineRule } from "./rule.js";
+/** A selector for an image by its src, for an edit that cannot quote the tag. */
+const imageAt = (image) => image.src ? `img[src="${image.src.replaceAll('"', String.raw `\"`)}"]` : "img";
+/**
+ * The edit that takes loading="lazy" off an image and, for the main image, asks the browser to
+ * fetch it first.
+ */
+const eagerEdit = (image, priority) => {
+    const withoutLazy = withoutAttribute(image.tag, "loading");
+    const rewritten = withoutLazy && priority
+        ? withAttribute(withoutLazy, "fetchpriority", "high")
+        : withoutLazy;
+    if (rewritten) {
+        return replaceHtml(image.tag, rewritten, { at: imageAt(image) });
+    }
+    return addHtml(imageAt(image), priority ? 'fetchpriority="high"' : 'loading="eager"', priority
+        ? 'Set this attribute and delete loading="lazy" from the image.'
+        : 'This replaces loading="lazy" on the image.');
+};
 /** Below this size compression saves less than the request costs (Lighthouse's own cut-off). */
 const MIN_COMPRESSIBLE_BYTES = 1400;
 /** An image shown before this many words of text is likely in the first screen. */
@@ -23,6 +42,26 @@ const isVector = (src) => /\.svg(?:[?#]|$)/iu.test(src) || /^data:image\/svg/iu.
 const isLazy = (image) => image.loading?.trim().toLowerCase() === "lazy";
 /** Vector, animated and inline images, which one file serves at every size. */
 const isFixedFormat = (src) => /^data:/iu.test(src) || /\.(?:svg|gif)(?:[?#]|$)/iu.test(src);
+/** defer on a script in <head>, which the page's tags do not quote, so the attribute is added at it. */
+/** `defer` on a blocking script, written into its tag as the page writes it. */
+const deferEdit = (src, tag) => setAttributeEdit(tag ?? null, `head > script[src="${src.replaceAll('"', String.raw `\"`)}"]`, "defer", true, "Only when no inline script further down calls this one before the page has loaded (a jQuery plugin set-up, for instance), and it is not a consent manager or A/B test that must run before anything renders; async suits independent scripts such as analytics.");
+/**
+ * srcset and sizes for a large image: the file it has at its own width, plus smaller copies only
+ * the author can make.
+ */
+const srcsetEdit = (image) => {
+    const own = `${escapeAttribute(image.src ?? "")} ${pixels(image.width)}w`;
+    const srcset = `${slot("smaller copies, e.g. /img-480.jpg 480w, /img-960.jpg 960w")}, ${own}`;
+    const sizes = slot("display width, e.g. 100vw");
+    const write = "srcset: smaller copies of the image (the framework's image component or a CDN image service makes them) with their pixel widths; sizes: how wide the image shows, such as 100vw or (min-width: 800px) 50vw, 100vw.";
+    const withSrcset = withAttribute(image.tag, "srcset", srcset);
+    const rewritten = withSrcset
+        ? withAttribute(withSrcset, "sizes", sizes)
+        : null;
+    return rewritten
+        ? replaceHtml(image.tag, rewritten, { at: imageAt(image), write })
+        : addHtml(imageAt(image), `srcset="${srcset}" sizes="${sizes}"`, write);
+};
 export const loadingRules = [
     defineRule({
         id: "loading.render-blocking-script",
@@ -35,6 +74,7 @@ export const loadingRules = [
         const scripts = page.head.blockingScripts;
         return scripts.length > 0
             ? make(`${scripts.length} script(s) in <head> block rendering: ${cap(scripts, 3).join(", ")}.`, {
+                fix: scripts.map((src, i) => deferEdit(src, page.head.sources.blockingScripts[i])),
                 selector: "head > script[src]:not([async]):not([defer])",
                 evidence: { count: scripts.length, scripts: cap(scripts) },
             })
@@ -59,7 +99,14 @@ export const loadingRules = [
             .trim()
             .toLowerCase();
         return encoding === "" || encoding === "identity"
-            ? make(`The ${Math.round(page.htmlBytes / 1024)} KB of HTML arrived without Content-Encoding.`, { evidence: { bytes: page.htmlBytes, contentEncoding: null } })
+            ? make(`The ${Math.round(page.htmlBytes / 1024)} KB of HTML arrived without Content-Encoding.`, {
+                fix: [
+                    addEdit("http", "response headers", "Content-Encoding: gzip", {
+                        write: "Turn on compression in the web server or CDN so it sends this header with a gzip (or br) body: `gzip on; gzip_types text/html text/css application/javascript application/json image/svg+xml;` in nginx, mod_deflate in Apache, compression() middleware in Express, or the CDN's compression setting. Never set the header by hand: the body must be compressed to match it.",
+                    }),
+                ],
+                evidence: { bytes: page.htmlBytes, contentEncoding: null },
+            })
             : null;
     }),
     defineRule({
@@ -74,6 +121,7 @@ export const loadingRules = [
         if (contradicting.length > 0) {
             return make(`${contradicting.length} image(s) have both fetchpriority="high" and loading="lazy".`, {
                 severity: "warning",
+                fix: contradicting.map((image) => eagerEdit(image, false)),
                 selector: 'img[loading="lazy"][fetchpriority="high"]',
                 evidence: { images: cap(contradicting.map((i) => i.src)) },
             });
@@ -86,6 +134,7 @@ export const loadingRules = [
             isLazy(first) &&
             wordsBefore < ABOVE_FOLD_WORDS
             ? make(`The first image (${first.src}) comes after ${wordsBefore} words of text and has loading="lazy".`, {
+                fix: [eagerEdit(first, true)],
                 selector: 'img[loading="lazy"]',
                 evidence: { src: first.src, wordsBefore },
             })
@@ -110,6 +159,7 @@ export const loadingRules = [
         });
         return large.length > 0
             ? make(`${large.length} image(s) at least ${SRCSET_MIN_WIDTH} pixels wide have no srcset.`, {
+                fix: large.map((image) => srcsetEdit(image)),
                 evidence: {
                     count: large.length,
                     examples: cap(large.map((i) => ({ src: i.src, width: i.width }))),
@@ -131,6 +181,9 @@ export const loadingRules = [
         isHomePage(page.url) &&
         page.head.icons.length === 0
         ? make("The home page links to no icon.", {
+            fix: [
+                addHtml("head", `<link rel="icon" href="${slot("/favicon.svg")}">`, "The path of the site's icon: an SVG, or a square PNG larger than 48x48 pixels. Add the file if the site has none, and keep it crawlable."),
+            ],
             selector: 'head > link[rel="icon"]',
         })
         : null),

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

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

package/dist/core/rules/meta.js

@@ -1,6 +1,19 @@
 import { normalizeForComparison } from "../html/text.js";
+import { addHtml, removeHtml, setAttributeEdit, slot } from "./fix.js";
 import { defineRule, GOOGLE_DOCS } from "./rule.js";
 const SELECTOR = 'head > meta[name="description"]';
+/** The meta description search engines read: the first one with text. */
+const descriptionIndex = (page) => page.metaDescription === null
+    ? -1
+    : page.metaDescriptions.indexOf(page.metaDescription);
+/** The edit that sets the page's meta description: rewrites the tag it has, or adds one. */
+const writeDescription = (page, hint, write) => {
+    const tag = page.markup.metaDescriptions[Math.max(descriptionIndex(page), 0)];
+    return tag === undefined
+        ? addHtml("head", `<meta name="description" content="${slot(hint)}">`, write)
+        : setAttributeEdit(tag, SELECTOR, "content", slot(hint), write);
+};
+const DESCRIBE = "A summary of this page in 70-160 characters that tells a searcher what they get by clicking.";
 export const metaRules = [
     defineRule({
         id: "meta-description.missing",
@@ -11,7 +24,10 @@ export const metaRules = [
         docs: GOOGLE_DOCS.snippets,
     }, ({ page }, make) => page.metaDescription
         ? null
-        : make("Page has no meta description.", { selector: SELECTOR })),
+        : make("Page has no meta description.", {
+            fix: [writeDescription(page, "page description", DESCRIBE)],
+            selector: SELECTOR,
+        })),
     defineRule({
         id: "meta-description.multiple",
         category: "meta",
@@ -19,12 +35,18 @@ export const metaRules = [
         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.`, {
+    }, ({ page }, make) => {
+        if (page.metaDescriptions.length <= 1) {
+            return null;
+        }
+        // Keep the description search engines read now; remove the others.
+        const keep = Math.max(descriptionIndex(page), 0);
+        return make(`Page has ${page.metaDescriptions.length} meta description tags.`, {
+            fix: page.markup.metaDescriptions.flatMap((tag, i) => i === keep ? [] : [removeHtml(tag, SELECTOR)]),
             selector: SELECTOR,
             evidence: { descriptions: page.metaDescriptions },
-        })
-        : null),
+        });
+    }),
     defineRule({
         id: "meta-description.too-long",
         category: "meta",
@@ -35,6 +57,9 @@ export const metaRules = [
     }, ({ page, thresholds }, make) => page.metaDescription &&
         page.metaDescription.length > thresholds.descriptionMaxChars
         ? make(`Meta description is ${page.metaDescription.length} characters (max ${thresholds.descriptionMaxChars}).`, {
+            fix: [
+                writeDescription(page, "shorter description", `The current description in at most ${thresholds.descriptionMaxChars} characters, the key message first.`),
+            ],
             selector: SELECTOR,
             evidence: {
                 description: page.metaDescription,
@@ -53,6 +78,9 @@ export const metaRules = [
     }, ({ page, thresholds }, make) => page.metaDescription &&
         page.metaDescription.length < thresholds.descriptionMinChars
         ? make(`Meta description is only ${page.metaDescription.length} characters (recommended at least ${thresholds.descriptionMinChars}).`, {
+            fix: [
+                writeDescription(page, "longer description", `The current description grown to ${thresholds.descriptionMinChars}-${thresholds.descriptionMaxChars} characters with what the page offers and why it is worth the click.`),
+            ],
             selector: SELECTOR,
             evidence: {
                 description: page.metaDescription,
@@ -73,6 +101,9 @@ export const metaRules = [
         normalizeForComparison(page.metaDescription) ===
             normalizeForComparison(page.title)
         ? make("Meta description repeats the title verbatim.", {
+            fix: [
+                writeDescription(page, "page description", "A description that adds to the title: what the page covers or offers, in 70-160 characters."),
+            ],
             selector: SELECTOR,
             evidence: {
                 title: page.title,

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":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,QAAQ,GAAG,iCAAiC,CAAC;AAEnD,yEAAyE;AACzE,MAAM,gBAAgB,GAAG,CAAC,IAAmB,EAAU,EAAE,CACvD,IAAI,CAAC,eAAe,KAAK,IAAI;IAC3B,CAAC,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAE1D,4FAA4F;AAC5F,MAAM,gBAAgB,GAAG,CACvB,IAAmB,EACnB,IAAY,EACZ,KAAa,EACJ,EAAE;IACX,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9E,OAAO,GAAG,KAAK,SAAS;QACtB,CAAC,CAAC,OAAO,CACL,MAAM,EACN,qCAAqC,IAAI,CAAC,IAAI,CAAC,IAAI,EACnD,KAAK,CACN;QACH,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,QAAQ,GACZ,8FAA8F,CAAC;AAEjG,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,CACR;QACE,EAAE,EAAE,0BAA0B;QAC9B,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,yDAAyD;QACtE,cAAc,EACZ,oJAAoJ;QACtJ,IAAI,EAAE,WAAW,CAAC,QAAQ;KAC3B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CACjB,IAAI,CAAC,eAAe;QAClB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,+BAA+B,EAAE;YACpC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC;YAC3D,QAAQ,EAAE,QAAQ;SACnB,CAAC,CACT;IACD,UAAU,CACR;QACE,EAAE,EAAE,2BAA2B;QAC/B,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,4CAA4C;QACzD,cAAc,EACZ,6DAA6D;QAC/D,IAAI,EAAE,WAAW,CAAC,QAAQ;KAC3B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE;QACjB,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mEAAmE;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjD,OAAO,IAAI,CACT,YAAY,IAAI,CAAC,gBAAgB,CAAC,MAAM,yBAAyB,EACjE;YACE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CACnD,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAC9C;YACD,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,gBAAgB,EAAE;SAClD,CACF,CAAC;IACJ,CAAC,CACF;IACD,UAAU,CACR;QACE,EAAE,EAAE,2BAA2B;QAC/B,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,SAAS;QACnB,WAAW,EACT,iGAAiG;QACnG,cAAc,EACZ,8EAA8E;QAChF,IAAI,EAAE,WAAW,CAAC,QAAQ;KAC3B,EACD,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,UAAU,CAAC,mBAAmB;QAC1D,CAAC,CAAC,IAAI,CACF,uBAAuB,IAAI,CAAC,eAAe,CAAC,MAAM,oBAAoB,UAAU,CAAC,mBAAmB,IAAI,EACxG;YACE,GAAG,EAAE;gBACH,gBAAgB,CACd,IAAI,EACJ,qBAAqB,EACrB,sCAAsC,UAAU,CAAC,mBAAmB,qCAAqC,CAC1G;aACF;YACD,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE;gBACR,WAAW,EAAE,IAAI,CAAC,eAAe;gBACjC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM;gBACnC,GAAG,EAAE,UAAU,CAAC,mBAAmB;aACpC;SACF,CACF;QACH,CAAC,CAAC,IAAI,CACX;IACD,UAAU,CACR;QACE,EAAE,EAAE,4BAA4B;QAChC,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,MAAM;QAChB,WAAW,EACT,kFAAkF;QACpF,cAAc,EACZ,wFAAwF;QAC1F,IAAI,EAAE,WAAW,CAAC,QAAQ;KAC3B,EACD,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,UAAU,CAAC,mBAAmB;QAC1D,CAAC,CAAC,IAAI,CACF,4BAA4B,IAAI,CAAC,eAAe,CAAC,MAAM,qCAAqC,UAAU,CAAC,mBAAmB,IAAI,EAC9H;YACE,GAAG,EAAE;gBACH,gBAAgB,CACd,IAAI,EACJ,oBAAoB,EACpB,oCAAoC,UAAU,CAAC,mBAAmB,IAAI,UAAU,CAAC,mBAAmB,sEAAsE,CAC3K;aACF;YACD,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE;gBACR,WAAW,EAAE,IAAI,CAAC,eAAe;gBACjC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM;gBACnC,GAAG,EAAE,UAAU,CAAC,mBAAmB;aACpC;SACF,CACF;QACH,CAAC,CAAC,IAAI,CACX;IACD,UAAU,CACR;QACE,EAAE,EAAE,gCAAgC;QACpC,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,6CAA6C;QAC1D,cAAc,EACZ,qFAAqF;QACvF,IAAI,EAAE,WAAW,CAAC,QAAQ;KAC3B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CACjB,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,KAAK;QACV,sBAAsB,CAAC,IAAI,CAAC,eAAe,CAAC;YAC1C,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC,8CAA8C,EAAE;YACnD,GAAG,EAAE;gBACH,gBAAgB,CACd,IAAI,EACJ,kBAAkB,EAClB,6FAA6F,CAC9F;aACF;YACD,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE;gBACR,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,IAAI,CAAC,eAAe;aAClC;SACF,CAAC;QACJ,CAAC,CAAC,IAAI,CACX;CACF,CAAC"}

package/dist/core/rules/page-fixes.d.ts

@@ -0,0 +1,39 @@
+import type { JsonValue } from "../html/structured-data.js";
+import type { ExtractedPage, FixEdit, PageSource, TextBlock } from "../types.js";
+/** An HTTP/1.1 status line: "HTTP/1.1 301 Moved Permanently". */
+export declare const statusLine: (status: number) => string;
+/** The status and Location of a permanent redirect to `location`. */
+export declare const permanentRedirect: (location: string) => string;
+/** Where a JSON-LD object sits, for an edit's `at`: its script, its type and its path inside the script. */
+export declare const jsonLdAt: (type: string, path?: string) => string;
+/**
+ * `"key": value` as the script writes it (any spacing around the colon), or null when it is not
+ * there verbatim, for instance because the script escapes a character the value holds.
+ */
+export declare const jsonProperty: (scriptText: string | undefined, key: string, value: JsonValue) => string | null;
+/** A JSON value for a JSON-LD fix, safe inside a <script>: "<" is escaped so "</script>" cannot end it. */
+export declare const json: (value: JsonValue) => string;
+/**
+ * The origin to build absolute URLs from: the page's own, or a slot when the page is on a
+ * development host or is HTML without a URL, where only the author knows the production origin.
+ */
+export declare const productionOrigin: (page: ExtractedPage, source: PageSource) => string;
+/** What a production-origin slot needs, for `write`. */
+export declare const ORIGIN_SLOT_WRITE = "The site's production origin (scheme and host, such as https://www.example.com), from the site URL setting rather than the development server.";
+/** Whether a `productionOrigin` is a slot the author fills in. */
+export declare const isSlot: (text: string) => boolean;
+/**
+ * `raw`, a URL as an attribute writes it, without the query parameters `drop` selects (and a
+ * `;jsessionid=` path parameter when `drop` selects "jsessionid"), written the way `raw` was:
+ * absolute stays absolute, a path stays a path.
+ */
+export declare const withoutParameters: (raw: string, base: string, drop: (name: string) => boolean) => string;
+/** Sentences of visible text that end in a full stop, question or exclamation mark. */
+export declare const sentences: (text: string) => string[];
+/**
+ * The edit that rewrites one text block: the element as written, with a slot for its content. A
+ * block quoted cut short is rebuilt from its start tag, so the code is still whole.
+ */
+export declare const rewriteBlock: (block: TextBlock, hint: string, write: string) => FixEdit;
+/** The block of `blocks` that scores highest, or null when none scores above 0. */
+export declare const bestBlock: (blocks: TextBlock[], score: (block: TextBlock) => number) => TextBlock | null;