@brandlab-digital/conformance 3.7.0 → 3.9.0

package/dist/site-system/rules/library/k1-shared-components.js

@@ -0,0 +1,97 @@
+import { notApplicable, pass, plural } from "../enquiry/common.js";
+import { isQuoteForm } from "../enquiry/c2-quote-form.js";
+import { ancestors, attr, closest, descendants, textOf } from "../enquiry/html.js";
+import { PageProblems, byHook, mainOf } from "./common.js";
+/** The shell parts every page carries, by the tier that requires them. */
+export const K1_SHELL_PARTS = [
+    { hook: "header", name: "header" },
+    { hook: "drawer", name: "mobile drawer" },
+    { hook: "callbar", name: "call bar" },
+    { hook: "back-to-top", name: "back-to-top control" },
+];
+const REVIEWS_HEADING = /\b(?:reviews?|testimonials?)\b|what (?:our )?(?:customers|clients|people) (?:say|think)/i;
+const QUOTE_LINK = /\b(?:quote|estimate|inspection|book)\b/i;
+const CTA_BAND_WORDS = 60;
+/** Page-level footers: a `<footer>` that is not the footer of an article, section, aside, quote or dialog. */
+function pageFooters(root) {
+    return descendants(root).filter((element) => element.tag === "footer" &&
+        !ancestors(element).some((parent) => ["article", "section", "aside", "main", "blockquote", "dialog"].includes(parent.tag)));
+}
+function isUnbound(element) {
+    return attr(element, "data-bl-section") === undefined;
+}
+/** A section in the main content, written by hand, whose own heading reads like a reviews section. */
+function handBuiltReviews(main) {
+    return descendants(main).find((element) => {
+        if (element.tag !== "section" || !isUnbound(element))
+            return false;
+        if (ancestors(element).some((parent) => attr(parent, "data-bl-section") !== undefined))
+            return false;
+        const inside = descendants(element);
+        const headings = inside.filter((child) => /^h[23]$/.test(child.tag));
+        // A wrapper around many sections is not the reviews section; its own heading is the one that counts.
+        return inside.every((child) => child.tag !== "section") && headings.some((child) => REVIEWS_HEADING.test(textOf(child)));
+    });
+}
+/** The last section of the main content, when it is a hand-written band with a call and a quote link. */
+function handBuiltCtaBand(main) {
+    const sections = descendants(main).filter((element) => element.tag === "section" && !closest(element.parent ?? element, (parent) => parent.tag === "section"));
+    const last = sections[sections.length - 1];
+    if (!last || !isUnbound(last))
+        return undefined;
+    const links = descendants(last).filter((element) => element.tag === "a");
+    const hasCall = links.some((link) => (attr(link, "href") ?? "").toLowerCase().startsWith("tel:"));
+    const hasQuote = links.some((link) => QUOTE_LINK.test(textOf(link)));
+    const heading = descendants(last).some((element) => element.tag === "h2");
+    const words = textOf(last).split(/\s+/).filter(Boolean).length;
+    return hasCall && hasQuote && heading && words <= CTA_BAND_WORDS ? last : undefined;
+}
+export function checkK1(pages, tier = "shell") {
+    if (pages.length === 0)
+        return [notApplicable("K1", "No page could be read, so there is nothing to check for shared components.")];
+    const problems = new PageProblems();
+    const coversEnquiry = tier === "enquiry" || tier === "full";
+    for (const page of pages) {
+        for (const part of K1_SHELL_PARTS) {
+            if (byHook(page.root, part.hook).length === 0) {
+                problems.add(page.path, `No ${part.name} from the shared library (no data-bl="${part.hook}")`);
+            }
+        }
+        const hand = descendants(page.root).some((element) => {
+            if (element.tag !== "a" || !(attr(element, "href") ?? "").trim().toLowerCase().startsWith("tel:"))
+                return false;
+            return closest(element, (candidate) => attr(candidate, "data-bl") === "phone-link") === null;
+        });
+        if (hand)
+            problems.add(page.path, `A tel: link written by hand, outside the shared phone link (data-bl="phone-link")`);
+        if (!coversEnquiry)
+            continue;
+        for (const form of descendants(page.root).filter((element) => element.tag === "form")) {
+            if (attr(form, "data-bl") !== "quote-form" && isQuoteForm(form)) {
+                problems.add(page.path, `A quote form that is not the shared one (no data-bl="quote-form")`);
+            }
+        }
+        const footers = pageFooters(page.root);
+        if (footers.length === 0 && byHook(page.root, "footer").length === 0) {
+            problems.add(page.path, `No footer from the shared library (no data-bl="footer")`);
+        }
+        else if (footers.some((footer) => attr(footer, "data-bl") !== "footer")) {
+            problems.add(page.path, `A footer written by hand instead of the shared one (no data-bl="footer")`);
+        }
+        const main = mainOf(page.root);
+        if (handBuiltReviews(main))
+            problems.add(page.path, `A reviews section written by hand (no data-bl-section="reviews")`);
+        if (handBuiltCtaBand(main))
+            problems.add(page.path, `A call-to-action band written by hand (no data-bl-section="cta")`);
+    }
+    if (problems.size > 0)
+        return problems.findings("K1");
+    const names = K1_SHELL_PARTS.map((part) => part.name);
+    const parts = `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
+    return [
+        pass("K1", coversEnquiry
+            ? `Checked ${plural(pages.length, "page")}: the ${parts}, quote form, reviews band, CTA band and footer are the shared components, and no tel: link is written by hand.`
+            : `Checked ${plural(pages.length, "page")}: the ${parts} are the shared components, and no tel: link is written by hand.`),
+    ];
+}
+//# sourceMappingURL=k1-shared-components.js.map

package/dist/site-system/rules/library/k1-shared-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k1-shared-components.js","sourceRoot":"","sources":["../../../../src/site-system/rules/library/k1-shared-components.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * K1: shared components in use where the declared tier covers them (Site System v2 §13.2).\n *\n * The library components mark their root with `data-bl=\"<name>\"` in the server HTML, so use is read from the rendered\n * pages. The shell parts (header, drawer, call bar, back-to-top) are all in the server HTML: the call bar and\n * back-to-top are client islands, but they render hidden and `inert` on the server (`data-state=\"hidden\"`), so a page\n * that lacks them has not mounted the library's shell. From the enquiry tier the quote form, reviews band, CTA band\n * and footer must also be the library's wherever the page has such a part. The lint rule catches a literal `tel:`\n * href in source; this rule is its rendered counterpart: no `tel:` link outside an element with\n * `data-bl=\"phone-link\"`, so a hand-written call link cannot hide behind a wrapper the lint cannot see through.\n */\nimport type { SiteSystemFinding, SiteSystemTier } from \"../../checks.js\";\nimport { notApplicable, pass, plural, type ParsedPage } from \"../enquiry/common.js\";\nimport { isQuoteForm } from \"../enquiry/c2-quote-form.js\";\nimport { ancestors, attr, closest, descendants, textOf, type HtmlElement } from \"../enquiry/html.js\";\nimport { PageProblems, byHook, mainOf } from \"./common.js\";\n\n/** The shell parts every page carries, by the tier that requires them. */\nexport const K1_SHELL_PARTS = [\n  { hook: \"header\", name: \"header\" },\n  { hook: \"drawer\", name: \"mobile drawer\" },\n  { hook: \"callbar\", name: \"call bar\" },\n  { hook: \"back-to-top\", name: \"back-to-top control\" },\n] as const;\n\nconst REVIEWS_HEADING = /\\b(?:reviews?|testimonials?)\\b|what (?:our )?(?:customers|clients|people) (?:say|think)/i;\nconst QUOTE_LINK = /\\b(?:quote|estimate|inspection|book)\\b/i;\nconst CTA_BAND_WORDS = 60;\n\n/** Page-level footers: a `<footer>` that is not the footer of an article, section, aside, quote or dialog. */\nfunction pageFooters(root: HtmlElement): HtmlElement[] {\n  return descendants(root).filter(\n    (element) =>\n      element.tag === \"footer\" &&\n      !ancestors(element).some((parent) => [\"article\", \"section\", \"aside\", \"main\", \"blockquote\", \"dialog\"].includes(parent.tag)),\n  );\n}\n\nfunction isUnbound(element: HtmlElement): boolean {\n  return attr(element, \"data-bl-section\") === undefined;\n}\n\n/** A section in the main content, written by hand, whose own heading reads like a reviews section. */\nfunction handBuiltReviews(main: HtmlElement): HtmlElement | undefined {\n  return descendants(main).find((element) => {\n    if (element.tag !== \"section\" || !isUnbound(element)) return false;\n    if (ancestors(element).some((parent) => attr(parent, \"data-bl-section\") !== undefined)) return false;\n    const inside = descendants(element);\n    const headings = inside.filter((child) => /^h[23]$/.test(child.tag));\n    // A wrapper around many sections is not the reviews section; its own heading is the one that counts.\n    return inside.every((child) => child.tag !== \"section\") && headings.some((child) => REVIEWS_HEADING.test(textOf(child)));\n  });\n}\n\n/** The last section of the main content, when it is a hand-written band with a call and a quote link. */\nfunction handBuiltCtaBand(main: HtmlElement): HtmlElement | undefined {\n  const sections = descendants(main).filter(\n    (element) => element.tag === \"section\" && !closest(element.parent ?? element, (parent) => parent.tag === \"section\"),\n  );\n  const last = sections[sections.length - 1];\n  if (!last || !isUnbound(last)) return undefined;\n  const links = descendants(last).filter((element) => element.tag === \"a\");\n  const hasCall = links.some((link) => (attr(link, \"href\") ?? \"\").toLowerCase().startsWith(\"tel:\"));\n  const hasQuote = links.some((link) => QUOTE_LINK.test(textOf(link)));\n  const heading = descendants(last).some((element) => element.tag === \"h2\");\n  const words = textOf(last).split(/\\s+/).filter(Boolean).length;\n  return hasCall && hasQuote && heading && words <= CTA_BAND_WORDS ? last : undefined;\n}\n\nexport function checkK1(pages: readonly ParsedPage[], tier: SiteSystemTier = \"shell\"): SiteSystemFinding[] {\n  if (pages.length === 0) return [notApplicable(\"K1\", \"No page could be read, so there is nothing to check for shared components.\")];\n  const problems = new PageProblems();\n  const coversEnquiry = tier === \"enquiry\" || tier === \"full\";\n\n  for (const page of pages) {\n    for (const part of K1_SHELL_PARTS) {\n      if (byHook(page.root, part.hook).length === 0) {\n        problems.add(page.path, `No ${part.name} from the shared library (no data-bl=\"${part.hook}\")`);\n      }\n    }\n\n    const hand = descendants(page.root).some((element) => {\n      if (element.tag !== \"a\" || !(attr(element, \"href\") ?? \"\").trim().toLowerCase().startsWith(\"tel:\")) return false;\n      return closest(element, (candidate) => attr(candidate, \"data-bl\") === \"phone-link\") === null;\n    });\n    if (hand) problems.add(page.path, `A tel: link written by hand, outside the shared phone link (data-bl=\"phone-link\")`);\n\n    if (!coversEnquiry) continue;\n    for (const form of descendants(page.root).filter((element) => element.tag === \"form\")) {\n      if (attr(form, \"data-bl\") !== \"quote-form\" && isQuoteForm(form)) {\n        problems.add(page.path, `A quote form that is not the shared one (no data-bl=\"quote-form\")`);\n      }\n    }\n    const footers = pageFooters(page.root);\n    if (footers.length === 0 && byHook(page.root, \"footer\").length === 0) {\n      problems.add(page.path, `No footer from the shared library (no data-bl=\"footer\")`);\n    } else if (footers.some((footer) => attr(footer, \"data-bl\") !== \"footer\")) {\n      problems.add(page.path, `A footer written by hand instead of the shared one (no data-bl=\"footer\")`);\n    }\n    const main = mainOf(page.root);\n    if (handBuiltReviews(main)) problems.add(page.path, `A reviews section written by hand (no data-bl-section=\"reviews\")`);\n    if (handBuiltCtaBand(main)) problems.add(page.path, `A call-to-action band written by hand (no data-bl-section=\"cta\")`);\n  }\n\n  if (problems.size > 0) return problems.findings(\"K1\");\n  const names = K1_SHELL_PARTS.map((part) => part.name);\n  const parts = `${names.slice(0, -1).join(\", \")} and ${names[names.length - 1]}`;\n  return [\n    pass(\n      \"K1\",\n      coversEnquiry\n        ? `Checked ${plural(pages.length, \"page\")}: the ${parts}, quote form, reviews band, CTA band and footer are the shared components, and no tel: link is written by hand.`\n        : `Checked ${plural(pages.length, \"page\")}: the ${parts} are the shared components, and no tel: link is written by hand.`,\n    ),\n  ];\n}\n"]}

