@brandlab-digital/conformance 3.7.0 → 3.9.0

package/dist/site-system/rules/sections/k12-contact.d.ts

@@ -0,0 +1,13 @@
+/**
+ * K12-contact: the contact page is the page header, then the contact block, and nothing else (Site System v2 §13.2).
+ *
+ * The page's `data-bl-section` order is exactly `page-header`, `contact`. A visitor who came to get in touch finds the
+ * form and the phone number, not a reviews band, an FAQ or a map beneath it. Content in the main area outside those two
+ * sections counts too. When the page carries the section manifest (`data-bl-manifest`), its rendered order must agree.
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "../enquiry/common.js";
+/** The sections the contact page holds, in order. The contact block's section id is `contact`. */
+export declare const K12_CONTACT_ORDER: readonly ["page-header", "contact"];
+export declare function checkK12Contact(pages: readonly ParsedPage[]): SiteSystemFinding[];
+//# sourceMappingURL=k12-contact.d.ts.map

package/dist/site-system/rules/sections/k12-contact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k12-contact.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/sections/k12-contact.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAA0D,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAI/G,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,qCAAsC,CAAC;AA8BrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,iBAAiB,EAAE,CAgCjF"}

package/dist/site-system/rules/sections/k12-contact.js

@@ -0,0 +1,70 @@
+import { fail, notApplicable, pass, sectionId, topLevelSections } from "../enquiry/common.js";
+import { attr, descendants, normaliseText, textOf } from "../enquiry/html.js";
+import { isContactPage, mainOf } from "../library/common.js";
+/** The sections the contact page holds, in order. The contact block's section id is `contact`. */
+export const K12_CONTACT_ORDER = ["page-header", "contact"];
+const IGNORED = new Set(["script", "style", "template", "noscript", "link", "meta"]);
+const CONTENT = new Set(["img", "picture", "video", "iframe", "form", "table", "canvas"]);
+/**
+ * Content in the main area that is not inside one of the page's sections. A wrapper that only holds sections is looked
+ * through; a wrapper with content of its own beside them is stray content.
+ */
+function strayContent(main, sections) {
+    const stray = [];
+    const visit = (node) => {
+        for (const child of node.children) {
+            if (child.type !== "element" || IGNORED.has(child.tag) || sections.includes(child) || attr(child, "hidden") !== undefined)
+                continue;
+            if (attr(child, "data-bl-manifest") !== undefined)
+                continue;
+            if (descendants(child).some((inside) => sections.includes(inside))) {
+                visit(child);
+                continue;
+            }
+            const holdsContent = normaliseText(textOf(child)) !== "" || CONTENT.has(child.tag) || descendants(child).some((inside) => CONTENT.has(inside.tag));
+            if (holdsContent) {
+                const article = /^[aeiou]/.test(child.tag) ? "an" : "a";
+                stray.push(child.tag === "section" ? `${article} ${child.tag} outside the page's sections` : `${article} ${child.tag} with content outside the page's sections`);
+            }
+        }
+    };
+    visit(main);
+    return stray;
+}
+export function checkK12Contact(pages) {
+    const contact = pages.filter(isContactPage);
+    if (contact.length === 0)
+        return [notApplicable("K12-contact", "None of the sampled pages is the contact page.")];
+    const failures = [];
+    for (const page of contact) {
+        const sections = topLevelSections(page.root);
+        const order = sections.map(sectionId);
+        if (order.length === 0) {
+            failures.push(fail("K12-contact", page.path, `${page.path} has no page header and contact block sections; the contact page is ${K12_CONTACT_ORDER.join(" then ")} and nothing else.`));
+            continue;
+        }
+        if (order.join() !== K12_CONTACT_ORDER.join()) {
+            failures.push(fail("K12-contact", page.path, `${page.path} runs ${order.join(", ")}; the contact page is ${K12_CONTACT_ORDER.join(" then ")} and nothing else.`));
+        }
+        for (const stray of strayContent(mainOf(page.root), sections)) {
+            failures.push(fail("K12-contact", page.path, `${page.path} has ${stray}; the contact page is ${K12_CONTACT_ORDER.join(" then ")} and nothing else.`));
+        }
+        const manifest = descendants(page.root).find((element) => attr(element, "data-bl-manifest") !== undefined);
+        if (manifest) {
+            try {
+                const body = JSON.parse(manifest.children.map((child) => (child.type === "text" ? child.text : "")).join(""));
+                const rendered = (body.rendered ?? []).map((item) => item.id).filter((id) => typeof id === "string");
+                if (rendered.length > 0 && rendered.join() !== K12_CONTACT_ORDER.join()) {
+                    failures.push(fail("K12-contact", page.path, `The section manifest of ${page.path} lists ${rendered.join(", ")}; the contact page is ${K12_CONTACT_ORDER.join(" then ")} and nothing else.`));
+                }
+            }
+            catch {
+                // a manifest that is not JSON is the sequencer's problem, not this rule's
+            }
+        }
+    }
+    if (failures.length > 0)
+        return failures;
+    return [pass("K12-contact", `Checked ${contact.length === 1 ? "the contact page" : `${contact.length} contact pages`}: ${K12_CONTACT_ORDER.join(" then ")} and nothing else.`)];
+}
+//# sourceMappingURL=k12-contact.js.map

