@brandlab-digital/conformance 3.7.0 → 3.9.0

package/dist/site-system/rules/shell/licence.js

@@ -0,0 +1,60 @@
+import { licenceRenderState, renderableLicences } from "@brandlab-digital/site-core/business";
+import { normalisePagePath } from "./page.js";
+import { failFinding, notApplicableFinding, passFinding } from "./types.js";
+/**
+ * T3: a licence line renders wherever licensed work is advertised. The licence register in the business facts (read
+ * by T11's reader) says the trade needs a licence; every sampled page that advertises the work (not the legal and
+ * utility pages) shows the number of a licence that may render (site-core's renderableLicences: never an expired
+ * one), and the licensee's name beside it when the licensee differs from the trading name. An expired licence number
+ * on a page fails. Not applicable only when the evidence records no licence; facts or licence data that cannot be
+ * read give no finding, so the check shows as not run. The entity gate and the register check are agent steps.
+ */
+function compact(text) {
+    return text.toLowerCase().replace(/[\s\-. ]/g, "");
+}
+function pageText(page) {
+    return [...page.units, ...page.attributeCopy].map((unit) => unit.text).join(" ");
+}
+export function checkLicenceLine(pages, facts, _factsReason, exemptPaths = [], asOf = new Date()) {
+    // No facts, or licence data that cannot be read: not run, never not-applicable.
+    if (!facts || facts.licencesUnreadable)
+        return [];
+    if (facts.licences.length === 0) {
+        return [notApplicableFinding("T3", "The business facts record no licence, so no licensed work is advertised on the sampled pages.")];
+    }
+    const renderable = renderableLicences(facts.licences, asOf);
+    const expired = facts.licences.filter((licence) => licenceRenderState(licence, asOf).state === "expired");
+    const exempt = new Set(exemptPaths.map(normalisePagePath));
+    const findings = [];
+    let checked = 0;
+    for (const page of pages) {
+        if (page.family === "legal" || page.family === "utility" || page.noindex || exempt.has(page.path))
+            continue;
+        checked += 1;
+        const text = compact(pageText(page));
+        for (const licence of expired.filter((candidate) => text.includes(compact(candidate.identifier)))) {
+            findings.push(failFinding("T3", page.path, `The page ${page.path} shows licence ${licence.identifier}, which expired on ${licence.expiresOn}; an expired licence never renders.`));
+        }
+        const shown = renderable.filter((licence) => text.includes(compact(licence.identifier)));
+        if (shown.length === 0) {
+            findings.push(failFinding("T3", page.path, renderable.length === 0
+                ? `The page ${page.path} advertises licensed work, but every recorded licence has expired (${facts.licences.map((licence) => licence.identifier).join(", ")}), so none may render.`
+                : `The page ${page.path} advertises licensed work but shows none of the recorded licence numbers (${renderable.map((licence) => licence.identifier).join(", ")}).`));
+            continue;
+        }
+        for (const licence of shown) {
+            const holder = licence.holder?.trim();
+            if (holder && holder.toLowerCase() !== (facts.tradingName ?? "").toLowerCase() && !text.includes(compact(holder))) {
+                findings.push(failFinding("T3", page.path, `The page ${page.path} shows licence ${licence.identifier} without the licensee, ${holder}, who differs from the trading name.`));
+            }
+        }
+    }
+    if (findings.length > 0)
+        return findings;
+    if (checked === 0)
+        return [notApplicableFinding("T3", "The sampled pages are all legal or utility pages, which advertise no licensed work.")];
+    return [passFinding("T3", checked === 1
+            ? "A recorded licence number shows on the sampled page that advertises licensed work."
+            : `A recorded licence number shows on all ${checked} sampled pages that advertise licensed work.`)];
+}
+//# sourceMappingURL=licence.js.map

package/dist/site-system/rules/shell/licence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"licence.js","sourceRoot":"","sources":["../../../../src/site-system/rules/shell/licence.ts"],"names":[],"mappings":"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","sourcesContent":["import { licenceRenderState, renderableLicences } from \"@brandlab-digital/site-core/business\";\nimport type { ShellPage } from \"./page.js\";\nimport { normalisePagePath } from \"./page.js\";\nimport { failFinding, notApplicableFinding, passFinding, type ShellFinding, type ShellProjectFacts } from \"./types.js\";\n\n/**\n * T3: a licence line renders wherever licensed work is advertised. The licence register in the business facts (read\n * by T11's reader) says the trade needs a licence; every sampled page that advertises the work (not the legal and\n * utility pages) shows the number of a licence that may render (site-core's renderableLicences: never an expired\n * one), and the licensee's name beside it when the licensee differs from the trading name. An expired licence number\n * on a page fails. Not applicable only when the evidence records no licence; facts or licence data that cannot be\n * read give no finding, so the check shows as not run. The entity gate and the register check are agent steps.\n */\n\nfunction compact(text: string): string {\n  return text.toLowerCase().replace(/[\\s\\-. ]/g, \"\");\n}\n\nfunction pageText(page: ShellPage): string {\n  return [...page.units, ...page.attributeCopy].map((unit) => unit.text).join(\" \");\n}\n\nexport function checkLicenceLine(\n  pages: readonly ShellPage[],\n  facts: ShellProjectFacts | null,\n  _factsReason: string,\n  exemptPaths: readonly string[] = [],\n  asOf: Date = new Date(),\n): ShellFinding[] {\n  // No facts, or licence data that cannot be read: not run, never not-applicable.\n  if (!facts || facts.licencesUnreadable) return [];\n  if (facts.licences.length === 0) {\n    return [notApplicableFinding(\"T3\", \"The business facts record no licence, so no licensed work is advertised on the sampled pages.\")];\n  }\n  const renderable = renderableLicences(facts.licences, asOf);\n  const expired = facts.licences.filter((licence) => licenceRenderState(licence, asOf).state === \"expired\");\n  const exempt = new Set(exemptPaths.map(normalisePagePath));\n  const findings: ShellFinding[] = [];\n  let checked = 0;\n  for (const page of pages) {\n    if (page.family === \"legal\" || page.family === \"utility\" || page.noindex || exempt.has(page.path)) continue;\n    checked += 1;\n    const text = compact(pageText(page));\n    for (const licence of expired.filter((candidate) => text.includes(compact(candidate.identifier)))) {\n      findings.push(failFinding(\"T3\", page.path, `The page ${page.path} shows licence ${licence.identifier}, which expired on ${licence.expiresOn}; an expired licence never renders.`));\n    }\n    const shown = renderable.filter((licence) => text.includes(compact(licence.identifier)));\n    if (shown.length === 0) {\n      findings.push(failFinding(\"T3\", page.path, renderable.length === 0\n        ? `The page ${page.path} advertises licensed work, but every recorded licence has expired (${facts.licences.map((licence) => licence.identifier).join(\", \")}), so none may render.`\n        : `The page ${page.path} advertises licensed work but shows none of the recorded licence numbers (${renderable.map((licence) => licence.identifier).join(\", \")}).`));\n      continue;\n    }\n    for (const licence of shown) {\n      const holder = licence.holder?.trim();\n      if (holder && holder.toLowerCase() !== (facts.tradingName ?? \"\").toLowerCase() && !text.includes(compact(holder))) {\n        findings.push(failFinding(\"T3\", page.path, `The page ${page.path} shows licence ${licence.identifier} without the licensee, ${holder}, who differs from the trading name.`));\n      }\n    }\n  }\n  if (findings.length > 0) return findings;\n  if (checked === 0) return [notApplicableFinding(\"T3\", \"The sampled pages are all legal or utility pages, which advertise no licensed work.\")];\n  return [passFinding(\"T3\", checked === 1\n    ? \"A recorded licence number shows on the sampled page that advertises licensed work.\"\n    : `A recorded licence number shows on all ${checked} sampled pages that advertise licensed work.`)];\n}\n"]}