package/dist/site-system/rules/navigation/extract.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Reads the main navigation out of rendered HTML: the `<nav aria-label="Main">` inside the `<header>`, its top-level
+ * items in order, and for each dropdown the links of its panel. It reads structure, not class names, so it works on
+ * the ui-kit header and on a header a site built itself: a top-level item is a list entry (or, with no list, a child
+ * of the nav); its label link is the first link outside the panel; a dropdown is an entry with a disclosure button
+ * or a panel (the element the button controls, a nested list, or an element marked as a panel).
+ */
+import { type HtmlElement } from "./html.js";
+export interface NavigationLinkLike {
+    label: string;
+    href: string;
+}
+export interface NavigationLinkItemLike {
+    kind: "link";
+    id: string;
+    label: string;
+    href: string;
+}
+export interface NavigationMenuItemLike {
+    kind: "menu";
+    id: string;
+    label: string;
+    href: string;
+    hubLabel: string;
+    panel: "list";
+    links: NavigationLinkLike[];
+}
+export type NavigationItemLike = NavigationLinkItemLike | NavigationMenuItemLike;
+export interface ExtractedNavigation {
+    readonly root: HtmlElement;
+    readonly nav: HtmlElement;
+    /** The header that holds the nav, or the whole document when the nav stands on its own. */
+    readonly header: HtmlElement;
+    readonly items: NavigationItemLike[];
+}
+export declare function slugOf(text: string): string;
+/** The main navigation: the first `<nav aria-label="Main">` inside the `<header>`, outside any dialog or drawer. */
+export declare function findMainNav(root: HtmlElement): HtmlElement | undefined;
+/** A link as the menu sees it: a same-site path without query or hash, an absolute URL for other sites, or "" for no page. */
+export declare function sitePath(href: string | undefined, baseUrl: string): string;
+/** The main navigation of a document: its element and its top-level items in order. Undefined when the page has none. */
+export declare function extractMainNavigation(html: string, baseUrl: string): ExtractedNavigation | undefined;
+/** Whether the header holds a phone link and a quote button, outside any drawer or dialog. */
+export declare function headerActions(header: HtmlElement): {
+    phone: boolean;
+    quote: boolean;
+};
+/** Every link on a page outside the given element, as same-site paths: the evidence of which pages exist. */
+export declare function linkedPaths(root: HtmlElement, baseUrl: string, except?: HtmlElement): string[];
+//# sourceMappingURL=extract.d.ts.map