package/dist/site-system/rules/sections/k12-contact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k12-contact.js","sourceRoot":"","sources":["../../../../src/site-system/rules/sections/k12-contact.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * K12-contact: the contact page is the page header, then the contact block, and nothing else (Site System v2 §13.2).\n *\n * The page's `data-bl-section` order is exactly `page-header`, `contact`. A visitor who came to get in touch finds the\n * form and the phone number, not a reviews band, an FAQ or a map beneath it. Content in the main area outside those two\n * sections counts too. When the page carries the section manifest (`data-bl-manifest`), its rendered order must agree.\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { fail, notApplicable, pass, sectionId, topLevelSections, type ParsedPage } from \"../enquiry/common.js\";\nimport { attr, descendants, normaliseText, textOf, type HtmlElement } from \"../enquiry/html.js\";\nimport { isContactPage, mainOf } from \"../library/common.js\";\n\n/** The sections the contact page holds, in order. The contact block's section id is `contact`. */\nexport const K12_CONTACT_ORDER = [\"page-header\", \"contact\"] as const;\n\nconst IGNORED = new Set([\"script\", \"style\", \"template\", \"noscript\", \"link\", \"meta\"]);\nconst CONTENT = new Set([\"img\", \"picture\", \"video\", \"iframe\", \"form\", \"table\", \"canvas\"]);\n\n/**\n * Content in the main area that is not inside one of the page's sections. A wrapper that only holds sections is looked\n * through; a wrapper with content of its own beside them is stray content.\n */\nfunction strayContent(main: HtmlElement, sections: readonly HtmlElement[]): string[] {\n  const stray: string[] = [];\n  const visit = (node: HtmlElement) => {\n    for (const child of node.children) {\n      if (child.type !== \"element\" || IGNORED.has(child.tag) || sections.includes(child) || attr(child, \"hidden\") !== undefined) continue;\n      if (attr(child, \"data-bl-manifest\") !== undefined) continue;\n      if (descendants(child).some((inside) => sections.includes(inside))) {\n        visit(child);\n        continue;\n      }\n      const holdsContent = normaliseText(textOf(child)) !== \"\" || CONTENT.has(child.tag) || descendants(child).some((inside) => CONTENT.has(inside.tag));\n      if (holdsContent) {\n        const article = /^[aeiou]/.test(child.tag) ? \"an\" : \"a\";\n        stray.push(child.tag === \"section\" ? `${article} ${child.tag} outside the page's sections` : `${article} ${child.tag} with content outside the page's sections`);\n      }\n    }\n  };\n  visit(main);\n  return stray;\n}\n\nexport function checkK12Contact(pages: readonly ParsedPage[]): SiteSystemFinding[] {\n  const contact = pages.filter(isContactPage);\n  if (contact.length === 0) return [notApplicable(\"K12-contact\", \"None of the sampled pages is the contact page.\")];\n  const failures: SiteSystemFinding[] = [];\n  for (const page of contact) {\n    const sections = topLevelSections(page.root);\n    const order = sections.map(sectionId);\n    if (order.length === 0) {\n      failures.push(fail(\"K12-contact\", page.path, `${page.path} has no page header and contact block sections; the contact page is ${K12_CONTACT_ORDER.join(\" then \")} and nothing else.`));\n      continue;\n    }\n    if (order.join() !== K12_CONTACT_ORDER.join()) {\n      failures.push(fail(\"K12-contact\", page.path, `${page.path} runs ${order.join(\", \")}; the contact page is ${K12_CONTACT_ORDER.join(\" then \")} and nothing else.`));\n    }\n    for (const stray of strayContent(mainOf(page.root), sections)) {\n      failures.push(fail(\"K12-contact\", page.path, `${page.path} has ${stray}; the contact page is ${K12_CONTACT_ORDER.join(\" then \")} and nothing else.`));\n    }\n    const manifest = descendants(page.root).find((element) => attr(element, \"data-bl-manifest\") !== undefined);\n    if (manifest) {\n      try {\n        const body = JSON.parse(manifest.children.map((child) => (child.type === \"text\" ? child.text : \"\")).join(\"\")) as { rendered?: { id?: string }[] };\n        const rendered = (body.rendered ?? []).map((item) => item.id).filter((id): id is string => typeof id === \"string\");\n        if (rendered.length > 0 && rendered.join() !== K12_CONTACT_ORDER.join()) {\n          failures.push(fail(\"K12-contact\", page.path, `The section manifest of ${page.path} lists ${rendered.join(\", \")}; the contact page is ${K12_CONTACT_ORDER.join(\" then \")} and nothing else.`));\n        }\n      } catch {\n        // a manifest that is not JSON is the sequencer's problem, not this rule's\n      }\n    }\n  }\n  if (failures.length > 0) return failures;\n  return [pass(\"K12-contact\", `Checked ${contact.length === 1 ? \"the contact page\" : `${contact.length} contact pages`}: ${K12_CONTACT_ORDER.join(\" then \")} and nothing else.`)];\n}\n"]}

package/dist/site-system/rules/sections/k2-skin-coverage.d.ts

@@ -0,0 +1,11 @@
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "../enquiry/common.js";
+/** `data-bl` names that have an entry in `BrandlabSkin` (ui-kit/brandlab-skin.ts). */
+export declare const K2_SKINNED_HOOKS: readonly ["header", "drawer", "utility", "callbar", "back-to-top", "quote-button", "phone-link", "text-link", "button", "container", "quote-form", "photo-upload", "dialog", "field", "thank-you", "rating-chip", "footer", "accordion", "price-table"];
+/** `data-bl-section` ids of the sections the library renders and skins. */
+export declare const K2_SKINNED_SECTIONS: readonly ["reviews", "cta", "faqs", "price-guide", "proof-strip", "page-header", "contact"];
+export declare const K2_REFERENCE_CLASS: RegExp;
+/** Hook names the project's own stylesheets select: `[data-bl="x"]` and `[data-bl-section="x"]`. */
+export declare function hooksStyledBySite(projectRoot: string): Set<string>;
+export declare function checkK2(pages: readonly ParsedPage[], projectRoot: string): SiteSystemFinding[];
+//# sourceMappingURL=k2-skin-coverage.d.ts.map

package/dist/site-system/rules/sections/k2-skin-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k2-skin-coverage.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/sections/k2-skin-coverage.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAI1F,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,yPAGnB,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,6FAA8F,CAAC;AAE/H,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAqB9D,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CA0BlE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAqC9F"}

package/dist/site-system/rules/sections/k2-skin-coverage.js