package/dist/site-system/rules/shell/location-wording.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The base and distance wording that hero copy (L10-hero) and the banned list's layer 2 (E8) both refuse. One
+ * definition, so the two checks never disagree about what counts.
+ */
+export declare const BASED_IN: RegExp;
+/** A kilometre figure: "8 km", "12.5km", "25 kilometres". */
+export declare const KM_FIGURE: RegExp;
+export declare const KM_FROM: RegExp;
+/** A distance from the base: "12 km from", "5 km away from", "8 km of". */
+export declare const KM_FROM_BASE: RegExp;
+/** The same pattern with the global flag, for `matchAll`. */
+export declare function globally(pattern: RegExp): RegExp;
+//# sourceMappingURL=location-wording.d.ts.map

package/dist/site-system/rules/shell/location-wording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location-wording.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/shell/location-wording.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,QAAQ,QAAoB,CAAC;AAC1C,6DAA6D;AAC7D,eAAO,MAAM,SAAS,QAAyD,CAAC;AAChF,eAAO,MAAM,OAAO,QAAiD,CAAC;AACtE,2EAA2E;AAC3E,eAAO,MAAM,YAAY,QAAmF,CAAC;AAE7G,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/site-system/rules/shell/location-wording.js

@@ -0,0 +1,15 @@
+/**
+ * The base and distance wording that hero copy (L10-hero) and the banned list's layer 2 (E8) both refuse. One
+ * definition, so the two checks never disagree about what counts.
+ */
+export const BASED_IN = /\bbased\s+in\b/i;
+/** A kilometre figure: "8 km", "12.5km", "25 kilometres". */
+export const KM_FIGURE = /\b\d+(?:[.,]\d+)?\s*(?:km|kms|kilomet(?:re|er)s?)\b/i;
+export const KM_FROM = /\bkm\s+from\b|\bkilomet(?:re|er)s?\s+from\b/i;
+/** A distance from the base: "12 km from", "5 km away from", "8 km of". */
+export const KM_FROM_BASE = /\b\d+(?:[.,]\d+)?\s*(?:km|kms|kilomet(?:re|er)s?)\s+(?:from|away\s+from|of)\b/i;
+/** The same pattern with the global flag, for `matchAll`. */
+export function globally(pattern) {
+    return new RegExp(pattern.source, pattern.flags.includes("g") ? pattern.flags : `${pattern.flags}g`);
+}
+//# sourceMappingURL=location-wording.js.map