package/dist/site-system/rules/navigation/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/navigation/extract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAA0E,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAErH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,EAAE,CAAC;CACtC;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAMD,oHAAoH;AACpH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAWtE;AAMD,8HAA8H;AAC9H,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW1E;AA0ID,yHAAyH;AACzH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAcpG;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAUrF;AAED,6GAA6G;AAC7G,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAS9F"}

package/dist/site-system/rules/navigation/extract.js

@@ -0,0 +1,220 @@
+/**
+ * Reads the main navigation out of rendered HTML: the `<nav aria-label="Main">` inside the `<header>`, its top-level
+ * items in order, and for each dropdown the links of its panel. It reads structure, not class names, so it works on
+ * the ui-kit header and on a header a site built itself: a top-level item is a list entry (or, with no list, a child
+ * of the nav); its label link is the first link outside the panel; a dropdown is an entry with a disclosure button
+ * or a panel (the element the button controls, a nested list, or an element marked as a panel).
+ */
+import { descendants, elementChildren, hasAncestor, isInside, parseHtml, textOf } from "./html.js";
+export function slugOf(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+}
+function isNavElement(element) {
+    return element.tag === "nav" || element.attrs.role === "navigation";
+}
+/** The main navigation: the first `<nav aria-label="Main">` inside the `<header>`, outside any dialog or drawer. */
+export function findMainNav(root) {
+    const all = descendants(root);
+    const headers = all.filter((element) => element.tag === "header" || element.attrs.role === "banner");
+    const inDialog = (element) => hasAncestor(element, (ancestor) => ancestor.tag === "dialog" || ancestor.attrs["aria-modal"] === "true");
+    return all.find((element) => isNavElement(element) &&
+        (element.attrs["aria-label"] ?? "").trim() === "Main" &&
+        headers.some((header) => isInside(element, header)) &&
+        !inDialog(element));
+}
+function sameSite(left, right) {
+    return left.replace(/^www\./i, "").toLowerCase() === right.replace(/^www\./i, "").toLowerCase();
+}
+/** A link as the menu sees it: a same-site path without query or hash, an absolute URL for other sites, or "" for no page. */
+export function sitePath(href, baseUrl) {
+    const raw = (href ?? "").trim();
+    if (raw === "" || raw.startsWith("#") || /^javascript:/i.test(raw))
+        return "";
+    if (/^(tel|mailto|sms|whatsapp):/i.test(raw))
+        return raw;
+    try {
+        const base = new URL(baseUrl || "https://site.invalid");
+        const url = new URL(raw, base);
+        return sameSite(url.hostname, base.hostname) ? url.pathname : url.href;
+    }
+    catch {
+        return raw;
+    }
+}
+/** A `<summary>` always opens something; a button does when it says so. */
+function isDisclosure(element) {
+    if (element.tag === "summary")
+        return true;
+    const control = element.tag === "button" || element.attrs.role === "button";
+    return control && ("aria-expanded" in element.attrs || "aria-haspopup" in element.attrs || "aria-controls" in element.attrs);
+}
+/** A button that opens the phone drawer or toggles the whole menu is not a dropdown of this menu. */
+const MENU_BUTTON_TEXT = /^(open |close |toggle |show |hide )?(the )?(main |site |mobile )?(menu|navigation|nav)( menu)?$/i;
+const PANEL_TAGS = new Set(["div", "ul", "ol", "nav", "section", "aside"]);
+const LABELISH_TAGS = new Set(["a", "button", "span", "summary"]);
+function previousElement(element) {
+    const siblings = element.parent ? elementChildren(element.parent) : [];
+    return siblings[siblings.indexOf(element) - 1];
+}
+/**
+ * The panels inside a nav: what a disclosure button controls, anything marked as a panel, and a block that follows
+ * a labelled link, button or span inside an item and holds links (`<a>Services</a><div>...links...</div>`).
+ */
+function findPanels(nav) {
+    const all = descendants(nav);
+    const panels = new Set();
+    for (const toggle of all.filter(isDisclosure)) {
+        const id = toggle.attrs["aria-controls"];
+        const target = id ? all.find((element) => element.attrs.id === id) : undefined;
+        if (target)
+            panels.add(target);
+    }
+    for (const element of all) {
+        if (element.attrs["data-slot"] === "panel" || element.attrs.role === "menu")
+            panels.add(element);
+    }
+    for (const element of all) {
+        if (!PANEL_TAGS.has(element.tag) || !element.parent || element.parent === nav)
+            continue;
+        const before = previousElement(element);
+        if (!before || !LABELISH_TAGS.has(before.tag))
+            continue;
+        const beforeText = cleanLabel(textOf(before));
+        if (beforeText === "" || MENU_BUTTON_TEXT.test(beforeText))
+            continue;
+        if (descendants(element).some((entry) => entry.tag === "a" && "href" in entry.attrs))
+            panels.add(element);
+    }
+    return panels;
+}
+/** Entries that are actions, not menu items: the phone, the email, the quote button. */
+function isAction(entry, label, href) {
+    if (/^(tel|mailto|sms|whatsapp):/i.test(href))
+        return true;
+    const marked = [entry, ...descendants(entry)].some((element) => element.attrs["data-bl"] === "quote-button" || "data-bl-cta" in element.attrs || "data-lead-cta" in element.attrs || "data-phone-location" in element.attrs);
+    if (marked)
+        return true;
+    return /\bquote\b/i.test(label) || /^(call|phone|ring)\b/i.test(label) || /^\+?[\d\s()-]{8,}$/.test(label) || /^send photos?$/i.test(label);
+}
+/** Drops the chevron glyphs a bespoke header may put in the label text. */
+function cleanLabel(text) {
+    return text.replace(/[\u25bc\u25be\u25bf\u2304\u02c5\u2193\u25b8\u203a]+$/u, "").replace(/\s+/g, " ").trim();
+}
+/** A panel's closing link to the whole group: "All services", "View all decking". */
+const HUB_LINK_TEXT = /^(view |see |browse )?all\b/i;
+/**
+ * The hub of a dropdown whose label has no page, from its panel: the first link that is the parent path of the
+ * others, else the first link worded as the whole group ("All gardening services").
+ */
+function guessHub(links) {
+    return (links.find((link) => link.href.startsWith("/") && links.some((other) => other !== link && other.href.startsWith(`${link.href.replace(/\/+$/, "")}/`))) ??
+        links.find((link) => link.href.startsWith("/") && HUB_LINK_TEXT.test(link.label)));
+}
+/**
+ * The top-level entries, in order. Each entry has exactly one label: a link with text, or a button with text that
+ * opens a dropdown, outside any panel. An entry is the widest element that holds that one label and no other.
+ */
+function topLevelEntries(scan) {
+    const { nav, inPanel } = scan;
+    const labels = descendants(nav).filter((element) => {
+        if (inPanel(element))
+            return false;
+        const text = cleanLabel(textOf(element));
+        if (text === "")
+            return false;
+        if (element.tag === "a")
+            return "href" in element.attrs;
+        // A chevron drawn as text (v, +) is not a label; a button needs a word, and the menu button is not a dropdown.
+        return isDisclosure(element) && /[a-z]{2,}/i.test(text) && !MENU_BUTTON_TEXT.test(text);
+    });
+    const within = (container) => labels.filter((label) => label === container || isInside(label, container)).length;
+    return labels.map((label) => {
+        let entry = label;
+        while (entry.parent && entry.parent !== nav && within(entry.parent) === 1)
+            entry = entry.parent;
+        return { entry, label };
+    });
+}
+function readEntry(scan, entry, label, baseUrl) {
+    if ("hidden" in entry.attrs || entry.attrs["aria-hidden"] === "true")
+        return undefined;
+    const { nav, panels, inPanel } = scan;
+    const inside = [entry, ...descendants(entry)];
+    const toggles = inside.filter((element) => isDisclosure(element) && !inPanel(element));
+    const controlled = toggles
+        .map((toggle) => toggle.attrs["aria-controls"])
+        .map((id) => (id ? descendants(nav).find((element) => element.attrs.id === id) : undefined))
+        .find((target) => target !== undefined && panels.has(target));
+    const panel = controlled ?? inside.find((element) => panels.has(element) && !hasAncestor(element, (ancestor) => panels.has(ancestor)));
+    const panelAnchors = panel ? [panel, ...descendants(panel)].filter((element) => element.tag === "a" && "href" in element.attrs) : [];
+    const labelIsAnchor = label.tag === "a";
+    const labelHref = labelIsAnchor ? sitePath(label.attrs.href, baseUrl) : "";
+    const text = cleanLabel(textOf(label));
+    if (text === "" || isAction(entry, text, labelHref))
+        return undefined;
+    const opens = !labelIsAnchor || "aria-haspopup" in label.attrs || "aria-expanded" in label.attrs || toggles.some((toggle) => toggle !== label);
+    if (panelAnchors.length === 0 && !opens)
+        return { kind: "link", id: slugOf(text), label: text, href: labelHref };
+    const panelLinks = panelAnchors
+        .map((anchor) => ({ label: cleanLabel(textOf(anchor)), href: sitePath(anchor.attrs.href, baseUrl) }))
+        .filter((link) => link.href !== "");
+    const hub = labelHref !== "" ? labelHref : guessHub(panelLinks)?.href ?? "";
+    const hubKey = hub.replace(/\/+$/, "").toLowerCase();
+    const hubLink = hub === "" ? undefined : panelLinks.find((link) => link.href.replace(/\/+$/, "").toLowerCase() === hubKey);
+    return {
+        kind: "menu",
+        id: slugOf(text),
+        label: text,
+        href: hub,
+        hubLabel: hubLink?.label ?? "",
+        panel: "list",
+        links: panelLinks.filter((link) => link !== hubLink && link.href.replace(/\/+$/, "").toLowerCase() !== hubKey),
+    };
+}
+/** The main navigation of a document: its element and its top-level items in order. Undefined when the page has none. */
+export function extractMainNavigation(html, baseUrl) {
+    const root = parseHtml(html);
+    const nav = findMainNav(root);
+    if (!nav)
+        return undefined;
+    const panels = findPanels(nav);
+    const scan = { nav, panels, inPanel: (element) => panels.has(element) || hasAncestor(element, (ancestor) => panels.has(ancestor)) };
+    const items = topLevelEntries(scan)
+        .map(({ entry, label }) => readEntry(scan, entry, label, baseUrl))
+        .filter((item) => item !== undefined);
+    let header = root;
+    for (let node = nav.parent; node; node = node.parent) {
+        if (node.tag === "header" || node.attrs.role === "banner")
+            header = node;
+    }
+    return { root, nav, header, items };
+}
+/** Whether the header holds a phone link and a quote button, outside any drawer or dialog. */
+export function headerActions(header) {
+    const live = descendants(header).filter((element) => !hasAncestor(element, (ancestor) => ancestor.tag === "dialog" || ancestor.attrs["aria-modal"] === "true"));
+    const phone = live.some((element) => element.tag === "a" && /^tel:/i.test((element.attrs.href ?? "").trim()));
+    const quote = live.some((element) => {
+        if (element.attrs["data-bl"] === "quote-button" || "data-bl-cta" in element.attrs || "data-lead-cta" in element.attrs)
+            return true;
+        if (element.tag !== "a" && element.tag !== "button")
+            return false;
+        const text = textOf(element);
+        return /\bquote\b/i.test(text) || /^send photos?$/i.test(text);
+    });
+    return { phone, quote };
+}
+/** Every link on a page outside the given element, as same-site paths: the evidence of which pages exist. */
+export function linkedPaths(root, baseUrl, except) {
+    const paths = new Set();
+    for (const element of descendants(root)) {
+        if (element.tag !== "a" || !("href" in element.attrs))
+            continue;
+        if (except && (element === except || isInside(element, except)))
+            continue;
+        const path = sitePath(element.attrs.href, baseUrl);
+        if (path.startsWith("/"))
+            paths.add(path);
+    }
+    return [...paths];
+}
+//# sourceMappingURL=extract.js.map