@@ -0,0 +1,126 @@
+/**
+ * K2: skin coverage (Site System v2 §13.2, §8.4). Every shared component a page renders has a skin entry, so a site
+ * never ships an unstyled look-alike, and no reference-skin class (the test skins the library's own tests use) ships.
+ *
+ * What the HTML can show, defined exactly:
+ * - A component is a rendered element with `data-bl="<name>"` or `data-bl-section="<id>"`, for the names the library
+ *   skins (SKINNED_HOOKS and SKINNED_SECTIONS below). Hooks without a skin entry (the skip link, the honeypot, a star
+ *   row) and the site's own compositions (the hero) are not components in this sense.
+ * - The component is covered when, on at least one sampled page, its root element or one of its slot elements (an
+ *   element with `data-slot` inside it, outside any component nested in it) carries a class, because a skin gives a
+ *   component its look through `classes`; or when the project's own stylesheets under `src/` or `app/` select the
+ *   component by its hook (`[data-bl="footer"]`, `[data-bl-section="faqs"]`), which is how a site styles slots in plain CSS.
+ * - A class token starting `ref-heavy-`, `ref-calm-` or `ref-pool-` on any element is a reference-skin class and fails.
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { fail, notApplicable, pass, plural } from "../enquiry/common.js";
+import { attr, descendants } from "../enquiry/html.js";
+import { PageProblems } from "../library/common.js";
+/** `data-bl` names that have an entry in `BrandlabSkin` (ui-kit/brandlab-skin.ts). */
+export const K2_SKINNED_HOOKS = [
+    "header", "drawer", "utility", "callbar", "back-to-top", "quote-button", "phone-link", "text-link", "button", "container",
+    "quote-form", "photo-upload", "dialog", "field", "thank-you", "rating-chip", "footer", "accordion", "price-table",
+];
+/** `data-bl-section` ids of the sections the library renders and skins. */
+export const K2_SKINNED_SECTIONS = ["reviews", "cta", "faqs", "price-guide", "proof-strip", "page-header", "contact"];
+export const K2_REFERENCE_CLASS = /^ref-(?:heavy|calm|pool)-/;
+function classesOf(element) {
+    return (attr(element, "class") ?? "").split(/\s+/).filter(Boolean);
+}
+/** The root and slot elements of one component, leaving out components nested inside it. */
+function skinSurface(root) {
+    const surface = [root];
+    const visit = (node) => {
+        for (const child of node.children) {
+            if (child.type !== "element")
+                continue;
+            if (attr(child, "data-bl") !== undefined || attr(child, "data-bl-section") !== undefined)
+                continue;
+            if (attr(child, "data-slot") !== undefined)
+                surface.push(child);
+            visit(child);
+        }
+    };
+    visit(root);
+    return surface;
+}
+/** Hook names the project's own stylesheets select: `[data-bl="x"]` and `[data-bl-section="x"]`. */
+export function hooksStyledBySite(projectRoot) {
+    const styled = new Set();
+    const selector = /\[\s*data-bl(?:-section)?\s*=\s*["']?([a-z0-9-]+)["']?\s*\]/gi;
+    const visit = (directory, depth) => {
+        if (depth > 6)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(directory, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const path = join(directory, entry.name);
+            if (entry.isDirectory())
+                visit(path, depth + 1);
+            else if (entry.isFile() && /\.(?:css|scss)$/i.test(entry.name)) {
+                try {
+                    for (const match of readFileSync(path, "utf8").matchAll(selector))
+                        styled.add(match[1].toLowerCase());
+                }
+                catch {
+                    // an unreadable stylesheet styles nothing we can see
+                }
+            }
+        }
+    };
+    for (const folder of ["src", "app", "sites"])
+        if (existsSync(join(projectRoot, folder)))
+            visit(join(projectRoot, folder), 0);
+    return styled;
+}
+export function checkK2(pages, projectRoot) {
+    const hooks = new Set(K2_SKINNED_HOOKS);
+    const sections = new Set(K2_SKINNED_SECTIONS);
+    /** Component key ("footer", "section:faqs") to whether any instance carries a skin class, and the first page. */
+    const components = new Map();
+    const references = new PageProblems();
+    for (const page of pages) {
+        for (const element of descendants(page.root)) {
+            const reference = classesOf(element).find((token) => K2_REFERENCE_CLASS.test(token));
+            if (reference)
+                references.add(page.path, `A reference-skin class (${reference}) ships; those belong to the library's own tests`);
+            const hook = attr(element, "data-bl");
+            const section = attr(element, "data-bl-section");
+            const key = hook !== undefined && hooks.has(hook) ? `hook:${hook}` : section !== undefined && sections.has(section) ? `section:${section}` : null;
+            if (!key)
+                continue;
+            const label = hook !== undefined ? `data-bl="${hook}"` : `data-bl-section="${section}"`;
+            const carries = skinSurface(element).some((candidate) => classesOf(candidate).length > 0);
+            const known = components.get(key);
+            if (known)
+                known.covered ||= carries;
+            else
+                components.set(key, { covered: carries, page: page.path, label });
+        }
+    }
+    const failures = references.findings("K2");
+    if (components.size === 0 && failures.length === 0)
+        return [notApplicable("K2", "None of the sampled pages renders a shared component.")];
+    const uncovered = [...components].filter(([, component]) => !component.covered);
+    if (uncovered.length > 0) {
+        const styled = hooksStyledBySite(projectRoot);
+        for (const [key, component] of uncovered) {
+            const name = key.slice(key.indexOf(":") + 1);
+            if (styled.has(name))
+                continue;
+            failures.push(fail("K2", component.page, `${component.label} is rendered (first on ${component.page}) with no skin class on its root or slots and no selector for it in the site's stylesheets, so it has no skin entry.`));
+        }
+    }
+    if (failures.length > 0)
+        return failures;
+    return [pass("K2", `Checked ${plural(components.size, "shared component")} on ${plural(pages.length, "page")}: each carries a skin class or is styled by the site's own CSS, and no reference-skin class ships.`)];
+}
+//# sourceMappingURL=k2-skin-coverage.js.map

package/dist/site-system/rules/sections/k2-skin-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k2-skin-coverage.js","sourceRoot":"","sources":["../../../../src/site-system/rules/sections/k2-skin-coverage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * K2: skin coverage (Site System v2 §13.2, §8.4). Every shared component a page renders has a skin entry, so a site\n * never ships an unstyled look-alike, and no reference-skin class (the test skins the library's own tests use) ships.\n *\n * What the HTML can show, defined exactly:\n * - A component is a rendered element with `data-bl=\"<name>\"` or `data-bl-section=\"<id>\"`, for the names the library\n *   skins (SKINNED_HOOKS and SKINNED_SECTIONS below). Hooks without a skin entry (the skip link, the honeypot, a star\n *   row) and the site's own compositions (the hero) are not components in this sense.\n * - The component is covered when, on at least one sampled page, its root element or one of its slot elements (an\n *   element with `data-slot` inside it, outside any component nested in it) carries a class, because a skin gives a\n *   component its look through `classes`; or when the project's own stylesheets under `src/` or `app/` select the\n *   component by its hook (`[data-bl=\"footer\"]`, `[data-bl-section=\"faqs\"]`), which is how a site styles slots in plain CSS.\n * - A class token starting `ref-heavy-`, `ref-calm-` or `ref-pool-` on any element is a reference-skin class and fails.\n */\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { fail, notApplicable, pass, plural, type ParsedPage } from \"../enquiry/common.js\";\nimport { attr, descendants, type HtmlElement } from \"../enquiry/html.js\";\nimport { PageProblems } from \"../library/common.js\";\n\n/** `data-bl` names that have an entry in `BrandlabSkin` (ui-kit/brandlab-skin.ts). */\nexport const K2_SKINNED_HOOKS = [\n  \"header\", \"drawer\", \"utility\", \"callbar\", \"back-to-top\", \"quote-button\", \"phone-link\", \"text-link\", \"button\", \"container\",\n  \"quote-form\", \"photo-upload\", \"dialog\", \"field\", \"thank-you\", \"rating-chip\", \"footer\", \"accordion\", \"price-table\",\n] as const;\n\n/** `data-bl-section` ids of the sections the library renders and skins. */\nexport const K2_SKINNED_SECTIONS = [\"reviews\", \"cta\", \"faqs\", \"price-guide\", \"proof-strip\", \"page-header\", \"contact\"] as const;\n\nexport const K2_REFERENCE_CLASS = /^ref-(?:heavy|calm|pool)-/;\n\nfunction classesOf(element: HtmlElement): string[] {\n  return (attr(element, \"class\") ?? \"\").split(/\\s+/).filter(Boolean);\n}\n\n/** The root and slot elements of one component, leaving out components nested inside it. */\nfunction skinSurface(root: HtmlElement): HtmlElement[] {\n  const surface = [root];\n  const visit = (node: HtmlElement) => {\n    for (const child of node.children) {\n      if (child.type !== \"element\") continue;\n      if (attr(child, \"data-bl\") !== undefined || attr(child, \"data-bl-section\") !== undefined) continue;\n      if (attr(child, \"data-slot\") !== undefined) surface.push(child);\n      visit(child);\n    }\n  };\n  visit(root);\n  return surface;\n}\n\n/** Hook names the project's own stylesheets select: `[data-bl=\"x\"]` and `[data-bl-section=\"x\"]`. */\nexport function hooksStyledBySite(projectRoot: string): Set<string> {\n  const styled = new Set<string>();\n  const selector = /\\[\\s*data-bl(?:-section)?\\s*=\\s*[\"']?([a-z0-9-]+)[\"']?\\s*\\]/gi;\n  const visit = (directory: string, depth: number) => {\n    if (depth > 6) return;\n    let entries;\n    try {\n      entries = readdirSync(directory, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const entry of entries) {\n      if (entry.name.startsWith(\".\") || entry.name === \"node_modules\") continue;\n      const path = join(directory, entry.name);\n      if (entry.isDirectory()) visit(path, depth + 1);\n      else if (entry.isFile() && /\\.(?:css|scss)$/i.test(entry.name)) {\n        try {\n          for (const match of readFileSync(path, \"utf8\").matchAll(selector)) styled.add(match[1]!.toLowerCase());\n        } catch {\n          // an unreadable stylesheet styles nothing we can see\n        }\n      }\n    }\n  };\n  for (const folder of [\"src\", \"app\", \"sites\"]) if (existsSync(join(projectRoot, folder))) visit(join(projectRoot, folder), 0);\n  return styled;\n}\n\nexport function checkK2(pages: readonly ParsedPage[], projectRoot: string): SiteSystemFinding[] {\n  const hooks = new Set<string>(K2_SKINNED_HOOKS);\n  const sections = new Set<string>(K2_SKINNED_SECTIONS);\n  /** Component key (\"footer\", \"section:faqs\") to whether any instance carries a skin class, and the first page. */\n  const components = new Map<string, { covered: boolean; page: string; label: string }>();\n  const references = new PageProblems();\n\n  for (const page of pages) {\n    for (const element of descendants(page.root)) {\n      const reference = classesOf(element).find((token) => K2_REFERENCE_CLASS.test(token));\n      if (reference) references.add(page.path, `A reference-skin class (${reference}) ships; those belong to the library's own tests`);\n\n      const hook = attr(element, \"data-bl\");\n      const section = attr(element, \"data-bl-section\");\n      const key = hook !== undefined && hooks.has(hook) ? `hook:${hook}` : section !== undefined && sections.has(section) ? `section:${section}` : null;\n      if (!key) continue;\n      const label = hook !== undefined ? `data-bl=\"${hook}\"` : `data-bl-section=\"${section}\"`;\n      const carries = skinSurface(element).some((candidate) => classesOf(candidate).length > 0);\n      const known = components.get(key);\n      if (known) known.covered ||= carries;\n      else components.set(key, { covered: carries, page: page.path, label });\n    }\n  }\n\n  const failures = references.findings(\"K2\");\n  if (components.size === 0 && failures.length === 0) return [notApplicable(\"K2\", \"None of the sampled pages renders a shared component.\")];\n  const uncovered = [...components].filter(([, component]) => !component.covered);\n  if (uncovered.length > 0) {\n    const styled = hooksStyledBySite(projectRoot);\n    for (const [key, component] of uncovered) {\n      const name = key.slice(key.indexOf(\":\") + 1);\n      if (styled.has(name)) continue;\n      failures.push(fail(\"K2\", component.page, `${component.label} is rendered (first on ${component.page}) with no skin class on its root or slots and no selector for it in the site's stylesheets, so it has no skin entry.`));\n    }\n  }\n  if (failures.length > 0) return failures;\n  return [pass(\"K2\", `Checked ${plural(components.size, \"shared component\")} on ${plural(pages.length, \"page\")}: each carries a skin class or is styled by the site's own CSS, and no reference-skin class ships.`)];\n}\n"]}

package/dist/site-system/rules/sections/n9-footer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * N9: footer content (Site System v2 §13.2, v1 §6).
+ *
+ * - Column 1 holds the logo, a short description, the licence numbers (when the business holds licences), social and
+ *   profile links, and the contact details (a `tel:` link; an email when public).
+ * - Then Services, Areas (regions or popular areas) and Company, each under a real heading (an H2 to H6 with text and
+ *   links beneath it), in that order. A site with no areas to list may leave that column out: it is reported as a
+ *   warning, not a failure, because the library lets a site leave out a column it has nothing true for.
+ * - The bottom bar holds © and the trading name, the ABN and the legal links (privacy and terms).
+ * - Never a call-to-action button, "based in", opening hours or notes about hours, or a guides column.
+ *
+ * Library footers are read by their slots (`brand`, `columns`, `column`, `bottom`); any other footer is read by its
+ * headings, so a hand-written footer is held to the same content.
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "../enquiry/common.js";
+import { type HtmlElement } from "../enquiry/html.js";
+type ColumnKey = "services" | "areas" | "company" | "guides" | "other";
+interface Column {
+    readonly key: ColumnKey;
+    readonly heading: string;
+    readonly links: number;
+    readonly element: HtmlElement;
+}
+/** The footer of a page: the library footer, else the page-level `<footer>`. */
+export declare function footerOf(root: HtmlElement): HtmlElement | null;
+/** The footer's columns, in order. A column is a heading and the links under it. */
+export declare function footerColumns(footer: HtmlElement, bottom: HtmlElement | undefined): Column[];
+export interface FooterFacts {
+    /** Licence identifiers the business holds; an empty list when none are recorded or the facts could not be read. */
+    readonly licences: readonly string[];
+}
+/** Every problem and warning with one footer, as clauses with no subject. */
+export declare function footerProblems(footer: HtmlElement, facts: FooterFacts): {
+    problems: string[];
+    warnings: string[];
+};
+export declare function checkN9(pages: readonly ParsedPage[], projectRoot: string): SiteSystemFinding[];
+export {};
+//# sourceMappingURL=n9-footer.d.ts.map

package/dist/site-system/rules/sections/n9-footer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n9-footer.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/sections/n9-footer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAuD,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAoB3G,KAAK,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,UAAU,MAAM;IACd,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CAO9D;AAeD,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,EAAE,CAgB5F;AAkBD,MAAM,WAAW,WAAW;IAC1B,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAMD,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA+DlH;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAsB9F"}

package/dist/site-system/rules/sections/n9-footer.js

@@ -0,0 +1,186 @@
+import { fail, notApplicable, pass, plural } from "../enquiry/common.js";
+import { ancestors, attr, descendants, normaliseText, textOf } from "../enquiry/html.js";
+import { PageProblems } from "../library/common.js";
+import { loadShellProjectFacts } from "../shell/facts.js";
+const SOCIAL_HOSTS = /(?:^|\.)(?:facebook|instagram|linkedin|youtube|tiktok|x|twitter|pinterest|houzz|hipages|yelp|threads)\.com$|(?:^|\.)g\.page$|(?:^|\.)goo\.gl$|(?:^|\.)youtu\.be$/i;
+const PROFILE_PATH = /^(?:\/maps|\/search|\/local)/i;
+const HEADING = /^h[2-6]$/;
+const AREAS_HEADING = /\b(?:areas?|regions?|suburbs?|locations?|councils?|where we (?:work|service|cover)|we (?:service|cover|work in)|coverage)\b/i;
+const SERVICES_HEADING = /\b(?:services?|what we do|our work|trades?|solutions)\b/i;
+const COMPANY_HEADING = /\b(?:company|about|information|business|our firm|our company)\b/i;
+const GUIDES_HEADING = /\b(?:guides?|cost guides?|resources|articles|advice)\b/i;
+const CTA_LABEL = /^\s*(?:get|request|book|schedule|claim|start)\b.*\b(?:quote|estimate|inspection|booking|now|online|today)\b|^\s*(?:free|instant)\s+(?:quote|estimate|inspection)|^\s*enquire\b|^\s*call\s+now\b/i;
+const HOURS = [
+    /\b(?:opening|business|office|trading|operating)\s+hours\b/i,
+    /\bhours\s*[:–-]/i,
+    /\bmon(?:day)?\s*(?:-|–|to|through|thru)\s*(?:fri(?:day)?|sat(?:urday)?|sun(?:day)?)\b/i,
+    /\b\d{1,2}(?::\d{2})?\s*(?:am|pm)\s*(?:-|–|to)\s*\d{1,2}(?::\d{2})?\s*(?:am|pm)\b/i,
+    /\b24\s*\/\s*7\b|\bopen\s+(?:24\s+hours|7\s+days|seven\s+days)\b/i,
+];
+/** The footer of a page: the library footer, else the page-level `<footer>`. */
+export function footerOf(root) {
+    const all = descendants(root);
+    return (all.find((element) => attr(element, "data-bl") === "footer") ??
+        all.find((element) => element.tag === "footer" && !ancestors(element).some((parent) => ["article", "section", "aside", "main", "blockquote", "dialog"].includes(parent.tag))) ??
+        null);
+}
+function classify(heading, declared) {
+    if (declared === "services" || declared === "areas" || declared === "company" || declared === "guides")
+        return declared;
+    if (GUIDES_HEADING.test(heading))
+        return "guides";
+    if (AREAS_HEADING.test(heading))
+        return "areas";
+    if (SERVICES_HEADING.test(heading))
+        return "services";
+    if (COMPANY_HEADING.test(heading))
+        return "company";
+    return "other";
+}
+function anchors(element) {
+    return descendants(element).filter((child) => child.tag === "a" && (attr(child, "href") ?? "") !== "");
+}
+/** The footer's columns, in order. A column is a heading and the links under it. */
+export function footerColumns(footer, bottom) {
+    const slotted = descendants(footer).filter((element) => attr(element, "data-slot") === "column");
+    if (slotted.length > 0) {
+        return slotted.map((element) => {
+            const heading = descendants(element).find((child) => HEADING.test(child.tag));
+            const text = heading ? textOf(heading, true, (child) => child.tag === "button") : "";
+            return { key: classify(text, attr(element, "data-column")), heading: text, links: anchors(element).length, element };
+        });
+    }
+    const headings = descendants(footer).filter((element) => HEADING.test(element.tag) && !(bottom && ancestors(element).includes(bottom)));
+    return headings.map((heading) => {
+        let scope = heading.parent ?? footer;
+        while (scope !== footer && descendants(scope).filter((element) => HEADING.test(element.tag)).length > 1)
+            scope = scope.parent ?? footer;
+        const text = textOf(heading, true);
+        return { key: classify(text, undefined), heading: text, links: anchors(scope).length, element: scope };
+    });
+}
+function hostOf(href) {
+    try {
+        const url = new URL(href);
+        return { host: url.hostname.toLowerCase(), path: url.pathname };
+    }
+    catch {
+        return null;
+    }
+}
+function isSocialOrProfile(link) {
+    const target = hostOf(attr(link, "href") ?? "");
+    if (!target)
+        return false;
+    if (SOCIAL_HOSTS.test(target.host))
+        return true;
+    return /(?:^|\.)google\.[a-z.]+$/.test(target.host) && PROFILE_PATH.test(target.path);
+}
+function compact(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+/** Every problem and warning with one footer, as clauses with no subject. */
+export function footerProblems(footer, facts) {
+    const problems = [];
+    const warnings = [];
+    const text = textOf(footer, true);
+    const bottom = descendants(footer).find((element) => attr(element, "data-slot") === "bottom");
+    const columns = footerColumns(footer, bottom);
+    const brand = descendants(footer).find((element) => attr(element, "data-slot") === "brand");
+    const inBottom = (element) => bottom !== undefined && ancestors(element).includes(bottom);
+    // Column 1.
+    const logo = descendants(footer).some((element) => (element.tag === "img" || element.tag === "svg") && ancestors(element).some((parent) => parent.tag === "a") && !inBottom(element));
+    if (!logo)
+        problems.push("has no logo linking home in column 1");
+    const describes = brand
+        ? descendants(brand).some((element) => attr(element, "data-slot") === "description" && textOf(element).split(/\s+/).length >= 6)
+        : descendants(footer).some((element) => element.tag === "p" && textOf(element).split(/\s+/).length >= 12 && !inBottom(element) && !columns.some((column) => ancestors(element).includes(column.element)));
+    if (!describes)
+        problems.push("has no short description of the business in column 1");
+    const footerCompact = compact(text);
+    const missingLicences = facts.licences.filter((licence) => !footerCompact.includes(compact(licence)));
+    if (missingLicences.length > 0)
+        problems.push(`does not show ${missingLicences.length === 1 ? "the licence number" : "the licence numbers"} ${missingLicences.join(", ")}`);
+    if (!anchors(footer).some(isSocialOrProfile))
+        warnings.push("has no social or Business Profile links in column 1");
+    if (!anchors(footer).some((link) => (attr(link, "href") ?? "").trim().toLowerCase().startsWith("tel:")))
+        problems.push("has no tel: contact link in column 1");
+    // Columns.
+    const present = columns.filter((column) => column.key !== "other");
+    for (const key of ["services", "company"]) {
+        const column = columns.find((candidate) => candidate.key === key);
+        if (!column)
+            problems.push(`has no ${key} column under a real heading`);
+        else if (column.links === 0)
+            problems.push(`has a ${key} column ("${column.heading}") with no links`);
+    }
+    const areas = columns.find((candidate) => candidate.key === "areas");
+    if (!areas)
+        warnings.push("has no areas column");
+    else if (areas.links === 0)
+        problems.push(`has an areas column ("${areas.heading}") with no links`);
+    const order = present.map((column) => column.key).filter((key) => key !== "guides");
+    const wanted = ["services", "areas", "company"].filter((key) => order.includes(key));
+    if (order.length === wanted.length && order.some((key, index) => key !== wanted[index]))
+        problems.push("runs its columns out of order (services, then areas, then company)");
+    for (const column of columns) {
+        if (column.heading === "")
+            problems.push("has a column with no real heading");
+    }
+    const guides = columns.find((column) => column.key === "guides");
+    if (guides)
+        problems.push(`has a guides column ("${guides.heading}")`);
+    // Bottom bar.
+    const legalText = bottom ? textOf(bottom, true) : text;
+    if (!/(?:©|\(c\)|&copy;)\s*(?:\d{4}\s*)?[A-Za-z]/.test(legalText))
+        problems.push("has no © line with the trading name in the bottom bar");
+    const abn = /\bABN\b[\s:.]*((?:\d[\s]*){11})(?!\d)/i.exec(legalText);
+    if (!abn)
+        problems.push("shows no ABN in the bottom bar");
+    const legalLinks = anchors(bottom ?? footer).map((link) => `${attr(link, "href") ?? ""} ${textOf(link)}`.toLowerCase());
+    if (!legalLinks.some((value) => value.includes("privacy")))
+        problems.push("has no privacy policy link in the bottom bar");
+    if (!legalLinks.some((value) => /terms|conditions/.test(value)))
+        problems.push("has no terms link in the bottom bar");
+    // Never.
+    const cta = descendants(footer).find((element) => attr(element, "data-bl") === "quote-button" ||
+        attr(element, "data-bl-cta") !== undefined ||
+        (element.tag === "button" && attr(element, "data-slot") !== "toggle" && attr(element, "type") !== "button") ||
+        ((element.tag === "a" || element.tag === "button") && attr(element, "data-bl") !== "phone-link" && CTA_LABEL.test(normaliseText(textOf(element)))));
+    if (cta)
+        problems.push(`has a call-to-action button ("${normaliseText(textOf(cta)) || "button"}")`);
+    if (/\bbased\s+in\b/i.test(text))
+        problems.push('says "based in"');
+    const hours = HOURS.map((pattern) => pattern.exec(text)).find((match) => match !== null);
+    if (hours)
+        problems.push(`shows opening hours ("${hours[0]}")`);
+    return { problems, warnings };
+}
+export function checkN9(pages, projectRoot) {
+    if (pages.length === 0)
+        return [notApplicable("N9", "No page could be read, so there is no footer to check.")];
+    const { facts, reason } = loadShellProjectFacts(projectRoot);
+    const footerFacts = { licences: (facts?.licences ?? []).map((licence) => licence.identifier).filter(Boolean) };
+    const problems = new PageProblems();
+    const notes = new PageProblems();
+    for (const page of pages) {
+        const footer = footerOf(page.root);
+        if (!footer) {
+            problems.add(page.path, "No footer");
+            continue;
+        }
+        const found = footerProblems(footer, footerFacts);
+        for (const problem of found.problems)
+            problems.add(page.path, `The footer ${problem}`);
+        for (const warning of found.warnings)
+            notes.add(page.path, `The footer ${warning}`);
+    }
+    const warnings = notes.findings("N9").map((finding) => ({ ...finding, status: "pass", severity: "warning" }));
+    if (facts === null) {
+        warnings.push({ checkId: "N9", status: "pass", severity: "warning", message: `The licence numbers in the footer were not checked: ${reason.charAt(0).toLowerCase()}${reason.slice(1)}` });
+    }
+    if (problems.size > 0)
+        return [...problems.findings("N9"), ...warnings];
+    return [pass("N9", `Checked the footer on ${plural(pages.length, "page")}: column 1, the services and company columns, the bottom bar and what a footer never holds are all in order.`), ...warnings];
+}
+//# sourceMappingURL=n9-footer.js.map

package/dist/site-system/rules/sections/n9-footer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n9-footer.js","sourceRoot":"","sources":["../../../../src/site-system/rules/sections/n9-footer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * N9: footer content (Site System v2 §13.2, v1 §6).\n *\n * - Column 1 holds the logo, a short description, the licence numbers (when the business holds licences), social and\n *   profile links, and the contact details (a `tel:` link; an email when public).\n * - Then Services, Areas (regions or popular areas) and Company, each under a real heading (an H2 to H6 with text and\n *   links beneath it), in that order. A site with no areas to list may leave that column out: it is reported as a\n *   warning, not a failure, because the library lets a site leave out a column it has nothing true for.\n * - The bottom bar holds © and the trading name, the ABN and the legal links (privacy and terms).\n * - Never a call-to-action button, \"based in\", opening hours or notes about hours, or a guides column.\n *\n * Library footers are read by their slots (`brand`, `columns`, `column`, `bottom`); any other footer is read by its\n * headings, so a hand-written footer is held to the same content.\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { fail, notApplicable, pass, plural, type ParsedPage } from \"../enquiry/common.js\";\nimport { ancestors, attr, descendants, normaliseText, textOf, type HtmlElement } from \"../enquiry/html.js\";\nimport { PageProblems } from \"../library/common.js\";\nimport { loadShellProjectFacts } from \"../shell/facts.js\";\n\nconst SOCIAL_HOSTS = /(?:^|\\.)(?:facebook|instagram|linkedin|youtube|tiktok|x|twitter|pinterest|houzz|hipages|yelp|threads)\\.com$|(?:^|\\.)g\\.page$|(?:^|\\.)goo\\.gl$|(?:^|\\.)youtu\\.be$/i;\nconst PROFILE_PATH = /^(?:\\/maps|\\/search|\\/local)/i;\nconst HEADING = /^h[2-6]$/;\nconst AREAS_HEADING = /\\b(?:areas?|regions?|suburbs?|locations?|councils?|where we (?:work|service|cover)|we (?:service|cover|work in)|coverage)\\b/i;\nconst SERVICES_HEADING = /\\b(?:services?|what we do|our work|trades?|solutions)\\b/i;\nconst COMPANY_HEADING = /\\b(?:company|about|information|business|our firm|our company)\\b/i;\nconst GUIDES_HEADING = /\\b(?:guides?|cost guides?|resources|articles|advice)\\b/i;\nconst CTA_LABEL = /^\\s*(?:get|request|book|schedule|claim|start)\\b.*\\b(?:quote|estimate|inspection|booking|now|online|today)\\b|^\\s*(?:free|instant)\\s+(?:quote|estimate|inspection)|^\\s*enquire\\b|^\\s*call\\s+now\\b/i;\nconst HOURS = [\n  /\\b(?:opening|business|office|trading|operating)\\s+hours\\b/i,\n  /\\bhours\\s*[:–-]/i,\n  /\\bmon(?:day)?\\s*(?:-|–|to|through|thru)\\s*(?:fri(?:day)?|sat(?:urday)?|sun(?:day)?)\\b/i,\n  /\\b\\d{1,2}(?::\\d{2})?\\s*(?:am|pm)\\s*(?:-|–|to)\\s*\\d{1,2}(?::\\d{2})?\\s*(?:am|pm)\\b/i,\n  /\\b24\\s*\\/\\s*7\\b|\\bopen\\s+(?:24\\s+hours|7\\s+days|seven\\s+days)\\b/i,\n];\n\ntype ColumnKey = \"services\" | \"areas\" | \"company\" | \"guides\" | \"other\";\n\ninterface Column {\n  readonly key: ColumnKey;\n  readonly heading: string;\n  readonly links: number;\n  readonly element: HtmlElement;\n}\n\n/** The footer of a page: the library footer, else the page-level `<footer>`. */\nexport function footerOf(root: HtmlElement): HtmlElement | null {\n  const all = descendants(root);\n  return (\n    all.find((element) => attr(element, \"data-bl\") === \"footer\") ??\n    all.find((element) => element.tag === \"footer\" && !ancestors(element).some((parent) => [\"article\", \"section\", \"aside\", \"main\", \"blockquote\", \"dialog\"].includes(parent.tag))) ??\n    null\n  );\n}\n\nfunction classify(heading: string, declared: string | undefined): ColumnKey {\n  if (declared === \"services\" || declared === \"areas\" || declared === \"company\" || declared === \"guides\") return declared;\n  if (GUIDES_HEADING.test(heading)) return \"guides\";\n  if (AREAS_HEADING.test(heading)) return \"areas\";\n  if (SERVICES_HEADING.test(heading)) return \"services\";\n  if (COMPANY_HEADING.test(heading)) return \"company\";\n  return \"other\";\n}\n\nfunction anchors(element: HtmlElement): HtmlElement[] {\n  return descendants(element).filter((child) => child.tag === \"a\" && (attr(child, \"href\") ?? \"\") !== \"\");\n}\n\n/** The footer's columns, in order. A column is a heading and the links under it. */\nexport function footerColumns(footer: HtmlElement, bottom: HtmlElement | undefined): Column[] {\n  const slotted = descendants(footer).filter((element) => attr(element, \"data-slot\") === \"column\");\n  if (slotted.length > 0) {\n    return slotted.map((element) => {\n      const heading = descendants(element).find((child) => HEADING.test(child.tag));\n      const text = heading ? textOf(heading, true, (child) => child.tag === \"button\") : \"\";\n      return { key: classify(text, attr(element, \"data-column\")), heading: text, links: anchors(element).length, element };\n    });\n  }\n  const headings = descendants(footer).filter((element) => HEADING.test(element.tag) && !(bottom && ancestors(element).includes(bottom)));\n  return headings.map((heading) => {\n    let scope: HtmlElement = heading.parent ?? footer;\n    while (scope !== footer && descendants(scope).filter((element) => HEADING.test(element.tag)).length > 1) scope = scope.parent ?? footer;\n    const text = textOf(heading, true);\n    return { key: classify(text, undefined), heading: text, links: anchors(scope).length, element: scope };\n  });\n}\n\nfunction hostOf(href: string): { host: string; path: string } | null {\n  try {\n    const url = new URL(href);\n    return { host: url.hostname.toLowerCase(), path: url.pathname };\n  } catch {\n    return null;\n  }\n}\n\nfunction isSocialOrProfile(link: HtmlElement): boolean {\n  const target = hostOf(attr(link, \"href\") ?? \"\");\n  if (!target) return false;\n  if (SOCIAL_HOSTS.test(target.host)) return true;\n  return /(?:^|\\.)google\\.[a-z.]+$/.test(target.host) && PROFILE_PATH.test(target.path);\n}\n\nexport interface FooterFacts {\n  /** Licence identifiers the business holds; an empty list when none are recorded or the facts could not be read. */\n  readonly licences: readonly string[];\n}\n\nfunction compact(value: string): string {\n  return value.toLowerCase().replace(/[^a-z0-9]/g, \"\");\n}\n\n/** Every problem and warning with one footer, as clauses with no subject. */\nexport function footerProblems(footer: HtmlElement, facts: FooterFacts): { problems: string[]; warnings: string[] } {\n  const problems: string[] = [];\n  const warnings: string[] = [];\n  const text = textOf(footer, true);\n  const bottom = descendants(footer).find((element) => attr(element, \"data-slot\") === \"bottom\");\n  const columns = footerColumns(footer, bottom);\n  const brand = descendants(footer).find((element) => attr(element, \"data-slot\") === \"brand\");\n  const inBottom = (element: HtmlElement) => bottom !== undefined && ancestors(element).includes(bottom);\n\n  // Column 1.\n  const logo = descendants(footer).some((element) => (element.tag === \"img\" || element.tag === \"svg\") && ancestors(element).some((parent) => parent.tag === \"a\") && !inBottom(element));\n  if (!logo) problems.push(\"has no logo linking home in column 1\");\n  const describes = brand\n    ? descendants(brand).some((element) => attr(element, \"data-slot\") === \"description\" && textOf(element).split(/\\s+/).length >= 6)\n    : descendants(footer).some((element) => element.tag === \"p\" && textOf(element).split(/\\s+/).length >= 12 && !inBottom(element) && !columns.some((column) => ancestors(element).includes(column.element)));\n  if (!describes) problems.push(\"has no short description of the business in column 1\");\n  const footerCompact = compact(text);\n  const missingLicences = facts.licences.filter((licence) => !footerCompact.includes(compact(licence)));\n  if (missingLicences.length > 0) problems.push(`does not show ${missingLicences.length === 1 ? \"the licence number\" : \"the licence numbers\"} ${missingLicences.join(\", \")}`);\n  if (!anchors(footer).some(isSocialOrProfile)) warnings.push(\"has no social or Business Profile links in column 1\");\n  if (!anchors(footer).some((link) => (attr(link, \"href\") ?? \"\").trim().toLowerCase().startsWith(\"tel:\"))) problems.push(\"has no tel: contact link in column 1\");\n\n  // Columns.\n  const present = columns.filter((column) => column.key !== \"other\");\n  for (const key of [\"services\", \"company\"] as const) {\n    const column = columns.find((candidate) => candidate.key === key);\n    if (!column) problems.push(`has no ${key} column under a real heading`);\n    else if (column.links === 0) problems.push(`has a ${key} column (\"${column.heading}\") with no links`);\n  }\n  const areas = columns.find((candidate) => candidate.key === \"areas\");\n  if (!areas) warnings.push(\"has no areas column\");\n  else if (areas.links === 0) problems.push(`has an areas column (\"${areas.heading}\") with no links`);\n  const order = present.map((column) => column.key).filter((key): key is \"services\" | \"areas\" | \"company\" => key !== \"guides\");\n  const wanted = ([\"services\", \"areas\", \"company\"] as const).filter((key) => order.includes(key));\n  if (order.length === wanted.length && order.some((key, index) => key !== wanted[index])) problems.push(\"runs its columns out of order (services, then areas, then company)\");\n  for (const column of columns) {\n    if (column.heading === \"\") problems.push(\"has a column with no real heading\");\n  }\n  const guides = columns.find((column) => column.key === \"guides\");\n  if (guides) problems.push(`has a guides column (\"${guides.heading}\")`);\n\n  // Bottom bar.\n  const legalText = bottom ? textOf(bottom, true) : text;\n  if (!/(?:©|\\(c\\)|&copy;)\\s*(?:\\d{4}\\s*)?[A-Za-z]/.test(legalText)) problems.push(\"has no © line with the trading name in the bottom bar\");\n  const abn = /\\bABN\\b[\\s:.]*((?:\\d[\\s]*){11})(?!\\d)/i.exec(legalText);\n  if (!abn) problems.push(\"shows no ABN in the bottom bar\");\n  const legalLinks = anchors(bottom ?? footer).map((link) => `${attr(link, \"href\") ?? \"\"} ${textOf(link)}`.toLowerCase());\n  if (!legalLinks.some((value) => value.includes(\"privacy\"))) problems.push(\"has no privacy policy link in the bottom bar\");\n  if (!legalLinks.some((value) => /terms|conditions/.test(value))) problems.push(\"has no terms link in the bottom bar\");\n\n  // Never.\n  const cta = descendants(footer).find(\n    (element) =>\n      attr(element, \"data-bl\") === \"quote-button\" ||\n      attr(element, \"data-bl-cta\") !== undefined ||\n      (element.tag === \"button\" && attr(element, \"data-slot\") !== \"toggle\" && attr(element, \"type\") !== \"button\") ||\n      ((element.tag === \"a\" || element.tag === \"button\") && attr(element, \"data-bl\") !== \"phone-link\" && CTA_LABEL.test(normaliseText(textOf(element)))),\n  );\n  if (cta) problems.push(`has a call-to-action button (\"${normaliseText(textOf(cta)) || \"button\"}\")`);\n  if (/\\bbased\\s+in\\b/i.test(text)) problems.push('says \"based in\"');\n  const hours = HOURS.map((pattern) => pattern.exec(text)).find((match) => match !== null);\n  if (hours) problems.push(`shows opening hours (\"${hours[0]}\")`);\n  return { problems, warnings };\n}\n\nexport function checkN9(pages: readonly ParsedPage[], projectRoot: string): SiteSystemFinding[] {\n  if (pages.length === 0) return [notApplicable(\"N9\", \"No page could be read, so there is no footer to check.\")];\n  const { facts, reason } = loadShellProjectFacts(projectRoot);\n  const footerFacts: FooterFacts = { licences: (facts?.licences ?? []).map((licence) => licence.identifier).filter(Boolean) };\n  const problems = new PageProblems();\n  const notes = new PageProblems();\n  for (const page of pages) {\n    const footer = footerOf(page.root);\n    if (!footer) {\n      problems.add(page.path, \"No footer\");\n      continue;\n    }\n    const found = footerProblems(footer, footerFacts);\n    for (const problem of found.problems) problems.add(page.path, `The footer ${problem}`);\n    for (const warning of found.warnings) notes.add(page.path, `The footer ${warning}`);\n  }\n  const warnings = notes.findings(\"N9\").map((finding) => ({ ...finding, status: \"pass\" as const, severity: \"warning\" as const }));\n  if (facts === null) {\n    warnings.push({ checkId: \"N9\", status: \"pass\", severity: \"warning\", message: `The licence numbers in the footer were not checked: ${reason.charAt(0).toLowerCase()}${reason.slice(1)}` });\n  }\n  if (problems.size > 0) return [...problems.findings(\"N9\"), ...warnings];\n  return [pass(\"N9\", `Checked the footer on ${plural(pages.length, \"page\")}: column 1, the services and company columns, the bottom bar and what a footer never holds are all in order.`), ...warnings];\n}\n"]}

package/dist/site-system/rules/sections/t6-media-entries.d.ts

@@ -0,0 +1,14 @@
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "../enquiry/common.js";
+export declare const T6_MEDIA_PATH = "src/data/media.ts";
+export declare const T6_PROVENANCES: readonly ["genuine", "stock", "illustrative-ai"];
+export interface MediaManifest {
+    /** Media id to its `src`. */
+    readonly sources: ReadonlyMap<string, string>;
+    /** Problems with entries, one plain fragment each ("media.hero has no provenance"). */
+    readonly entryProblems: readonly string[];
+}
+/** "missing": no media.ts; "not-declared": no defineMedia call in it; null: unreadable; else the manifest. */
+export declare function readMediaManifest(projectRoot: string): MediaManifest | "missing" | "not-declared" | null;
+export declare function checkT6(pages: readonly ParsedPage[], projectRoot: string): SiteSystemFinding[];
+//# sourceMappingURL=t6-media-entries.d.ts.map

package/dist/site-system/rules/sections/t6-media-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t6-media-entries.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/sections/t6-media-entries.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAK1F,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,eAAO,MAAM,cAAc,kDAAmD,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,uFAAuF;IACvF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CA2BxG;AAOD,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAgC9F"}