package/dist/site-system/rules/shell/location-wording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location-wording.js","sourceRoot":"","sources":["../../../../src/site-system/rules/shell/location-wording.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AAC1C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAG,sDAAsD,CAAC;AAChF,MAAM,CAAC,MAAM,OAAO,GAAG,8CAA8C,CAAC;AACtE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,gFAAgF,CAAC;AAE7G,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;AACvG,CAAC","sourcesContent":["/**\n * The base and distance wording that hero copy (L10-hero) and the banned list's layer 2 (E8) both refuse. One\n * definition, so the two checks never disagree about what counts.\n */\n\nexport const BASED_IN = /\\bbased\\s+in\\b/i;\n/** A kilometre figure: \"8 km\", \"12.5km\", \"25 kilometres\". */\nexport const KM_FIGURE = /\\b\\d+(?:[.,]\\d+)?\\s*(?:km|kms|kilomet(?:re|er)s?)\\b/i;\nexport const KM_FROM = /\\bkm\\s+from\\b|\\bkilomet(?:re|er)s?\\s+from\\b/i;\n/** A distance from the base: \"12 km from\", \"5 km away from\", \"8 km of\". */\nexport const KM_FROM_BASE = /\\b\\d+(?:[.,]\\d+)?\\s*(?:km|kms|kilomet(?:re|er)s?)\\s+(?:from|away\\s+from|of)\\b/i;\n\n/** The same pattern with the global flag, for `matchAll`. */\nexport function globally(pattern: RegExp): RegExp {\n  return new RegExp(pattern.source, pattern.flags.includes(\"g\") ? pattern.flags : `${pattern.flags}g`);\n}\n"]}

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

@@ -0,0 +1,5 @@
+import type { ShellPage } from "./page.js";
+import { type ShellFinding } from "./types.js";
+/** N2 and K7 over the sampled pages. */
+export declare function checkNavigationCrawlability(pages: readonly ShellPage[]): ShellFinding[];
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/shell/navigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAkD,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAmQ/F,wCAAwC;AACxC,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,YAAY,EAAE,CAgCvF"}

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

@@ -0,0 +1,272 @@
+import { closest, findAll, findFirst, hasContent, isWithin, textOf } from "./html.js";
+import { failFinding, notApplicableFinding, passFinding } from "./types.js";
+/**
+ * N2 and K7: what a crawler reads without running scripts. A dropdown's links must be `<a href>` elements in the
+ * server HTML (N2 and K7 both name them); K7 adds accordion and tab panels with content and review text that is not
+ * cut short with no full copy in the HTML.
+ */
+const DRAWER_LABEL = /^(?:open |close |toggle |show |hide )?(?:the )?(?:main |mobile |site )?(?:menu|navigation|nav)$/i;
+const DRAWER_HOOKS = new Set(["menu-button", "menu-toggle", "drawer-toggle", "hamburger"]);
+/** Controls that open something built on demand (a dialog, a popover, a lightbox), not content on the page. */
+const ON_DEMAND_ID = /(?:dialog|modal|drawer|popover|lightbox|overlay)/i;
+const READ_MORE = /^(?:read|show|see|view)\s+(?:more|full|all)\b/i;
+function isRealHref(anchor) {
+    const href = anchor.attrs.href?.trim();
+    return href !== undefined && href !== "" && href !== "#" && !/^(?:javascript|data|vbscript):/i.test(href);
+}
+/** The name of a disclosure button: "Services menu" and "Open Services menu" both give "Services". */
+function labelOf(button) {
+    const own = button.attrs["aria-label"]?.trim() || textOf(button);
+    const sibling = button.parent?.children.find((child) => child.kind === "element" && child.tag === "a");
+    const label = own || (sibling ? textOf(sibling) : "");
+    return label.replace(/^(?:open|toggle|show|hide|close)\s+/i, "").replace(/\s+(?:menu|submenu|dropdown)$/i, "").trim();
+}
+function controlledIds(button) {
+    return (button.attrs["aria-controls"] ?? "").split(/\s+/).filter(Boolean);
+}
+function isButtonLike(element) {
+    return element.tag === "button" || element.attrs.role === "button";
+}
+function opensDialog(button, page) {
+    if (button.attrs["aria-haspopup"] === "dialog")
+        return true;
+    const label = (button.attrs["aria-label"] ?? textOf(button)).trim();
+    if (DRAWER_LABEL.test(label))
+        return true;
+    if (DRAWER_HOOKS.has(button.attrs["data-bl"] ?? "") || DRAWER_HOOKS.has(button.attrs["data-slot"] ?? ""))
+        return true;
+    const target = controlledIds(button).map((id) => page.doc.byId.get(id)).find(Boolean);
+    return target !== undefined && (target.tag === "dialog" || /^(?:dialog|alertdialog)$/.test(target.attrs.role ?? "") || target.attrs["data-bl"] === "drawer");
+}
+function headerScopes(page) {
+    if (page.headers.length > 0)
+        return [...page.headers];
+    return findAll(page.body, (element) => element.tag === "nav" && !page.footers.some((footer) => isWithin(element, footer)));
+}
+function isDisclosure(element) {
+    const popup = element.attrs["aria-haspopup"];
+    return element.attrs["aria-expanded"] !== undefined || (popup !== undefined && popup !== "false" && popup !== "dialog");
+}
+/** Anything inside a <dialog> (the mobile drawer) is not a header dropdown. */
+function inDialog(element) {
+    return closest(element, (ancestor) => ancestor.tag === "dialog" || /^(?:dialog|alertdialog)$/.test(ancestor.attrs.role ?? "") || ancestor.attrs["aria-modal"] === "true") !== null;
+}
+function hubAnchors(button) {
+    return (button.parent?.children ?? []).filter((child) => child.kind === "element" && child.tag === "a");
+}
+/** A menu item: inside the header's <nav>, or beside its own link (a split trigger). A search toggle is neither. */
+function isNavItem(button) {
+    return closest(button, (ancestor) => ancestor.tag === "nav") !== null || hubAnchors(button).length > 0;
+}
+/** The parts beside a trigger that has no aria-controls: its sibling regions, and the rest of its list item. */
+function regionsBeside(button) {
+    const parent = button.parent;
+    if (!parent)
+        return [];
+    const regions = parent.children.filter((child) => child.kind === "element" && child !== button && child.tag !== "a" && child.tag !== "script" && child.tag !== "style");
+    const owner = closest(parent, (element) => element.tag === "li" || element.attrs["data-slot"] === "item");
+    if (owner && owner !== parent) {
+        for (const child of owner.children) {
+            if (child.kind === "element" && child !== parent && !isWithin(button, child) && child.tag !== "a" && child.tag !== "script")
+                regions.push(child);
+        }
+    }
+    return regions;
+}
+function anchorsIn(elements) {
+    return elements.flatMap((element) => findAll(element, (candidate) => candidate.tag === "a"));
+}
+/** Dropdown panels in the header: each needs real links in the server HTML. */
+function inspectDropdowns(page) {
+    const issues = [];
+    const panels = [];
+    const seen = new Set();
+    let dropdowns = 0;
+    for (const scope of headerScopes(page)) {
+        for (const button of findAll(scope, (element) => isButtonLike(element) && !inDialog(element) && (controlledIds(element).length > 0 || isDisclosure(element)))) {
+            if (opensDialog(button, page))
+                continue;
+            const name = labelOf(button) || controlledIds(button).join(", ") || "dropdown";
+            const navItem = isNavItem(button);
+            const ids = controlledIds(button);
+            // A trigger with no aria-controls is a dropdown only as a menu item; a lone toggle (search) is not.
+            if (ids.length === 0 && !navItem)
+                continue;
+            const found = ids.map((id) => ({ id, panel: page.doc.byId.get(id) }));
+            const elements = ids.length > 0 ? found.flatMap((entry) => (entry.panel && !inDialog(entry.panel) ? [entry.panel] : [])) : regionsBeside(button);
+            const missing = found.filter((entry) => !entry.panel);
+            const droppedForDialog = ids.length > 0 && elements.length === 0 && missing.length === 0;
+            if (droppedForDialog)
+                continue;
+            // A disclosure that is not a nav item and holds no links is a search box or similar, not a dropdown.
+            if (!navItem && missing.length === 0 && anchorsIn(elements).length === 0 && !hasPseudoLinks(elements))
+                continue;
+            if (!navItem && missing.length > 0)
+                continue;
+            dropdowns += 1;
+            for (const entry of missing) {
+                issues.push({ path: page.path, message: `The ${name} menu on ${page.path} points at #${entry.id}, which is not in the page HTML, so its links are not in the server HTML.` });
+            }
+            for (const hub of hubAnchors(button).filter((anchor) => !isRealHref(anchor))) {
+                issues.push({ path: page.path, message: `The ${name} link beside its menu button on ${page.path} has no real address${textOf(hub) ? ` (${textOf(hub)})` : ""}.` });
+            }
+            if (ids.length === 0 || elements.length > 0)
+                panels.push({ name, elements });
+            for (const element of elements)
+                seen.add(element);
+        }
+        for (const panel of findAll(scope, (element) => element.attrs["data-slot"] === "panel" && !inDialog(element))) {
+            if (seen.has(panel))
+                continue;
+            dropdowns += 1;
+            const owner = closest(panel.parent ?? panel, (element) => element.tag === "li" || element.attrs["data-slot"] === "item");
+            const trigger = owner ? findFirst(owner, (element) => (element.tag === "a" || element.tag === "button") && !isWithin(element, panel)) : null;
+            panels.push({ name: (trigger ? labelOf(trigger) : "") || "dropdown", elements: [panel] });
+            seen.add(panel);
+        }
+    }
+    for (const { name, elements } of panels) {
+        const anchors = anchorsIn(elements);
+        const withoutAddress = anchors.filter((anchor) => !isRealHref(anchor));
+        const pseudoLinks = pseudoLinksIn(elements);
+        if (anchors.length === 0 && pseudoLinks.length === 0) {
+            issues.push({ path: page.path, message: `The ${name} menu on ${page.path} has no links in the page HTML.` });
+        }
+        if (withoutAddress.length > 0) {
+            issues.push({ path: page.path, message: `The ${name} menu on ${page.path} has ${withoutAddress.length} link${withoutAddress.length === 1 ? "" : "s"} with no real address (${withoutAddress.slice(0, 2).map((anchor) => textOf(anchor) || "no text").join(", ")}).` });
+        }
+        if (pseudoLinks.length > 0) {
+            issues.push({ path: page.path, message: `The ${name} menu on ${page.path} has ${pseudoLinks.length} item${pseudoLinks.length === 1 ? " that looks" : "s that look"} like ${pseudoLinks.length === 1 ? "a link" : "links"} but ${pseudoLinks.length === 1 ? "is" : "are"} not an <a href> element.`, });
+        }
+    }
+    return { dropdowns, issues };
+}
+function pseudoLinksIn(elements) {
+    return elements.flatMap((element) => findAll(element, (candidate) => candidate.tag !== "a" && (candidate.attrs.role === "link" || candidate.attrs["data-href"] !== undefined || candidate.attrs["data-url"] !== undefined || candidate.attrs.onclick !== undefined)));
+}
+function hasPseudoLinks(elements) {
+    return pseudoLinksIn(elements).length > 0;
+}
+function summaryText(details) {
+    const summary = details.children.find((child) => child.kind === "element" && child.tag === "summary");
+    return summary ? textOf(summary) : "";
+}
+/** Accordion and tab panels: the content has to be in the HTML even when closed. */
+function inspectPanels(page) {
+    const issues = [];
+    let panels = 0;
+    for (const details of findAll(page.body, (element) => element.tag === "details")) {
+        panels += 1;
+        const content = details.children.filter((child) => child.kind === "element" && child.tag !== "summary");
+        const rawText = details.children.filter((child) => child.kind === "text").map((child) => (child.kind === "text" ? child.text : "")).join("").trim();
+        if (rawText === "" && !content.some(hasContent)) {
+            const name = summaryText(details);
+            issues.push({ path: page.path, message: `The ${name ? `"${name}" ` : ""}accordion on ${page.path} has no content in the page HTML.` });
+        }
+    }
+    const scopes = headerScopes(page);
+    const inHeader = (element) => scopes.some((scope) => isWithin(element, scope));
+    for (const button of findAll(page.body, (element) => isButtonLike(element) && element.attrs["aria-expanded"] !== undefined && controlledIds(element).length > 0)) {
+        if (inHeader(button) || closest(button, (element) => element.tag === "nav"))
+            continue;
+        if (opensDialog(button, page) || (button.attrs["aria-haspopup"] ?? "false") !== "false")
+            continue;
+        if (controlledIds(button).every((id) => ON_DEMAND_ID.test(id)))
+            continue;
+        if (READ_MORE.test(textOf(button)) && closest(button, (element) => element.attrs["data-bl-section"] === "reviews"))
+            continue;
+        panels += 1;
+        const name = labelOf(button) || "accordion";
+        for (const id of controlledIds(button)) {
+            const panel = page.doc.byId.get(id);
+            if (!panel)
+                issues.push({ path: page.path, message: `The "${name}" accordion on ${page.path} points at #${id}, which is not in the page HTML.` });
+            else if (!hasContent(panel))
+                issues.push({ path: page.path, message: `The "${name}" accordion on ${page.path} has an empty panel in the page HTML.` });
+        }
+    }
+    for (const tab of findAll(page.body, (element) => element.attrs.role === "tab" && controlledIds(element).length > 0)) {
+        panels += 1;
+        const name = labelOf(tab) || "tab";
+        for (const id of controlledIds(tab)) {
+            const panel = page.doc.byId.get(id);
+            if (!panel)
+                issues.push({ path: page.path, message: `The "${name}" tab on ${page.path} points at #${id}, which is not in the page HTML.` });
+            else if (!hasContent(panel))
+                issues.push({ path: page.path, message: `The "${name}" tab on ${page.path} has an empty panel in the page HTML.` });
+        }
+    }
+    for (const panel of findAll(page.body, (element) => element.attrs.role === "tabpanel")) {
+        panels += 1;
+        if (!hasContent(panel))
+            issues.push({ path: page.path, message: `A tab panel on ${page.path} is empty in the page HTML.` });
+    }
+    return { panels, issues };
+}
+const ELLIPSIS_END = /[\s"'”’)]*(?:…|\.{3})[\s"'”’)]*$/;
+const MIN_STEM = 40;
+function comparable(text) {
+    return text.toLowerCase().replace(/^[\s"'“‘(]+/, "").replace(/\s+/g, " ");
+}
+/** Review text cut short with an ellipsis and no longer copy of it anywhere in the same reviews section. */
+function inspectReviews(page) {
+    const issues = [];
+    let reviews = 0;
+    for (const section of findAll(page.body, (element) => element.attrs["data-bl-section"] === "reviews" || element.attrs["data-bl"] === "reviews")) {
+        const blocks = findAll(section, (element) => element.tag === "blockquote" || element.tag === "p" || element.attrs.itemprop === "reviewBody" || ["text", "body", "quote", "content", "review"].includes(element.attrs["data-slot"] ?? ""))
+            .map((element) => ({ element, text: textOf(element) }))
+            .filter((block) => block.text !== "");
+        reviews += blocks.length;
+        for (const block of blocks) {
+            if (!ELLIPSIS_END.test(block.text) || closest(block.element, (ancestor) => ancestor.attrs["data-bl-source"] === "feed"))
+                continue;
+            const stem = comparable(block.text.replace(ELLIPSIS_END, ""));
+            if (stem.length < MIN_STEM)
+                continue;
+            const hasFullCopy = blocks.some((other) => other !== block && other.text.length > block.text.length + 3 && comparable(other.text).startsWith(stem.slice(0, MIN_STEM)));
+            if (!hasFullCopy) {
+                issues.push({ path: page.path, message: `A review on ${page.path} is cut short ("${block.text.slice(0, 50)}…") with no full text in the page HTML.` });
+            }
+        }
+        for (const control of findAll(section, (element) => isButtonLike(element) && READ_MORE.test(textOf(element)) && controlledIds(element).length > 0)) {
+            for (const id of controlledIds(control)) {
+                if (!page.doc.byId.get(id))
+                    issues.push({ path: page.path, message: `The "${textOf(control)}" control on ${page.path} points at #${id}, which is not in the page HTML.` });
+            }
+        }
+    }
+    return { panels: reviews, issues };
+}
+/** N2 and K7 over the sampled pages. */
+export function checkNavigationCrawlability(pages) {
+    const dropdownIssues = [];
+    const contentIssues = [];
+    let dropdowns = 0;
+    let contentItems = 0;
+    for (const page of pages) {
+        const navigation = inspectDropdowns(page);
+        dropdowns += navigation.dropdowns;
+        dropdownIssues.push(...navigation.issues);
+        for (const result of [inspectPanels(page), inspectReviews(page)]) {
+            contentItems += result.panels;
+            contentIssues.push(...result.issues);
+        }
+    }
+    const unique = (issues) => {
+        const seen = new Set();
+        return issues.filter((issue) => !seen.has(issue.message) && seen.add(issue.message));
+    };
+    const n2 = dropdowns === 0
+        ? [notApplicableFinding("N2", "No dropdown menu was found in the header of the sampled pages, so there are no dropdown links to check.")]
+        : dropdownIssues.length > 0
+            ? unique(dropdownIssues).map((issue) => failFinding("N2", issue.path, issue.message))
+            : [passFinding("N2", `Every link in the ${dropdowns} header dropdown${dropdowns === 1 ? "" : "s"} across ${pages.length} page${pages.length === 1 ? "" : "s"} is an <a href> in the server HTML.`)];
+    const checked = dropdowns + contentItems;
+    const k7 = checked === 0
+        ? [notApplicableFinding("K7", "The sampled pages have no dropdowns, accordions, tabs or reviews to check.")]
+        : dropdownIssues.length + contentIssues.length > 0
+            ? unique([...dropdownIssues, ...contentIssues]).map((issue) => failFinding("K7", issue.path, issue.message))
+            : [passFinding("K7", `Dropdown links, accordion and tab panels and review text are all in the server HTML on ${pages.length} page${pages.length === 1 ? "" : "s"}.`)];
+    return [...n2, ...k7];
+}
+//# sourceMappingURL=navigation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../../../src/site-system/rules/shell/navigation.ts"],"names":[],"mappings":"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","sourcesContent":["import { closest, findAll, findFirst, hasContent, isWithin, textOf, type HtmlElement } from \"./html.js\";\nimport type { ShellPage } from \"./page.js\";\nimport { failFinding, notApplicableFinding, passFinding, type ShellFinding } from \"./types.js\";\n\n/**\n * N2 and K7: what a crawler reads without running scripts. A dropdown's links must be `<a href>` elements in the\n * server HTML (N2 and K7 both name them); K7 adds accordion and tab panels with content and review text that is not\n * cut short with no full copy in the HTML.\n */\n\nconst DRAWER_LABEL = /^(?:open |close |toggle |show |hide )?(?:the )?(?:main |mobile |site )?(?:menu|navigation|nav)$/i;\nconst DRAWER_HOOKS = new Set([\"menu-button\", \"menu-toggle\", \"drawer-toggle\", \"hamburger\"]);\n/** Controls that open something built on demand (a dialog, a popover, a lightbox), not content on the page. */\nconst ON_DEMAND_ID = /(?:dialog|modal|drawer|popover|lightbox|overlay)/i;\nconst READ_MORE = /^(?:read|show|see|view)\\s+(?:more|full|all)\\b/i;\n\nfunction isRealHref(anchor: HtmlElement): boolean {\n  const href = anchor.attrs.href?.trim();\n  return href !== undefined && href !== \"\" && href !== \"#\" && !/^(?:javascript|data|vbscript):/i.test(href);\n}\n\n/** The name of a disclosure button: \"Services menu\" and \"Open Services menu\" both give \"Services\". */\nfunction labelOf(button: HtmlElement): string {\n  const own = button.attrs[\"aria-label\"]?.trim() || textOf(button);\n  const sibling = button.parent?.children.find((child): child is HtmlElement => child.kind === \"element\" && child.tag === \"a\");\n  const label = own || (sibling ? textOf(sibling) : \"\");\n  return label.replace(/^(?:open|toggle|show|hide|close)\\s+/i, \"\").replace(/\\s+(?:menu|submenu|dropdown)$/i, \"\").trim();\n}\n\nfunction controlledIds(button: HtmlElement): string[] {\n  return (button.attrs[\"aria-controls\"] ?? \"\").split(/\\s+/).filter(Boolean);\n}\n\nfunction isButtonLike(element: HtmlElement): boolean {\n  return element.tag === \"button\" || element.attrs.role === \"button\";\n}\n\nfunction opensDialog(button: HtmlElement, page: ShellPage): boolean {\n  if (button.attrs[\"aria-haspopup\"] === \"dialog\") return true;\n  const label = (button.attrs[\"aria-label\"] ?? textOf(button)).trim();\n  if (DRAWER_LABEL.test(label)) return true;\n  if (DRAWER_HOOKS.has(button.attrs[\"data-bl\"] ?? \"\") || DRAWER_HOOKS.has(button.attrs[\"data-slot\"] ?? \"\")) return true;\n  const target = controlledIds(button).map((id) => page.doc.byId.get(id)).find(Boolean);\n  return target !== undefined && (target.tag === \"dialog\" || /^(?:dialog|alertdialog)$/.test(target.attrs.role ?? \"\") || target.attrs[\"data-bl\"] === \"drawer\");\n}\n\ninterface Issue {\n  path: string;\n  message: string;\n}\n\ninterface NavigationResult {\n  dropdowns: number;\n  issues: Issue[];\n}\n\nfunction headerScopes(page: ShellPage): HtmlElement[] {\n  if (page.headers.length > 0) return [...page.headers];\n  return findAll(page.body, (element) => element.tag === \"nav\" && !page.footers.some((footer) => isWithin(element, footer)));\n}\n\nfunction isDisclosure(element: HtmlElement): boolean {\n  const popup = element.attrs[\"aria-haspopup\"];\n  return element.attrs[\"aria-expanded\"] !== undefined || (popup !== undefined && popup !== \"false\" && popup !== \"dialog\");\n}\n\n/** Anything inside a <dialog> (the mobile drawer) is not a header dropdown. */\nfunction inDialog(element: HtmlElement): boolean {\n  return closest(element, (ancestor) => ancestor.tag === \"dialog\" || /^(?:dialog|alertdialog)$/.test(ancestor.attrs.role ?? \"\") || ancestor.attrs[\"aria-modal\"] === \"true\") !== null;\n}\n\nfunction hubAnchors(button: HtmlElement): HtmlElement[] {\n  return (button.parent?.children ?? []).filter((child): child is HtmlElement => child.kind === \"element\" && child.tag === \"a\");\n}\n\n/** A menu item: inside the header's <nav>, or beside its own link (a split trigger). A search toggle is neither. */\nfunction isNavItem(button: HtmlElement): boolean {\n  return closest(button, (ancestor) => ancestor.tag === \"nav\") !== null || hubAnchors(button).length > 0;\n}\n\n/** The parts beside a trigger that has no aria-controls: its sibling regions, and the rest of its list item. */\nfunction regionsBeside(button: HtmlElement): HtmlElement[] {\n  const parent = button.parent;\n  if (!parent) return [];\n  const regions = parent.children.filter((child): child is HtmlElement =>\n    child.kind === \"element\" && child !== button && child.tag !== \"a\" && child.tag !== \"script\" && child.tag !== \"style\");\n  const owner = closest(parent, (element) => element.tag === \"li\" || element.attrs[\"data-slot\"] === \"item\");\n  if (owner && owner !== parent) {\n    for (const child of owner.children) {\n      if (child.kind === \"element\" && child !== parent && !isWithin(button, child) && child.tag !== \"a\" && child.tag !== \"script\") regions.push(child);\n    }\n  }\n  return regions;\n}\n\ninterface Panel {\n  name: string;\n  /** The elements that hold the dropdown's links; a trigger without aria-controls has the regions beside it. */\n  elements: HtmlElement[];\n}\n\nfunction anchorsIn(elements: readonly HtmlElement[]): HtmlElement[] {\n  return elements.flatMap((element) => findAll(element, (candidate) => candidate.tag === \"a\"));\n}\n\n/** Dropdown panels in the header: each needs real links in the server HTML. */\nfunction inspectDropdowns(page: ShellPage): NavigationResult {\n  const issues: Issue[] = [];\n  const panels: Panel[] = [];\n  const seen = new Set<HtmlElement>();\n  let dropdowns = 0;\n  for (const scope of headerScopes(page)) {\n    for (const button of findAll(scope, (element) => isButtonLike(element) && !inDialog(element) && (controlledIds(element).length > 0 || isDisclosure(element)))) {\n      if (opensDialog(button, page)) continue;\n      const name = labelOf(button) || controlledIds(button).join(\", \") || \"dropdown\";\n      const navItem = isNavItem(button);\n      const ids = controlledIds(button);\n      // A trigger with no aria-controls is a dropdown only as a menu item; a lone toggle (search) is not.\n      if (ids.length === 0 && !navItem) continue;\n      const found = ids.map((id) => ({ id, panel: page.doc.byId.get(id) }));\n      const elements = ids.length > 0 ? found.flatMap((entry) => (entry.panel && !inDialog(entry.panel) ? [entry.panel] : [])) : regionsBeside(button);\n      const missing = found.filter((entry) => !entry.panel);\n      const droppedForDialog = ids.length > 0 && elements.length === 0 && missing.length === 0;\n      if (droppedForDialog) continue;\n      // A disclosure that is not a nav item and holds no links is a search box or similar, not a dropdown.\n      if (!navItem && missing.length === 0 && anchorsIn(elements).length === 0 && !hasPseudoLinks(elements)) continue;\n      if (!navItem && missing.length > 0) continue;\n      dropdowns += 1;\n      for (const entry of missing) {\n        issues.push({ path: page.path, message: `The ${name} menu on ${page.path} points at #${entry.id}, which is not in the page HTML, so its links are not in the server HTML.` });\n      }\n      for (const hub of hubAnchors(button).filter((anchor) => !isRealHref(anchor))) {\n        issues.push({ path: page.path, message: `The ${name} link beside its menu button on ${page.path} has no real address${textOf(hub) ? ` (${textOf(hub)})` : \"\"}.` });\n      }\n      if (ids.length === 0 || elements.length > 0) panels.push({ name, elements });\n      for (const element of elements) seen.add(element);\n    }\n    for (const panel of findAll(scope, (element) => element.attrs[\"data-slot\"] === \"panel\" && !inDialog(element))) {\n      if (seen.has(panel)) continue;\n      dropdowns += 1;\n      const owner = closest(panel.parent ?? panel, (element) => element.tag === \"li\" || element.attrs[\"data-slot\"] === \"item\");\n      const trigger = owner ? findFirst(owner, (element) => (element.tag === \"a\" || element.tag === \"button\") && !isWithin(element, panel)) : null;\n      panels.push({ name: (trigger ? labelOf(trigger) : \"\") || \"dropdown\", elements: [panel] });\n      seen.add(panel);\n    }\n  }\n  for (const { name, elements } of panels) {\n    const anchors = anchorsIn(elements);\n    const withoutAddress = anchors.filter((anchor) => !isRealHref(anchor));\n    const pseudoLinks = pseudoLinksIn(elements);\n    if (anchors.length === 0 && pseudoLinks.length === 0) {\n      issues.push({ path: page.path, message: `The ${name} menu on ${page.path} has no links in the page HTML.` });\n    }\n    if (withoutAddress.length > 0) {\n      issues.push({ path: page.path, message: `The ${name} menu on ${page.path} has ${withoutAddress.length} link${withoutAddress.length === 1 ? \"\" : \"s\"} with no real address (${withoutAddress.slice(0, 2).map((anchor) => textOf(anchor) || \"no text\").join(\", \")}).` });\n    }\n    if (pseudoLinks.length > 0) {\n      issues.push({ path: page.path, message: `The ${name} menu on ${page.path} has ${pseudoLinks.length} item${pseudoLinks.length === 1 ? \" that looks\" : \"s that look\"} like ${pseudoLinks.length === 1 ? \"a link\" : \"links\"} but ${pseudoLinks.length === 1 ? \"is\" : \"are\"} not an <a href> element.`, });\n    }\n  }\n  return { dropdowns, issues };\n}\n\nfunction pseudoLinksIn(elements: readonly HtmlElement[]): HtmlElement[] {\n  return elements.flatMap((element) => findAll(element, (candidate) =>\n    candidate.tag !== \"a\" && (candidate.attrs.role === \"link\" || candidate.attrs[\"data-href\"] !== undefined || candidate.attrs[\"data-url\"] !== undefined || candidate.attrs.onclick !== undefined)));\n}\n\nfunction hasPseudoLinks(elements: readonly HtmlElement[]): boolean {\n  return pseudoLinksIn(elements).length > 0;\n}\n\nfunction summaryText(details: HtmlElement): string {\n  const summary = details.children.find((child): child is HtmlElement => child.kind === \"element\" && child.tag === \"summary\");\n  return summary ? textOf(summary) : \"\";\n}\n\ninterface ContentResult {\n  panels: number;\n  issues: Issue[];\n}\n\n/** Accordion and tab panels: the content has to be in the HTML even when closed. */\nfunction inspectPanels(page: ShellPage): ContentResult {\n  const issues: Issue[] = [];\n  let panels = 0;\n  for (const details of findAll(page.body, (element) => element.tag === \"details\")) {\n    panels += 1;\n    const content = details.children.filter((child): child is HtmlElement => child.kind === \"element\" && child.tag !== \"summary\");\n    const rawText = details.children.filter((child) => child.kind === \"text\").map((child) => (child.kind === \"text\" ? child.text : \"\")).join(\"\").trim();\n    if (rawText === \"\" && !content.some(hasContent)) {\n      const name = summaryText(details);\n      issues.push({ path: page.path, message: `The ${name ? `\"${name}\" ` : \"\"}accordion on ${page.path} has no content in the page HTML.` });\n    }\n  }\n  const scopes = headerScopes(page);\n  const inHeader = (element: HtmlElement) => scopes.some((scope) => isWithin(element, scope));\n  for (const button of findAll(page.body, (element) => isButtonLike(element) && element.attrs[\"aria-expanded\"] !== undefined && controlledIds(element).length > 0)) {\n    if (inHeader(button) || closest(button, (element) => element.tag === \"nav\")) continue;\n    if (opensDialog(button, page) || (button.attrs[\"aria-haspopup\"] ?? \"false\") !== \"false\") continue;\n    if (controlledIds(button).every((id) => ON_DEMAND_ID.test(id))) continue;\n    if (READ_MORE.test(textOf(button)) && closest(button, (element) => element.attrs[\"data-bl-section\"] === \"reviews\")) continue;\n    panels += 1;\n    const name = labelOf(button) || \"accordion\";\n    for (const id of controlledIds(button)) {\n      const panel = page.doc.byId.get(id);\n      if (!panel) issues.push({ path: page.path, message: `The \"${name}\" accordion on ${page.path} points at #${id}, which is not in the page HTML.` });\n      else if (!hasContent(panel)) issues.push({ path: page.path, message: `The \"${name}\" accordion on ${page.path} has an empty panel in the page HTML.` });\n    }\n  }\n  for (const tab of findAll(page.body, (element) => element.attrs.role === \"tab\" && controlledIds(element).length > 0)) {\n    panels += 1;\n    const name = labelOf(tab) || \"tab\";\n    for (const id of controlledIds(tab)) {\n      const panel = page.doc.byId.get(id);\n      if (!panel) issues.push({ path: page.path, message: `The \"${name}\" tab on ${page.path} points at #${id}, which is not in the page HTML.` });\n      else if (!hasContent(panel)) issues.push({ path: page.path, message: `The \"${name}\" tab on ${page.path} has an empty panel in the page HTML.` });\n    }\n  }\n  for (const panel of findAll(page.body, (element) => element.attrs.role === \"tabpanel\")) {\n    panels += 1;\n    if (!hasContent(panel)) issues.push({ path: page.path, message: `A tab panel on ${page.path} is empty in the page HTML.` });\n  }\n  return { panels, issues };\n}\n\nconst ELLIPSIS_END = /[\\s\"'”’)]*(?:…|\\.{3})[\\s\"'”’)]*$/;\nconst MIN_STEM = 40;\n\nfunction comparable(text: string): string {\n  return text.toLowerCase().replace(/^[\\s\"'“‘(]+/, \"\").replace(/\\s+/g, \" \");\n}\n\n/** Review text cut short with an ellipsis and no longer copy of it anywhere in the same reviews section. */\nfunction inspectReviews(page: ShellPage): ContentResult {\n  const issues: Issue[] = [];\n  let reviews = 0;\n  for (const section of findAll(page.body, (element) => element.attrs[\"data-bl-section\"] === \"reviews\" || element.attrs[\"data-bl\"] === \"reviews\")) {\n    const blocks = findAll(section, (element) =>\n      element.tag === \"blockquote\" || element.tag === \"p\" || element.attrs.itemprop === \"reviewBody\" || [\"text\", \"body\", \"quote\", \"content\", \"review\"].includes(element.attrs[\"data-slot\"] ?? \"\"))\n      .map((element) => ({ element, text: textOf(element) }))\n      .filter((block) => block.text !== \"\");\n    reviews += blocks.length;\n    for (const block of blocks) {\n      if (!ELLIPSIS_END.test(block.text) || closest(block.element, (ancestor) => ancestor.attrs[\"data-bl-source\"] === \"feed\")) continue;\n      const stem = comparable(block.text.replace(ELLIPSIS_END, \"\"));\n      if (stem.length < MIN_STEM) continue;\n      const hasFullCopy = blocks.some((other) => other !== block && other.text.length > block.text.length + 3 && comparable(other.text).startsWith(stem.slice(0, MIN_STEM)));\n      if (!hasFullCopy) {\n        issues.push({ path: page.path, message: `A review on ${page.path} is cut short (\"${block.text.slice(0, 50)}…\") with no full text in the page HTML.` });\n      }\n    }\n    for (const control of findAll(section, (element) => isButtonLike(element) && READ_MORE.test(textOf(element)) && controlledIds(element).length > 0)) {\n      for (const id of controlledIds(control)) {\n        if (!page.doc.byId.get(id)) issues.push({ path: page.path, message: `The \"${textOf(control)}\" control on ${page.path} points at #${id}, which is not in the page HTML.` });\n      }\n    }\n  }\n  return { panels: reviews, issues };\n}\n\n/** N2 and K7 over the sampled pages. */\nexport function checkNavigationCrawlability(pages: readonly ShellPage[]): ShellFinding[] {\n  const dropdownIssues: Issue[] = [];\n  const contentIssues: Issue[] = [];\n  let dropdowns = 0;\n  let contentItems = 0;\n  for (const page of pages) {\n    const navigation = inspectDropdowns(page);\n    dropdowns += navigation.dropdowns;\n    dropdownIssues.push(...navigation.issues);\n    for (const result of [inspectPanels(page), inspectReviews(page)]) {\n      contentItems += result.panels;\n      contentIssues.push(...result.issues);\n    }\n  }\n  const unique = (issues: readonly Issue[]) => {\n    const seen = new Set<string>();\n    return issues.filter((issue) => !seen.has(issue.message) && seen.add(issue.message));\n  };\n\n  const n2: ShellFinding[] = dropdowns === 0\n    ? [notApplicableFinding(\"N2\", \"No dropdown menu was found in the header of the sampled pages, so there are no dropdown links to check.\")]\n    : dropdownIssues.length > 0\n      ? unique(dropdownIssues).map((issue) => failFinding(\"N2\", issue.path, issue.message))\n      : [passFinding(\"N2\", `Every link in the ${dropdowns} header dropdown${dropdowns === 1 ? \"\" : \"s\"} across ${pages.length} page${pages.length === 1 ? \"\" : \"s\"} is an <a href> in the server HTML.`)];\n\n  const checked = dropdowns + contentItems;\n  const k7: ShellFinding[] = checked === 0\n    ? [notApplicableFinding(\"K7\", \"The sampled pages have no dropdowns, accordions, tabs or reviews to check.\")]\n    : dropdownIssues.length + contentIssues.length > 0\n      ? unique([...dropdownIssues, ...contentIssues]).map((issue) => failFinding(\"K7\", issue.path, issue.message))\n      : [passFinding(\"K7\", `Dropdown links, accordion and tab panels and review text are all in the server HTML on ${pages.length} page${pages.length === 1 ? \"\" : \"s\"}.`)];\n  return [...n2, ...k7];\n}\n"]}

package/dist/site-system/rules/shell/overlays.d.ts

@@ -0,0 +1,4 @@
+import type { ShellPage } from "./page.js";
+import { type ShellFinding } from "./types.js";
+export declare function checkNoInterstitial(pages: readonly ShellPage[]): ShellFinding[];
+//# sourceMappingURL=overlays.d.ts.map

package/dist/site-system/rules/shell/overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/shell/overlays.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAA0C,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAoEvF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,YAAY,EAAE,CAkB/E"}

package/dist/site-system/rules/shell/overlays.js

@@ -0,0 +1,93 @@
+import { classTokens, findAll, selfAndAncestors } from "./html.js";
+import { failFinding, passFinding, sampledPages } from "./types.js";
+/**
+ * C9: no interstitial overlay in the first screen. The server HTML holds what shows on load, so an open modal dialog,
+ * an open popup or a fixed full-screen cover in it covers the first screen. A closed drawer or dialog (`hidden`,
+ * `inert`, `data-state="closed"`, a `<dialog>` without `open`) does not.
+ */
+const OVERLAY_NAME = /(?:^|[\s_-])(?:pop-?ups?|modals?|interstitials?|lightbox|splash)(?:$|[\s_-])|popup|modal|interstitial|lightbox/i;
+const OPEN_CLASSES = new Set(["open", "opened", "is-open", "show", "shown", "is-shown", "visible", "is-visible", "active", "is-active", "in", "displayed"]);
+const HIDDEN_CLASSES = new Set(["hidden", "invisible", "sr-only", "closed", "is-closed", "d-none", "collapse"]);
+/** Utility classes that move a panel off screen or make it unclickable until it opens. */
+const OFF_SCREEN_CLASS = /^(?:-?translate-[xy]-full|opacity-0|pointer-events-none|scale-0)$/;
+const FULL_SCREEN_STYLE = /position\s*:\s*(?:fixed|sticky)/i;
+function styleHides(style) {
+    return /display\s*:\s*none|visibility\s*:\s*hidden|opacity\s*:\s*0(?:\.0+)?\s*(?:;|$)/i.test(style);
+}
+/** Whether the element, or an ancestor, is hidden or inert in the server HTML. */
+function isHiddenOnLoad(element) {
+    for (const candidate of selfAndAncestors(element)) {
+        const { attrs } = candidate;
+        if (attrs.hidden !== undefined || attrs.inert !== undefined)
+            return true;
+        if (attrs["aria-hidden"] === "true" && candidate === element)
+            return true;
+        if (/^(?:closed|hidden)$/.test(attrs["data-state"] ?? ""))
+            return true;
+        if (attrs["data-open"] === "false" || (attrs["aria-expanded"] === "false" && candidate === element))
+            return true;
+        if (candidate.tag === "dialog" && attrs.open === undefined)
+            return true;
+        if (styleHides(attrs.style ?? ""))
+            return true;
+        if (classTokens(candidate).some((token) => HIDDEN_CLASSES.has(token) || OFF_SCREEN_CLASS.test(token)))
+            return true;
+    }
+    return false;
+}
+function opensOnLoad(element) {
+    const { attrs } = element;
+    return attrs.open !== undefined || attrs["data-state"] === "open" || attrs["data-open"] === "true" || attrs["aria-hidden"] === "false" ||
+        attrs["data-visible"] === "true" || classTokens(element).some((token) => OPEN_CLASSES.has(token));
+}
+function namedLikeOverlay(element) {
+    return [attrsOf(element, "id"), attrsOf(element, "class"), attrsOf(element, "data-bl"), attrsOf(element, "data-slot"), attrsOf(element, "aria-label")]
+        .some((value) => OVERLAY_NAME.test(value));
+}
+function attrsOf(element, name) {
+    return element.attrs[name] ?? "";
+}
+/** Tailwind-style utilities that make a full-screen fixed cover. */
+function coversScreen(element) {
+    const tokens = new Set(classTokens(element));
+    const fixed = tokens.has("fixed") || tokens.has("sticky");
+    const inset = tokens.has("inset-0") || (tokens.has("top-0") && tokens.has("left-0") && tokens.has("right-0") && tokens.has("bottom-0"));
+    const sized = (tokens.has("w-screen") || tokens.has("w-full") || tokens.has("w-dvw")) && (tokens.has("h-screen") || tokens.has("h-full") || tokens.has("h-dvh") || tokens.has("min-h-screen"));
+    if (fixed && (inset || sized))
+        return true;
+    const style = element.attrs.style ?? "";
+    if (!FULL_SCREEN_STYLE.test(style))
+        return false;
+    const insetZero = /inset\s*:\s*0(?:px)?\b/i.test(style) || (/top\s*:\s*0/i.test(style) && /left\s*:\s*0/i.test(style) && /right\s*:\s*0/i.test(style) && /bottom\s*:\s*0/i.test(style));
+    const full = /width\s*:\s*100(?:vw|dvw|%)/i.test(style) && /(?:min-)?height\s*:\s*100(?:vh|dvh|%)/i.test(style);
+    return insetZero || full;
+}
+function describe(element) {
+    const name = element.attrs["aria-label"] || element.attrs.id || element.attrs["data-bl"] || classTokens(element)[0] || element.tag;
+    return `${element.tag} "${name}"`;
+}
+export function checkNoInterstitial(pages) {
+    const findings = [];
+    for (const page of pages) {
+        const reasons = new Map();
+        for (const element of findAll(page.body, () => true)) {
+            if (isHiddenOnLoad(element))
+                continue;
+            if (element.attrs["aria-modal"] === "true")
+                reasons.set(element, "a modal dialog that is open on load");
+            else if (element.tag === "dialog" && element.attrs.open !== undefined)
+                reasons.set(element, "a dialog that is open on load");
+            else if (namedLikeOverlay(element) && opensOnLoad(element) && !(element.tag === "button" || element.tag === "a"))
+                reasons.set(element, "a popup that is open on load");
+            else if (coversScreen(element))
+                reasons.set(element, "a fixed full-screen cover");
+        }
+        // Report the outermost cover only: its children are part of it.
+        const outer = [...reasons.entries()].filter(([element]) => ![...selfAndAncestors(element)].slice(1).some((ancestor) => reasons.has(ancestor)));
+        for (const [element, reason] of outer.slice(0, 3)) {
+            findings.push(failFinding("C9", page.path, `The page ${page.path} loads with ${reason} (${describe(element)}), which covers the first screen.`));
+        }
+    }
+    return findings.length > 0 ? findings : [passFinding("C9", `No interstitial overlay is open on load on ${sampledPages(pages.length)}.`)];
+}
+//# sourceMappingURL=overlays.js.map