package/dist/site-system/rules/navigation/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../../src/site-system/rules/navigation/extract.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Reads the main navigation out of rendered HTML: the `<nav aria-label=\"Main\">` inside the `<header>`, its top-level\n * items in order, and for each dropdown the links of its panel. It reads structure, not class names, so it works on\n * the ui-kit header and on a header a site built itself: a top-level item is a list entry (or, with no list, a child\n * of the nav); its label link is the first link outside the panel; a dropdown is an entry with a disclosure button\n * or a panel (the element the button controls, a nested list, or an element marked as a panel).\n */\nimport { descendants, elementChildren, hasAncestor, isInside, parseHtml, textOf, type HtmlElement } from \"./html.js\";\n\nexport interface NavigationLinkLike {\n  label: string;\n  href: string;\n}\n\nexport interface NavigationLinkItemLike {\n  kind: \"link\";\n  id: string;\n  label: string;\n  href: string;\n}\n\nexport interface NavigationMenuItemLike {\n  kind: \"menu\";\n  id: string;\n  label: string;\n  href: string;\n  hubLabel: string;\n  panel: \"list\";\n  links: NavigationLinkLike[];\n}\n\nexport type NavigationItemLike = NavigationLinkItemLike | NavigationMenuItemLike;\n\nexport interface ExtractedNavigation {\n  readonly root: HtmlElement;\n  readonly nav: HtmlElement;\n  /** The header that holds the nav, or the whole document when the nav stands on its own. */\n  readonly header: HtmlElement;\n  readonly items: NavigationItemLike[];\n}\n\nexport function slugOf(text: string): string {\n  return text.toLowerCase().replace(/[^a-z0-9]+/g, \"-\").replace(/(^-|-$)/g, \"\");\n}\n\nfunction isNavElement(element: HtmlElement): boolean {\n  return element.tag === \"nav\" || element.attrs.role === \"navigation\";\n}\n\n/** The main navigation: the first `<nav aria-label=\"Main\">` inside the `<header>`, outside any dialog or drawer. */\nexport function findMainNav(root: HtmlElement): HtmlElement | undefined {\n  const all = descendants(root);\n  const headers = all.filter((element) => element.tag === \"header\" || element.attrs.role === \"banner\");\n  const inDialog = (element: HtmlElement) => hasAncestor(element, (ancestor) => ancestor.tag === \"dialog\" || ancestor.attrs[\"aria-modal\"] === \"true\");\n  return all.find(\n    (element) =>\n      isNavElement(element) &&\n      (element.attrs[\"aria-label\"] ?? \"\").trim() === \"Main\" &&\n      headers.some((header) => isInside(element, header)) &&\n      !inDialog(element),\n  );\n}\n\nfunction sameSite(left: string, right: string): boolean {\n  return left.replace(/^www\\./i, \"\").toLowerCase() === right.replace(/^www\\./i, \"\").toLowerCase();\n}\n\n/** A link as the menu sees it: a same-site path without query or hash, an absolute URL for other sites, or \"\" for no page. */\nexport function sitePath(href: string | undefined, baseUrl: string): string {\n  const raw = (href ?? \"\").trim();\n  if (raw === \"\" || raw.startsWith(\"#\") || /^javascript:/i.test(raw)) return \"\";\n  if (/^(tel|mailto|sms|whatsapp):/i.test(raw)) return raw;\n  try {\n    const base = new URL(baseUrl || \"https://site.invalid\");\n    const url = new URL(raw, base);\n    return sameSite(url.hostname, base.hostname) ? url.pathname : url.href;\n  } catch {\n    return raw;\n  }\n}\n\n/** A `<summary>` always opens something; a button does when it says so. */\nfunction isDisclosure(element: HtmlElement): boolean {\n  if (element.tag === \"summary\") return true;\n  const control = element.tag === \"button\" || element.attrs.role === \"button\";\n  return control && (\"aria-expanded\" in element.attrs || \"aria-haspopup\" in element.attrs || \"aria-controls\" in element.attrs);\n}\n\n/** A button that opens the phone drawer or toggles the whole menu is not a dropdown of this menu. */\nconst MENU_BUTTON_TEXT = /^(open |close |toggle |show |hide )?(the )?(main |site |mobile )?(menu|navigation|nav)( menu)?$/i;\n\nconst PANEL_TAGS = new Set([\"div\", \"ul\", \"ol\", \"nav\", \"section\", \"aside\"]);\nconst LABELISH_TAGS = new Set([\"a\", \"button\", \"span\", \"summary\"]);\n\nfunction previousElement(element: HtmlElement): HtmlElement | undefined {\n  const siblings = element.parent ? elementChildren(element.parent) : [];\n  return siblings[siblings.indexOf(element) - 1];\n}\n\n/**\n * The panels inside a nav: what a disclosure button controls, anything marked as a panel, and a block that follows\n * a labelled link, button or span inside an item and holds links (`<a>Services</a><div>...links...</div>`).\n */\nfunction findPanels(nav: HtmlElement): Set<HtmlElement> {\n  const all = descendants(nav);\n  const panels = new Set<HtmlElement>();\n  for (const toggle of all.filter(isDisclosure)) {\n    const id = toggle.attrs[\"aria-controls\"];\n    const target = id ? all.find((element) => element.attrs.id === id) : undefined;\n    if (target) panels.add(target);\n  }\n  for (const element of all) {\n    if (element.attrs[\"data-slot\"] === \"panel\" || element.attrs.role === \"menu\") panels.add(element);\n  }\n  for (const element of all) {\n    if (!PANEL_TAGS.has(element.tag) || !element.parent || element.parent === nav) continue;\n    const before = previousElement(element);\n    if (!before || !LABELISH_TAGS.has(before.tag)) continue;\n    const beforeText = cleanLabel(textOf(before));\n    if (beforeText === \"\" || MENU_BUTTON_TEXT.test(beforeText)) continue;\n    if (descendants(element).some((entry) => entry.tag === \"a\" && \"href\" in entry.attrs)) panels.add(element);\n  }\n  return panels;\n}\n\n/** Entries that are actions, not menu items: the phone, the email, the quote button. */\nfunction isAction(entry: HtmlElement, label: string, href: string): boolean {\n  if (/^(tel|mailto|sms|whatsapp):/i.test(href)) return true;\n  const marked = [entry, ...descendants(entry)].some(\n    (element) => element.attrs[\"data-bl\"] === \"quote-button\" || \"data-bl-cta\" in element.attrs || \"data-lead-cta\" in element.attrs || \"data-phone-location\" in element.attrs,\n  );\n  if (marked) return true;\n  return /\\bquote\\b/i.test(label) || /^(call|phone|ring)\\b/i.test(label) || /^\\+?[\\d\\s()-]{8,}$/.test(label) || /^send photos?$/i.test(label);\n}\n\n/** Drops the chevron glyphs a bespoke header may put in the label text. */\nfunction cleanLabel(text: string): string {\n  return text.replace(/[\\u25bc\\u25be\\u25bf\\u2304\\u02c5\\u2193\\u25b8\\u203a]+$/u, \"\").replace(/\\s+/g, \" \").trim();\n}\n\n/** A panel's closing link to the whole group: \"All services\", \"View all decking\". */\nconst HUB_LINK_TEXT = /^(view |see |browse )?all\\b/i;\n\n/**\n * The hub of a dropdown whose label has no page, from its panel: the first link that is the parent path of the\n * others, else the first link worded as the whole group (\"All gardening services\").\n */\nfunction guessHub(links: readonly NavigationLinkLike[]): NavigationLinkLike | undefined {\n  return (\n    links.find((link) => link.href.startsWith(\"/\") && links.some((other) => other !== link && other.href.startsWith(`${link.href.replace(/\\/+$/, \"\")}/`))) ??\n    links.find((link) => link.href.startsWith(\"/\") && HUB_LINK_TEXT.test(link.label))\n  );\n}\n\ninterface NavScan {\n  readonly nav: HtmlElement;\n  readonly panels: Set<HtmlElement>;\n  readonly inPanel: (element: HtmlElement) => boolean;\n}\n\n/**\n * The top-level entries, in order. Each entry has exactly one label: a link with text, or a button with text that\n * opens a dropdown, outside any panel. An entry is the widest element that holds that one label and no other.\n */\nfunction topLevelEntries(scan: NavScan): { entry: HtmlElement; label: HtmlElement }[] {\n  const { nav, inPanel } = scan;\n  const labels = descendants(nav).filter((element) => {\n    if (inPanel(element)) return false;\n    const text = cleanLabel(textOf(element));\n    if (text === \"\") return false;\n    if (element.tag === \"a\") return \"href\" in element.attrs;\n    // A chevron drawn as text (v, +) is not a label; a button needs a word, and the menu button is not a dropdown.\n    return isDisclosure(element) && /[a-z]{2,}/i.test(text) && !MENU_BUTTON_TEXT.test(text);\n  });\n  const within = (container: HtmlElement) => labels.filter((label) => label === container || isInside(label, container)).length;\n  return labels.map((label) => {\n    let entry = label;\n    while (entry.parent && entry.parent !== nav && within(entry.parent) === 1) entry = entry.parent;\n    return { entry, label };\n  });\n}\n\nfunction readEntry(scan: NavScan, entry: HtmlElement, label: HtmlElement, baseUrl: string): NavigationItemLike | undefined {\n  if (\"hidden\" in entry.attrs || entry.attrs[\"aria-hidden\"] === \"true\") return undefined;\n  const { nav, panels, inPanel } = scan;\n  const inside = [entry, ...descendants(entry)];\n  const toggles = inside.filter((element) => isDisclosure(element) && !inPanel(element));\n  const controlled = toggles\n    .map((toggle) => toggle.attrs[\"aria-controls\"])\n    .map((id) => (id ? descendants(nav).find((element) => element.attrs.id === id) : undefined))\n    .find((target): target is HtmlElement => target !== undefined && panels.has(target));\n  const panel = controlled ?? inside.find((element) => panels.has(element) && !hasAncestor(element, (ancestor) => panels.has(ancestor)));\n  const panelAnchors = panel ? [panel, ...descendants(panel)].filter((element) => element.tag === \"a\" && \"href\" in element.attrs) : [];\n  const labelIsAnchor = label.tag === \"a\";\n  const labelHref = labelIsAnchor ? sitePath(label.attrs.href, baseUrl) : \"\";\n  const text = cleanLabel(textOf(label));\n  if (text === \"\" || isAction(entry, text, labelHref)) return undefined;\n  const opens = !labelIsAnchor || \"aria-haspopup\" in label.attrs || \"aria-expanded\" in label.attrs || toggles.some((toggle) => toggle !== label);\n  if (panelAnchors.length === 0 && !opens) return { kind: \"link\", id: slugOf(text), label: text, href: labelHref };\n\n  const panelLinks = panelAnchors\n    .map((anchor) => ({ label: cleanLabel(textOf(anchor)), href: sitePath(anchor.attrs.href, baseUrl) }))\n    .filter((link) => link.href !== \"\");\n  const hub = labelHref !== \"\" ? labelHref : guessHub(panelLinks)?.href ?? \"\";\n  const hubKey = hub.replace(/\\/+$/, \"\").toLowerCase();\n  const hubLink = hub === \"\" ? undefined : panelLinks.find((link) => link.href.replace(/\\/+$/, \"\").toLowerCase() === hubKey);\n  return {\n    kind: \"menu\",\n    id: slugOf(text),\n    label: text,\n    href: hub,\n    hubLabel: hubLink?.label ?? \"\",\n    panel: \"list\",\n    links: panelLinks.filter((link) => link !== hubLink && link.href.replace(/\\/+$/, \"\").toLowerCase() !== hubKey),\n  };\n}\n\n/** The main navigation of a document: its element and its top-level items in order. Undefined when the page has none. */\nexport function extractMainNavigation(html: string, baseUrl: string): ExtractedNavigation | undefined {\n  const root = parseHtml(html);\n  const nav = findMainNav(root);\n  if (!nav) return undefined;\n  const panels = findPanels(nav);\n  const scan: NavScan = { nav, panels, inPanel: (element) => panels.has(element) || hasAncestor(element, (ancestor) => panels.has(ancestor)) };\n  const items = topLevelEntries(scan)\n    .map(({ entry, label }) => readEntry(scan, entry, label, baseUrl))\n    .filter((item): item is NavigationItemLike => item !== undefined);\n  let header: HtmlElement = root;\n  for (let node = nav.parent; node; node = node.parent) {\n    if (node.tag === \"header\" || node.attrs.role === \"banner\") header = node;\n  }\n  return { root, nav, header, items };\n}\n\n/** Whether the header holds a phone link and a quote button, outside any drawer or dialog. */\nexport function headerActions(header: HtmlElement): { phone: boolean; quote: boolean } {\n  const live = descendants(header).filter((element) => !hasAncestor(element, (ancestor) => ancestor.tag === \"dialog\" || ancestor.attrs[\"aria-modal\"] === \"true\"));\n  const phone = live.some((element) => element.tag === \"a\" && /^tel:/i.test((element.attrs.href ?? \"\").trim()));\n  const quote = live.some((element) => {\n    if (element.attrs[\"data-bl\"] === \"quote-button\" || \"data-bl-cta\" in element.attrs || \"data-lead-cta\" in element.attrs) return true;\n    if (element.tag !== \"a\" && element.tag !== \"button\") return false;\n    const text = textOf(element);\n    return /\\bquote\\b/i.test(text) || /^send photos?$/i.test(text);\n  });\n  return { phone, quote };\n}\n\n/** Every link on a page outside the given element, as same-site paths: the evidence of which pages exist. */\nexport function linkedPaths(root: HtmlElement, baseUrl: string, except?: HtmlElement): string[] {\n  const paths = new Set<string>();\n  for (const element of descendants(root)) {\n    if (element.tag !== \"a\" || !(\"href\" in element.attrs)) continue;\n    if (except && (element === except || isInside(element, except))) continue;\n    const path = sitePath(element.attrs.href, baseUrl);\n    if (path.startsWith(\"/\")) paths.add(path);\n  }\n  return [...paths];\n}\n"]}

package/dist/site-system/rules/navigation/html.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A small tolerant HTML reader for the rendered rules: it builds an element tree from server HTML so a rule can ask
+ * for "the nav in the header" and read links and text in order. It is not a validating parser; it understands
+ * comments, void elements, raw-text elements, quoted and bare attributes, and the implied end of a list item.
+ */
+export interface HtmlElement {
+    readonly tag: string;
+    readonly attrs: Readonly<Record<string, string>>;
+    readonly children: HtmlChild[];
+    readonly parent: HtmlElement | null;
+}
+export type HtmlChild = HtmlElement | string;
+export declare function decodeEntities(value: string): string;
+/** Builds the element tree for a document or fragment. The returned root is a `#document` element. */
+export declare function parseHtml(html: string): HtmlElement;
+export declare function elementChildren(element: HtmlElement): HtmlElement[];
+/** Every descendant element in document order. */
+export declare function descendants(element: HtmlElement): HtmlElement[];
+export declare function isInside(element: HtmlElement, ancestor: HtmlElement): boolean;
+export declare function hasAncestor(element: HtmlElement, test: (ancestor: HtmlElement) => boolean): boolean;
+/** The visible text of an element: no SVG, no screen-reader-only text, no hidden or aria-hidden parts. */
+export declare function textOf(element: HtmlElement): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/site-system/rules/navigation/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/navigation/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAwB7C,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQpD;AA8DD,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAgEnD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,EAAE,CAEnE;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,EAAE,CAW/D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAK7E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAKnG;AAID,0GAA0G;AAC1G,wBAAgB,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAoBnD"}