@brandlab-digital/conformance 3.7.0 → 3.9.0

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

@@ -0,0 +1,212 @@
+import { implementationWordingMatches } from "../../../public-copy.js";
+import { BASED_IN, KM_FROM_BASE } from "./location-wording.js";
+import { closest } from "./html.js";
+import { elementAt, excerpt, inAny } from "./page.js";
+import { failFinding, passFinding, sampledPages, warningFinding } from "./types.js";
+export const BANNED_PATTERNS = [
+    // Layer 1, everywhere.
+    { id: "reassurance-filler", layer: 1, label: "a reassurance or helper line",
+        regex: /\bwe\s+(?:only|will\s+only)\s+use\s+your\s+(?:details|information|info|data)\s+to\s+(?:reply|respond|contact|get\s+back)|\ball\s+fields\s+(?:are\s+)?(?:needed|required)\b|\bphotos?\s+(?:are|is)\s+optional\b|\bwe(?:'ll|\s+will)\s+never\s+(?:share|sell|spam|pass\s+on)\b/i },
+    { id: "site-explaining", layer: 1, label: "text that explains the website or the quoting process",
+        regex: /\b(?:browse|explore|scroll\s+through|have\s+a\s+look\s+through|take\s+a\s+look\s+through)\b[^.!?\n]{0,40}\b(?:below|on\s+(?:this|our)\s+(?:page|site|website))\b|\b(?:use|fill\s+(?:in|out)|complete|submit)\s+(?:the|our|this)\s+(?:(?:quick|short|simple|online|quote|contact|enquiry)\s+)*form\s+(?:below|above)\b|\bwelcome\s+to\s+(?:our|the)\s+(?:new\s+)?(?:website|site|web\s?page)\b|\b(?:our|the)\s+(?:simple\s+|easy\s+)?quot(?:e|ing)\s+process\b|^\W*(?:so,?\s+)?what\s+happens\s+next\W*$/i },
+    { id: "price-source", layer: 1, label: "a price source or market-rate line",
+        regex: /\bmarket\s+rates?\b|\bgeneral\s+market\s+pric(?:e|es|ing)\b|\bmarket\s+pricing\b/i },
+    // Layer 2, headers, heroes and location pages.
+    { id: "based-in", layer: 2, label: "a \"based in\" line",
+        regex: BASED_IN },
+    { id: "km-from-base", layer: 2, label: "a distance from the base",
+        regex: KM_FROM_BASE },
+    { id: "walk-ins", layer: 2, label: "a \"no walk-ins\" line",
+        regex: /\bno\s+(?:customer\s+)?walk[- ]?ins?\b/i },
+    // Layer 3, the trade claims scan. Each needs evidence in the claims register.
+    { id: "licensed-claim", layer: 3, label: "a \"licensed\" claim without a licence number",
+        regex: /\b(?:fully|properly|100\s?%)\s+licen[cs]ed\b|\blicen[cs]ed\s+(?:and|&)\s+(?:insured|certified|qualified)\b|\bqualified,?\s+(?:and\s+)?licen[cs]ed\b|\b(?:we(?:'re|\s+are)|all\s+(?:our|of\s+our)\s+\w+\s+(?:are|is)|our\s+(?:team|tradies|\w+)\s+(?:is|are))\s+licen[cs]ed\b/i },
+    { id: "24-7", layer: 3, label: "a 24/7 or round-the-clock promise",
+        regex: /\b24\s*\/\s*7\b|\b24\s*(?:hours?|hrs?)\s*(?:a|per)\s*day\b|\b24[- ]hours?\s+(?:emergency|service|call[- ]?outs?|response|availability|support)\b|\bopen\s+24\s*hours\b/i },
+    { id: "response-time", layer: 3, label: "a minute or hour response promise",
+        regex: /\b(?:within|in)\s+(?:the\s+)?(?:\d{1,3}|an|one|fifteen|twenty|thirty|sixty)\s*(?:-\s*)?(?:minutes?|mins?|hours?|hrs?)\b(?=[^.]{0,40}\b(?:response|respond|reply|arrive|arrival|on[- ]site|at\s+your\s+door|call\s+back|there)\b)|\b(?:response|respond|reply|arrive|arrival|on[- ]site|at\s+your\s+door|call\s+back|there)\b[^.]{0,40}\b(?:within|in)\s+(?:the\s+)?(?:\d{1,3}|an|one|fifteen|twenty|thirty|sixty)\s*(?:-\s*)?(?:minutes?|mins?|hours?|hrs?)\b|\b\d{1,3}[- ]?(?:minute|min|hour|hr)\s+(?:response|arrival|call[- ]?out|guarantee)\b|\bwithin\s+the\s+hour\b/i },
+    { id: "call-out-fee", layer: 3, label: "a free or $0 call-out claim",
+        regex: /\$\s?0\s*call[- ]?out|\b(?:free|no)\s+call[- ]?out(?:\s+(?:fee|charge))?s?\b/i },
+    { id: "number-one", layer: 3, label: "a \"#1\" claim",
+        regex: /(?:^|[\s(])#\s?1\b|\bnumber\s+(?:one|1)\b|\bno\.?\s?1\s+(?:in|for|choice|rated)\b/i },
+    { id: "best-claim", layer: 3, label: "a \"best\" claim",
+        regex: /\b(?:the\s+)?best\s+(?:\w+\s+){0,4}(?:in|of|around|across)\s+(?:sydney|nsw|new\s+south\s+wales|australia|the\s+(?:north\s+shore|northern\s+beaches|hills|inner\s+west|eastern\s+suburbs|shire))\b|\bvoted\s+(?:the\s+)?best\b/i },
+    { id: "cheapest", layer: 3, label: "a cheapest or lowest-price claim",
+        regex: /\bcheapest\b|\blowest\s+prices?\b|\bunbeatable\s+(?:price|prices|rates?)\b|\bbest\s+prices?\b/i },
+    { id: "leading", layer: 3, label: "a \"leading\" or \"largest\" claim",
+        regex: /\b[A-Z][A-Za-z]+(?:\s[A-Z][A-Za-z]+)?['’]s\s+(?:[Ll]eading|[Ll]argest|[Tt]op|[Pp]remier|[Ff]inest|[Bb]est|[Mm]ost\s+[Tt]rusted)\b|\bleading\s+(?:\w+\s+){0,3}(?:in|of)\s+(?:sydney|nsw|australia)\b/ },
+    { id: "lifetime", layer: 3, label: "a lifetime guarantee claim",
+        regex: /\blifetime\s+(?:warranty|guarantee|guaranteed|workmanship|protection|cover)\b|\bguaranteed\s+for\s+life\b/i },
+    { id: "satisfaction-guarantee", layer: 3, label: "a 100% satisfaction claim",
+        regex: /\b100\s?%\s+(?:satisfaction|guaranteed|guarantee)\b|\bsatisfaction\s+guaranteed\b/i },
+    { id: "beat-any-quote", layer: 3, label: "a \"beat any quote\" promise",
+        regex: /\bbeat\s+any\s+(?:quote|price)\b|\bprice[- ]match(?:ing)?\s+guarantee\b/i },
+    { id: "master-plumber", layer: 3, label: "a \"Master Plumber\" claim without membership evidence",
+        regex: /\bmaster\s+plumbers?\b/i },
+    { id: "dulux-accredited", layer: 3, label: "a \"Dulux accredited\" claim without the certificate",
+        regex: /\bdulux\s+accredited\b/i },
+    { id: "colorbond-accredited", layer: 3, label: "an accredited Colorbond contractor claim without the certificate",
+        regex: /\baccredited\s+colorbond\b/i },
+    { id: "as-3740", layer: 3, label: "an AS 3740 compliance claim without paperwork",
+        regex: /\bAS\s?\/?\s?(?:NZS\s?)?3740\b[^.]{0,40}\bcompl|\bcompl\w*\s+(?:with\s+)?AS\s?\/?\s?(?:NZS\s?)?3740\b/i },
+    { id: "award-winning", layer: 3, label: "an \"award-winning\" claim without evidence of a win",
+        regex: /\baward[- ]winning\b/i },
+    { id: "since-year", layer: 3, label: "a \"since {year}\" claim not matched to the ABN or licence record",
+        regex: /\bsince\s+(?:19|20)\d{2}\b/i },
+    { id: "years-experience", layer: 3, label: "a years-in-business claim not matched to the ABN or licence record",
+        regex: /\b\d{1,3}\s?\+\s*years?\b|\b(?:over|more\s+than|almost|nearly)\s+\d{1,3}\s+years?\b|\b\d{1,3}\s+years?(?:['’]s?)?\s+(?:of\s+)?(?:combined\s+)?(?:experience|in\s+(?:business|the\s+industry|the\s+trade)|trading)\b/i },
+    { id: "council-approved", layer: 3, label: "a \"council-approved\" claim",
+        regex: /\bcouncil[- ]approved\b/i },
+    { id: "interior-designer", layer: 3, label: "an \"interior designer\" claim without evidence",
+        regex: /\b(?:our|we(?:'re|\s+are)|qualified|experienced|professional|expert|team\s+of)\s+(?:\w+\s+){0,2}interior\s+designers?\b/i },
+    { id: "landscape-architect", layer: 3, label: "a \"landscape architect\" claim without registration",
+        regex: /\b(?:our|we(?:'re|\s+are)|qualified|experienced|registered|team\s+of)\s+(?:\w+\s+){0,2}landscape\s+architects?\b/i },
+    { id: "plus-gst", layer: 3, label: "a price shown \"+ GST\" to homeowners",
+        regex: /\+\s*GST\b|\bplus\s+GST\b|\b(?:ex|excl\.?|excluding)\s+GST\b/i },
+    { id: "environmental-claim", layer: 3, label: "an environmental claim without specific evidence",
+        regex: /\beco[- ]?friendly\b|\benvironmentally[- ]friendly\b|\bsustainab(?:le|ility)\b|\bgo(?:ing)?\s+green\b|\bgreen\s+(?:energy|building|solutions?|choices?|alternatives?|products?|credentials|practices)\b|\bcarbon[- ](?:neutral|positive|friendly)\b|\bnet[- ]zero\b|\bzero[- ]emissions?\b|\b(?:save|saving|reduce|cut|lower)\s+(?:up\s+to\s+|by\s+)?\d{1,3}\s?%\s*(?:on\s+|off\s+)?(?:your\s+)?(?:energy|power|electricity|heating|cooling|gas|water)\b/i },
+];
+/** American spellings are advised on, not failed (spec 6.3, layer 1 "warning"). */
+const AMERICAN_WORDS = [
+    "color", "colors", "colored", "neighbor", "neighbors", "neighborhood", "neighborhoods", "favorite", "favorites",
+    "center", "centers", "organize", "organizes", "organized", "organization", "realize", "realizes", "realized",
+    "recognize", "recognizes", "recognized", "specialize", "specializes", "specialized", "customize", "customizes",
+    "customized", "minimize", "minimizes", "minimized", "prioritize", "prioritizes", "prioritized", "summarize",
+    "summarizes", "summarized", "sanitize", "sanitizes", "sanitized", "authorize", "authorizes", "authorized",
+    "aluminum", "curb", "curbs", "gray", "catalog", "catalogs", "tire", "tires", "defense",
+];
+const AMERICAN_SPELLING = new RegExp(`\\b(?:${AMERICAN_WORDS.join("|")})\\b`, "gi");
+const COMPILED = BANNED_PATTERNS.map((pattern) => ({
+    pattern,
+    global: new RegExp(pattern.regex.source, pattern.regex.flags.includes("g") ? pattern.regex.flags : `${pattern.regex.flags}g`),
+}));
+function pageSources(page) {
+    return [
+        ...page.units.map((unit) => ({ text: unit.text, unit, where: "text" })),
+        ...page.attributeCopy.map((unit) => ({ text: unit.text, unit, where: "attribute" })),
+        ...page.metadata.map((text) => ({ text, unit: null, where: "metadata" })),
+        ...page.schemaCopy.map((text) => ({ text, unit: null, where: "schema" })),
+    ];
+}
+function isReviewVoice(element) {
+    return closest(element, (candidate) => candidate.attrs["data-bl-section"] === "reviews" || candidate.attrs["data-bl-source"] === "feed" || candidate.tag === "blockquote" || candidate.attrs.itemprop === "reviewBody") !== null;
+}
+function isMenu(element) {
+    return closest(element, (candidate) => candidate.tag === "nav" || candidate.attrs["data-slot"] === "panel") !== null;
+}
+function layerTwoRegions(page) {
+    if (page.family === "contact")
+        return null;
+    const exclude = [...page.footers];
+    if (page.family === "location")
+        return { include: [page.body], exclude };
+    return { include: [...page.headers, ...(page.hero ? [page.hero] : [])], exclude };
+}
+function recordedMatch(recorded, pattern, matched) {
+    const phrase = matched.toLowerCase();
+    return recorded.some((entry) => {
+        const claim = entry.trim().toLowerCase();
+        return claim === pattern.id || (claim.length > 2 && (phrase.includes(claim) || claim.includes(phrase)));
+    });
+}
+const LICENCE_NUMBER = /\blic(?:en[cs]e)?\.?\s*(?:no\.?|number|#)?\s*:?\s*[A-Z]{0,3}\s?\d{4,}[A-Z]?\b/i;
+function showsLicenceNumber(page, facts) {
+    const text = page.units.map((unit) => unit.text).join(" ");
+    if (LICENCE_NUMBER.test(text))
+        return true;
+    const compact = text.toLowerCase().replace(/[\s\-.]/g, "");
+    return (facts?.licences ?? []).some((licence) => compact.includes(licence.identifier.toLowerCase().replace(/[\s\-.]/g, "")));
+}
+/** A customer's own words, or a block rendered from the feed, are not the business's copy. */
+function isExempt(source, index) {
+    return source.unit !== null && isReviewVoice(elementAt(source.unit, index));
+}
+/** E8 over the sampled pages. */
+export function checkBannedWording(pages, facts, recordedClaims = []) {
+    const findings = [];
+    let claimWarnings = 0;
+    for (const page of pages) {
+        const hits = new Map();
+        const sources = pageSources(page);
+        const licenceShown = showsLicenceNumber(page, facts);
+        const layerTwo = layerTwoRegions(page);
+        for (const { pattern, global } of COMPILED) {
+            for (const source of sources) {
+                if (pattern.layer === 2 && (source.where === "metadata" || source.where === "schema"))
+                    continue;
+                let hit;
+                for (const match of source.text.matchAll(global)) {
+                    if (isExempt(source, match.index))
+                        continue;
+                    if (pattern.layer === 2) {
+                        const element = source.unit ? elementAt(source.unit, match.index) : null;
+                        if (!element || !layerTwo || inAny(element, layerTwo.exclude) || !inAny(element, layerTwo.include))
+                            continue;
+                    }
+                    if (pattern.layer === 3) {
+                        if (recordedMatch(recordedClaims, pattern, match[0]))
+                            continue;
+                        if (pattern.id === "licensed-claim" && licenceShown)
+                            continue;
+                    }
+                    hit = { layer: pattern.layer, label: pattern.label, quote: excerpt(source.text, match.index, match[0].length) };
+                    break;
+                }
+                if (hit) {
+                    hits.set(pattern.id, hit);
+                    break;
+                }
+            }
+        }
+        // Layer 1: price teasers in menus and template wording.
+        for (const unit of page.units) {
+            for (const match of unit.text.matchAll(/\bfrom\s+\$\s?\d/gi)) {
+                const element = elementAt(unit, match.index);
+                if (!isMenu(element) || isReviewVoice(element))
+                    continue;
+                hits.set("menu-price-teaser", { layer: 1, label: "a \"from $X\" price teaser in a menu", quote: excerpt(unit.text, match.index, match[0].length) });
+                break;
+            }
+            if (hits.has("menu-price-teaser"))
+                break;
+        }
+        // Every match counts: an exempt one (a customer's own words) must not hide template wording later in the source.
+        for (const source of sources) {
+            for (const found of implementationWordingMatches(source.text, { singleWord: true })) {
+                if (isExempt(source, found.index))
+                    continue;
+                hits.set("template-wording", { layer: 1, label: "template or placeholder wording", quote: excerpt(source.text, found.index, 10) });
+                break;
+            }
+            if (hits.has("template-wording"))
+                break;
+        }
+        for (const hit of hits.values()) {
+            if (hit.layer === 3)
+                claimWarnings += 1;
+            findings.push(hit.layer === 3
+                ? warningFinding("E8", `Warning: the page ${page.path} shows ${hit.label} ("${hit.quote}"); it needs evidence in the claims register or removing.`, page.path)
+                : failFinding("E8", page.path, `The page ${page.path} shows ${hit.label} ("${hit.quote}"), which the banned list does not allow.`));
+        }
+        const american = new Set();
+        for (const source of sources) {
+            for (const match of source.text.matchAll(AMERICAN_SPELLING)) {
+                if (!isExempt(source, match.index))
+                    american.add(match[0].toLowerCase());
+            }
+        }
+        if (american.size > 0) {
+            findings.push(warningFinding("E8", `Warning: the page ${page.path} uses American spelling (${[...american].slice(0, 4).join(", ")}); client copy is Australian English.`, page.path));
+        }
+    }
+    const failed = findings.some((finding) => finding.status === "fail");
+    if (failed)
+        return findings;
+    const clear = claimWarnings === 0 ? "from any of the three layers" : "from layers 1 and 2 (the claims below need evidence)";
+    return [passFinding("E8", `No banned wording ${clear} on ${sampledPages(pages.length)}.`), ...findings];
+}
+/** Used by tests to confirm which patterns exist for each layer. */
+export function bannedPatternIds(layer) {
+    return BANNED_PATTERNS.filter((pattern) => pattern.layer === layer).map((pattern) => pattern.id);
+}
+//# sourceMappingURL=banned-wording.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banned-wording.js","sourceRoot":"","sources":["../../../../src/site-system/rules/shell/banned-wording.ts"],"names":[],"mappings":"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","sourcesContent":["import { implementationWordingMatches } from \"../../../public-copy.js\";\nimport { BASED_IN, KM_FROM_BASE } from \"./location-wording.js\";\nimport { closest, type HtmlElement } from \"./html.js\";\nimport { elementAt, excerpt, inAny, type ShellPage, type TextUnit } from \"./page.js\";\nimport { failFinding, passFinding, sampledPages, warningFinding, type ShellFinding, type ShellProjectFacts } from \"./types.js\";\n\n/**\n * E8: the banned list, all three layers (spec 6.3). Layer 1 holds everywhere (helper and reassurance filler, text that\n * explains the site or the quoting process, price sources and menu price teasers, template wording). Layer 2 holds on\n * headers, heroes and location pages and is allowed in the footer, on the contact page and in schema. Layer 3 is the\n * trade claims scan: each pattern needs evidence in the claims register. Until a register reader exists, layer 3 is\n * reported as a warning (status \"pass\", severity \"warning\") naming the phrase and page; claims in `recordedClaims`\n * are not reported. A customer's own words (review text and feed blocks) are exempt from every layer.\n * Template wording reuses the existing public-copy patterns.\n */\n\nexport interface BannedPattern {\n  id: string;\n  layer: 1 | 2 | 3;\n  /** What the match is, completing \"shows …\". */\n  label: string;\n  regex: RegExp;\n}\n\nexport const BANNED_PATTERNS: readonly BannedPattern[] = [\n  // Layer 1, everywhere.\n  { id: \"reassurance-filler\", layer: 1, label: \"a reassurance or helper line\",\n    regex: /\\bwe\\s+(?:only|will\\s+only)\\s+use\\s+your\\s+(?:details|information|info|data)\\s+to\\s+(?:reply|respond|contact|get\\s+back)|\\ball\\s+fields\\s+(?:are\\s+)?(?:needed|required)\\b|\\bphotos?\\s+(?:are|is)\\s+optional\\b|\\bwe(?:'ll|\\s+will)\\s+never\\s+(?:share|sell|spam|pass\\s+on)\\b/i },\n  { id: \"site-explaining\", layer: 1, label: \"text that explains the website or the quoting process\",\n    regex: /\\b(?:browse|explore|scroll\\s+through|have\\s+a\\s+look\\s+through|take\\s+a\\s+look\\s+through)\\b[^.!?\\n]{0,40}\\b(?:below|on\\s+(?:this|our)\\s+(?:page|site|website))\\b|\\b(?:use|fill\\s+(?:in|out)|complete|submit)\\s+(?:the|our|this)\\s+(?:(?:quick|short|simple|online|quote|contact|enquiry)\\s+)*form\\s+(?:below|above)\\b|\\bwelcome\\s+to\\s+(?:our|the)\\s+(?:new\\s+)?(?:website|site|web\\s?page)\\b|\\b(?:our|the)\\s+(?:simple\\s+|easy\\s+)?quot(?:e|ing)\\s+process\\b|^\\W*(?:so,?\\s+)?what\\s+happens\\s+next\\W*$/i },\n  { id: \"price-source\", layer: 1, label: \"a price source or market-rate line\",\n    regex: /\\bmarket\\s+rates?\\b|\\bgeneral\\s+market\\s+pric(?:e|es|ing)\\b|\\bmarket\\s+pricing\\b/i },\n\n  // Layer 2, headers, heroes and location pages.\n  { id: \"based-in\", layer: 2, label: \"a \\\"based in\\\" line\",\n    regex: BASED_IN },\n  { id: \"km-from-base\", layer: 2, label: \"a distance from the base\",\n    regex: KM_FROM_BASE },\n  { id: \"walk-ins\", layer: 2, label: \"a \\\"no walk-ins\\\" line\",\n    regex: /\\bno\\s+(?:customer\\s+)?walk[- ]?ins?\\b/i },\n\n  // Layer 3, the trade claims scan. Each needs evidence in the claims register.\n  { id: \"licensed-claim\", layer: 3, label: \"a \\\"licensed\\\" claim without a licence number\",\n    regex: /\\b(?:fully|properly|100\\s?%)\\s+licen[cs]ed\\b|\\blicen[cs]ed\\s+(?:and|&)\\s+(?:insured|certified|qualified)\\b|\\bqualified,?\\s+(?:and\\s+)?licen[cs]ed\\b|\\b(?:we(?:'re|\\s+are)|all\\s+(?:our|of\\s+our)\\s+\\w+\\s+(?:are|is)|our\\s+(?:team|tradies|\\w+)\\s+(?:is|are))\\s+licen[cs]ed\\b/i },\n  { id: \"24-7\", layer: 3, label: \"a 24/7 or round-the-clock promise\",\n    regex: /\\b24\\s*\\/\\s*7\\b|\\b24\\s*(?:hours?|hrs?)\\s*(?:a|per)\\s*day\\b|\\b24[- ]hours?\\s+(?:emergency|service|call[- ]?outs?|response|availability|support)\\b|\\bopen\\s+24\\s*hours\\b/i },\n  { id: \"response-time\", layer: 3, label: \"a minute or hour response promise\",\n    regex: /\\b(?:within|in)\\s+(?:the\\s+)?(?:\\d{1,3}|an|one|fifteen|twenty|thirty|sixty)\\s*(?:-\\s*)?(?:minutes?|mins?|hours?|hrs?)\\b(?=[^.]{0,40}\\b(?:response|respond|reply|arrive|arrival|on[- ]site|at\\s+your\\s+door|call\\s+back|there)\\b)|\\b(?:response|respond|reply|arrive|arrival|on[- ]site|at\\s+your\\s+door|call\\s+back|there)\\b[^.]{0,40}\\b(?:within|in)\\s+(?:the\\s+)?(?:\\d{1,3}|an|one|fifteen|twenty|thirty|sixty)\\s*(?:-\\s*)?(?:minutes?|mins?|hours?|hrs?)\\b|\\b\\d{1,3}[- ]?(?:minute|min|hour|hr)\\s+(?:response|arrival|call[- ]?out|guarantee)\\b|\\bwithin\\s+the\\s+hour\\b/i },\n  { id: \"call-out-fee\", layer: 3, label: \"a free or $0 call-out claim\",\n    regex: /\\$\\s?0\\s*call[- ]?out|\\b(?:free|no)\\s+call[- ]?out(?:\\s+(?:fee|charge))?s?\\b/i },\n  { id: \"number-one\", layer: 3, label: \"a \\\"#1\\\" claim\",\n    regex: /(?:^|[\\s(])#\\s?1\\b|\\bnumber\\s+(?:one|1)\\b|\\bno\\.?\\s?1\\s+(?:in|for|choice|rated)\\b/i },\n  { id: \"best-claim\", layer: 3, label: \"a \\\"best\\\" claim\",\n    regex: /\\b(?:the\\s+)?best\\s+(?:\\w+\\s+){0,4}(?:in|of|around|across)\\s+(?:sydney|nsw|new\\s+south\\s+wales|australia|the\\s+(?:north\\s+shore|northern\\s+beaches|hills|inner\\s+west|eastern\\s+suburbs|shire))\\b|\\bvoted\\s+(?:the\\s+)?best\\b/i },\n  { id: \"cheapest\", layer: 3, label: \"a cheapest or lowest-price claim\",\n    regex: /\\bcheapest\\b|\\blowest\\s+prices?\\b|\\bunbeatable\\s+(?:price|prices|rates?)\\b|\\bbest\\s+prices?\\b/i },\n  { id: \"leading\", layer: 3, label: \"a \\\"leading\\\" or \\\"largest\\\" claim\",\n    regex: /\\b[A-Z][A-Za-z]+(?:\\s[A-Z][A-Za-z]+)?['’]s\\s+(?:[Ll]eading|[Ll]argest|[Tt]op|[Pp]remier|[Ff]inest|[Bb]est|[Mm]ost\\s+[Tt]rusted)\\b|\\bleading\\s+(?:\\w+\\s+){0,3}(?:in|of)\\s+(?:sydney|nsw|australia)\\b/ },\n  { id: \"lifetime\", layer: 3, label: \"a lifetime guarantee claim\",\n    regex: /\\blifetime\\s+(?:warranty|guarantee|guaranteed|workmanship|protection|cover)\\b|\\bguaranteed\\s+for\\s+life\\b/i },\n  { id: \"satisfaction-guarantee\", layer: 3, label: \"a 100% satisfaction claim\",\n    regex: /\\b100\\s?%\\s+(?:satisfaction|guaranteed|guarantee)\\b|\\bsatisfaction\\s+guaranteed\\b/i },\n  { id: \"beat-any-quote\", layer: 3, label: \"a \\\"beat any quote\\\" promise\",\n    regex: /\\bbeat\\s+any\\s+(?:quote|price)\\b|\\bprice[- ]match(?:ing)?\\s+guarantee\\b/i },\n  { id: \"master-plumber\", layer: 3, label: \"a \\\"Master Plumber\\\" claim without membership evidence\",\n    regex: /\\bmaster\\s+plumbers?\\b/i },\n  { id: \"dulux-accredited\", layer: 3, label: \"a \\\"Dulux accredited\\\" claim without the certificate\",\n    regex: /\\bdulux\\s+accredited\\b/i },\n  { id: \"colorbond-accredited\", layer: 3, label: \"an accredited Colorbond contractor claim without the certificate\",\n    regex: /\\baccredited\\s+colorbond\\b/i },\n  { id: \"as-3740\", layer: 3, label: \"an AS 3740 compliance claim without paperwork\",\n    regex: /\\bAS\\s?\\/?\\s?(?:NZS\\s?)?3740\\b[^.]{0,40}\\bcompl|\\bcompl\\w*\\s+(?:with\\s+)?AS\\s?\\/?\\s?(?:NZS\\s?)?3740\\b/i },\n  { id: \"award-winning\", layer: 3, label: \"an \\\"award-winning\\\" claim without evidence of a win\",\n    regex: /\\baward[- ]winning\\b/i },\n  { id: \"since-year\", layer: 3, label: \"a \\\"since {year}\\\" claim not matched to the ABN or licence record\",\n    regex: /\\bsince\\s+(?:19|20)\\d{2}\\b/i },\n  { id: \"years-experience\", layer: 3, label: \"a years-in-business claim not matched to the ABN or licence record\",\n    regex: /\\b\\d{1,3}\\s?\\+\\s*years?\\b|\\b(?:over|more\\s+than|almost|nearly)\\s+\\d{1,3}\\s+years?\\b|\\b\\d{1,3}\\s+years?(?:['’]s?)?\\s+(?:of\\s+)?(?:combined\\s+)?(?:experience|in\\s+(?:business|the\\s+industry|the\\s+trade)|trading)\\b/i },\n  { id: \"council-approved\", layer: 3, label: \"a \\\"council-approved\\\" claim\",\n    regex: /\\bcouncil[- ]approved\\b/i },\n  { id: \"interior-designer\", layer: 3, label: \"an \\\"interior designer\\\" claim without evidence\",\n    regex: /\\b(?:our|we(?:'re|\\s+are)|qualified|experienced|professional|expert|team\\s+of)\\s+(?:\\w+\\s+){0,2}interior\\s+designers?\\b/i },\n  { id: \"landscape-architect\", layer: 3, label: \"a \\\"landscape architect\\\" claim without registration\",\n    regex: /\\b(?:our|we(?:'re|\\s+are)|qualified|experienced|registered|team\\s+of)\\s+(?:\\w+\\s+){0,2}landscape\\s+architects?\\b/i },\n  { id: \"plus-gst\", layer: 3, label: \"a price shown \\\"+ GST\\\" to homeowners\",\n    regex: /\\+\\s*GST\\b|\\bplus\\s+GST\\b|\\b(?:ex|excl\\.?|excluding)\\s+GST\\b/i },\n  { id: \"environmental-claim\", layer: 3, label: \"an environmental claim without specific evidence\",\n    regex: /\\beco[- ]?friendly\\b|\\benvironmentally[- ]friendly\\b|\\bsustainab(?:le|ility)\\b|\\bgo(?:ing)?\\s+green\\b|\\bgreen\\s+(?:energy|building|solutions?|choices?|alternatives?|products?|credentials|practices)\\b|\\bcarbon[- ](?:neutral|positive|friendly)\\b|\\bnet[- ]zero\\b|\\bzero[- ]emissions?\\b|\\b(?:save|saving|reduce|cut|lower)\\s+(?:up\\s+to\\s+|by\\s+)?\\d{1,3}\\s?%\\s*(?:on\\s+|off\\s+)?(?:your\\s+)?(?:energy|power|electricity|heating|cooling|gas|water)\\b/i },\n];\n\n/** American spellings are advised on, not failed (spec 6.3, layer 1 \"warning\"). */\nconst AMERICAN_WORDS = [\n  \"color\", \"colors\", \"colored\", \"neighbor\", \"neighbors\", \"neighborhood\", \"neighborhoods\", \"favorite\", \"favorites\",\n  \"center\", \"centers\", \"organize\", \"organizes\", \"organized\", \"organization\", \"realize\", \"realizes\", \"realized\",\n  \"recognize\", \"recognizes\", \"recognized\", \"specialize\", \"specializes\", \"specialized\", \"customize\", \"customizes\",\n  \"customized\", \"minimize\", \"minimizes\", \"minimized\", \"prioritize\", \"prioritizes\", \"prioritized\", \"summarize\",\n  \"summarizes\", \"summarized\", \"sanitize\", \"sanitizes\", \"sanitized\", \"authorize\", \"authorizes\", \"authorized\",\n  \"aluminum\", \"curb\", \"curbs\", \"gray\", \"catalog\", \"catalogs\", \"tire\", \"tires\", \"defense\",\n];\nconst AMERICAN_SPELLING = new RegExp(`\\\\b(?:${AMERICAN_WORDS.join(\"|\")})\\\\b`, \"gi\");\n\nconst COMPILED = BANNED_PATTERNS.map((pattern) => ({\n  pattern,\n  global: new RegExp(pattern.regex.source, pattern.regex.flags.includes(\"g\") ? pattern.regex.flags : `${pattern.regex.flags}g`),\n}));\n\ninterface Source {\n  text: string;\n  unit: TextUnit | null;\n  /** Where the text renders: page text, an attribute, metadata or schema. */\n  where: \"text\" | \"attribute\" | \"metadata\" | \"schema\";\n}\n\nfunction pageSources(page: ShellPage): Source[] {\n  return [\n    ...page.units.map((unit): Source => ({ text: unit.text, unit, where: \"text\" })),\n    ...page.attributeCopy.map((unit): Source => ({ text: unit.text, unit, where: \"attribute\" })),\n    ...page.metadata.map((text): Source => ({ text, unit: null, where: \"metadata\" })),\n    ...page.schemaCopy.map((text): Source => ({ text, unit: null, where: \"schema\" })),\n  ];\n}\n\nfunction isReviewVoice(element: HtmlElement): boolean {\n  return closest(element, (candidate) =>\n    candidate.attrs[\"data-bl-section\"] === \"reviews\" || candidate.attrs[\"data-bl-source\"] === \"feed\" || candidate.tag === \"blockquote\" || candidate.attrs.itemprop === \"reviewBody\") !== null;\n}\n\nfunction isMenu(element: HtmlElement): boolean {\n  return closest(element, (candidate) => candidate.tag === \"nav\" || candidate.attrs[\"data-slot\"] === \"panel\") !== null;\n}\n\nfunction layerTwoRegions(page: ShellPage): { include: HtmlElement[]; exclude: HtmlElement[] } | null {\n  if (page.family === \"contact\") return null;\n  const exclude = [...page.footers];\n  if (page.family === \"location\") return { include: [page.body], exclude };\n  return { include: [...page.headers, ...(page.hero ? [page.hero] : [])], exclude };\n}\n\nfunction recordedMatch(recorded: readonly string[], pattern: BannedPattern, matched: string): boolean {\n  const phrase = matched.toLowerCase();\n  return recorded.some((entry) => {\n    const claim = entry.trim().toLowerCase();\n    return claim === pattern.id || (claim.length > 2 && (phrase.includes(claim) || claim.includes(phrase)));\n  });\n}\n\nconst LICENCE_NUMBER = /\\blic(?:en[cs]e)?\\.?\\s*(?:no\\.?|number|#)?\\s*:?\\s*[A-Z]{0,3}\\s?\\d{4,}[A-Z]?\\b/i;\n\nfunction showsLicenceNumber(page: ShellPage, facts: ShellProjectFacts | null): boolean {\n  const text = page.units.map((unit) => unit.text).join(\" \");\n  if (LICENCE_NUMBER.test(text)) return true;\n  const compact = text.toLowerCase().replace(/[\\s\\-.]/g, \"\");\n  return (facts?.licences ?? []).some((licence) => compact.includes(licence.identifier.toLowerCase().replace(/[\\s\\-.]/g, \"\")));\n}\n\ninterface Hit {\n  layer: 1 | 2 | 3;\n  label: string;\n  quote: string;\n}\n\n/** A customer's own words, or a block rendered from the feed, are not the business's copy. */\nfunction isExempt(source: Source, index: number): boolean {\n  return source.unit !== null && isReviewVoice(elementAt(source.unit, index));\n}\n\n/** E8 over the sampled pages. */\nexport function checkBannedWording(\n  pages: readonly ShellPage[],\n  facts: ShellProjectFacts | null,\n  recordedClaims: readonly string[] = [],\n): ShellFinding[] {\n  const findings: ShellFinding[] = [];\n  let claimWarnings = 0;\n  for (const page of pages) {\n    const hits = new Map<string, Hit>();\n    const sources = pageSources(page);\n    const licenceShown = showsLicenceNumber(page, facts);\n    const layerTwo = layerTwoRegions(page);\n\n    for (const { pattern, global } of COMPILED) {\n      for (const source of sources) {\n        if (pattern.layer === 2 && (source.where === \"metadata\" || source.where === \"schema\")) continue;\n        let hit: Hit | undefined;\n        for (const match of source.text.matchAll(global)) {\n          if (isExempt(source, match.index)) continue;\n          if (pattern.layer === 2) {\n            const element = source.unit ? elementAt(source.unit, match.index) : null;\n            if (!element || !layerTwo || inAny(element, layerTwo.exclude) || !inAny(element, layerTwo.include)) continue;\n          }\n          if (pattern.layer === 3) {\n            if (recordedMatch(recordedClaims, pattern, match[0])) continue;\n            if (pattern.id === \"licensed-claim\" && licenceShown) continue;\n          }\n          hit = { layer: pattern.layer, label: pattern.label, quote: excerpt(source.text, match.index, match[0].length) };\n          break;\n        }\n        if (hit) {\n          hits.set(pattern.id, hit);\n          break;\n        }\n      }\n    }\n\n    // Layer 1: price teasers in menus and template wording.\n    for (const unit of page.units) {\n      for (const match of unit.text.matchAll(/\\bfrom\\s+\\$\\s?\\d/gi)) {\n        const element = elementAt(unit, match.index);\n        if (!isMenu(element) || isReviewVoice(element)) continue;\n        hits.set(\"menu-price-teaser\", { layer: 1, label: \"a \\\"from $X\\\" price teaser in a menu\", quote: excerpt(unit.text, match.index, match[0].length) });\n        break;\n      }\n      if (hits.has(\"menu-price-teaser\")) break;\n    }\n    // Every match counts: an exempt one (a customer's own words) must not hide template wording later in the source.\n    for (const source of sources) {\n      for (const found of implementationWordingMatches(source.text, { singleWord: true })) {\n        if (isExempt(source, found.index)) continue;\n        hits.set(\"template-wording\", { layer: 1, label: \"template or placeholder wording\", quote: excerpt(source.text, found.index, 10) });\n        break;\n      }\n      if (hits.has(\"template-wording\")) break;\n    }\n\n    for (const hit of hits.values()) {\n      if (hit.layer === 3) claimWarnings += 1;\n      findings.push(hit.layer === 3\n        ? warningFinding(\"E8\", `Warning: the page ${page.path} shows ${hit.label} (\"${hit.quote}\"); it needs evidence in the claims register or removing.`, page.path)\n        : failFinding(\"E8\", page.path, `The page ${page.path} shows ${hit.label} (\"${hit.quote}\"), which the banned list does not allow.`));\n    }\n\n    const american = new Set<string>();\n    for (const source of sources) {\n      for (const match of source.text.matchAll(AMERICAN_SPELLING)) {\n        if (!isExempt(source, match.index)) american.add(match[0].toLowerCase());\n      }\n    }\n    if (american.size > 0) {\n      findings.push(warningFinding(\"E8\", `Warning: the page ${page.path} uses American spelling (${[...american].slice(0, 4).join(\", \")}); client copy is Australian English.`, page.path));\n    }\n  }\n  const failed = findings.some((finding) => finding.status === \"fail\");\n  if (failed) return findings;\n  const clear = claimWarnings === 0 ? \"from any of the three layers\" : \"from layers 1 and 2 (the claims below need evidence)\";\n  return [passFinding(\"E8\", `No banned wording ${clear} on ${sampledPages(pages.length)}.`), ...findings];\n}\n\n/** Used by tests to confirm which patterns exist for each layer. */\nexport function bannedPatternIds(layer: 1 | 2 | 3): string[] {\n  return BANNED_PATTERNS.filter((pattern) => pattern.layer === layer).map((pattern) => pattern.id);\n}\n"]}

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

@@ -0,0 +1,43 @@
+import type { ShellPage } from "./page.js";
+import { type ShellAssetReader, type ShellFinding } from "./types.js";
+/**
+ * B1: lab budgets read from the built page HTML (spec 5.8): JavaScript, third-party requests, the hero image and the
+ * HTML itself, with no chat widget, pixel, heatmap or tag manager unless the project records the decision. Script and
+ * image sizes come from the project's build output, then the base URL; a size that can't be read is left out of the
+ * total and said so, never guessed.
+ */
+/** First-party JavaScript per page, gzip: a warning from here. Starting value, calibrated in the R1 canaries. */
+export declare const B1_FIRST_PARTY_JS_GZIP_WARN_BYTES: number;
+/** First-party JavaScript per page, gzip: the spec's starting budget; over it blocks. */
+export declare const B1_FIRST_PARTY_JS_GZIP_FAIL_BYTES: number;
+export declare const B1_HTML_MAX_BYTES: number;
+export declare const B1_HERO_IMAGE_MAX_BYTES: number;
+/** The viewport width the hero image is judged at. */
+export declare const B1_HERO_VIEWPORT_PX = 1440;
+type ThirdPartyKind = "chat" | "pixel" | "heatmap" | "tag-manager";
+interface Verdict {
+    kind: ThirdPartyKind | "other";
+    label: string;
+}
+/** What a third-party URL is, or null when the shared setup allows it. */
+export declare function judgeThirdParty(url: URL): Verdict | null;
+/**
+ * The origin standing in for the site when there is no base URL (build-output mode): relative asset URLs resolve to it,
+ * so they count as first-party and are read from the project's build output alone.
+ */
+export declare const BUILD_OUTPUT_ORIGIN = "https://build-output.invalid";
+/**
+ * The default reader: the project's build output for its own paths (`.next/static`, `public`, `out`), then the base
+ * URL when there is one. Never reads other hosts.
+ */
+export declare const readBuiltAsset: ShellAssetReader;
+export interface BudgetOptions {
+    baseUrl: string;
+    projectRoot: string;
+    recordedThirdParties?: readonly string[];
+    readAsset?: ShellAssetReader;
+}
+/** B1 over the sampled pages. */
+export declare function checkLabBudgets(pages: readonly ShellPage[], options: BudgetOptions): Promise<ShellFinding[]>;
+export {};
+//# sourceMappingURL=budgets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/shell/budgets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACqC,KAAK,gBAAgB,EAAE,KAAK,YAAY,EACnF,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AAEH,iHAAiH;AACjH,eAAO,MAAM,iCAAiC,QAAa,CAAC;AAC5D,yFAAyF;AACzF,eAAO,MAAM,iCAAiC,QAAa,CAAC;AAC5D,eAAO,MAAM,iBAAiB,QAAa,CAAC;AAC5C,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAClD,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,KAAK,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;AA6CnE,UAAU,OAAO;IACf,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,GAAG,IAAI,CAaxD;AAeD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAUlE;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,gBA+B5B,CAAC;AA4EF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,iCAAiC;AACjC,wBAAsB,eAAe,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAqFlH"}

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

@@ -0,0 +1,297 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve, sep } from "node:path";
+import { gzipSync } from "node:zlib";
+import { descendants, findAll, isWithin } from "./html.js";
+import { failFinding, passFinding, warningFinding, } from "./types.js";
+/**
+ * B1: lab budgets read from the built page HTML (spec 5.8): JavaScript, third-party requests, the hero image and the
+ * HTML itself, with no chat widget, pixel, heatmap or tag manager unless the project records the decision. Script and
+ * image sizes come from the project's build output, then the base URL; a size that can't be read is left out of the
+ * total and said so, never guessed.
+ */
+/** First-party JavaScript per page, gzip: a warning from here. Starting value, calibrated in the R1 canaries. */
+export const B1_FIRST_PARTY_JS_GZIP_WARN_BYTES = 180 * 1024;
+/** First-party JavaScript per page, gzip: the spec's starting budget; over it blocks. */
+export const B1_FIRST_PARTY_JS_GZIP_FAIL_BYTES = 250 * 1024;
+export const B1_HTML_MAX_BYTES = 500 * 1024;
+export const B1_HERO_IMAGE_MAX_BYTES = 200 * 1024;
+/** The viewport width the hero image is judged at. */
+export const B1_HERO_VIEWPORT_PX = 1440;
+const CATEGORIES = [
+    { kind: "chat", label: "a chat widget", hosts: [
+            "widget.intercom.io", "js.intercomcdn.com", "intercom.io", "tawk.to", "crisp.chat", "livechatinc.com", "tidio.co",
+            "driftt.com", "drift.com", "usemessages.com", "zdassets.com", "freshchat.com", "olark.com", "smartsuppchat.com",
+            "chatra.io", "jivosite.com", "manychat.com", "chatwoot.com",
+        ] },
+    { kind: "pixel", label: "an advertising pixel", hosts: [
+            "connect.facebook.net", "snap.licdn.com", "px.ads.linkedin.com", "static.ads-twitter.com", "analytics.twitter.com",
+            "analytics.tiktok.com", "s.pinimg.com", "bat.bing.com", "sc-static.net", "tr.snapchat.com", "adroll.com",
+            "criteo.net", "outbrain.com", "taboola.com",
+        ] },
+    { kind: "heatmap", label: "a heatmap or session recorder", hosts: [
+            "hotjar.com", "hotjar.io", "clarity.ms", "mouseflow.com", "crazyegg.com", "fullstory.com", "logrocket.com",
+            "lr-ingest.io", "luckyorange.com", "luckyorange.net", "smartlook.com", "inspectlet.com", "heapanalytics.com",
+        ] },
+    { kind: "tag-manager", label: "a tag manager", hosts: [
+            "tags.tiqcdn.com", "tiqcdn.com", "cdn.segment.com", "assets.adobedtm.com", "cdn.tealium.com",
+        ] },
+];
+/** Hosts the shared analytics, Ads, maps and form-protection setup uses (see the Content-Security-Policy in site-next). */
+const ALLOWED_HOSTS = [
+    "google-analytics.com", "analytics.google.com", "googleadservices.com", "doubleclick.net", "googlesyndication.com",
+    "maps.googleapis.com", "maps.gstatic.com", "gstatic.com", "challenges.cloudflare.com",
+];
+const INLINE_SIGNATURES = [
+    { kind: "pixel", label: "a Meta pixel", regex: /\bfbq\s*\(/ },
+    { kind: "tag-manager", label: "a tag manager", regex: /gtm\.start|googletagmanager\.com\/gtm\.js/ },
+    { kind: "heatmap", label: "a heatmap or session recorder", regex: /\bhj\s*\(\s*['"]|static\.hotjar\.com|clarity\.ms|\bclarity\s*\(/ },
+    { kind: "chat", label: "a chat widget", regex: /\bTawk_API\b|\$crisp\b|window\.Intercom|\bIntercom\s*\(|drift\.load|LiveChatWidget|tidioChatApi|\bzE\s*\(|\bfcWidget\b/ },
+];
+function hostMatches(host, domain) {
+    return host === domain || host.endsWith(`.${domain}`);
+}
+/** What a third-party URL is, or null when the shared setup allows it. */
+export function judgeThirdParty(url) {
+    const host = url.hostname.toLowerCase();
+    if (hostMatches(host, "googletagmanager.com")) {
+        return /^\/gtag\/js/.test(url.pathname) ? null : { kind: "tag-manager", label: "a tag manager" };
+    }
+    if (host === "www.google.com" || host === "google.com") {
+        return /^\/(?:maps|recaptcha)\//.test(url.pathname) ? null : { kind: "other", label: "a third-party request" };
+    }
+    for (const category of CATEGORIES) {
+        if (category.hosts.some((domain) => hostMatches(host, domain)))
+            return { kind: category.kind, label: category.label };
+    }
+    if (ALLOWED_HOSTS.some((domain) => hostMatches(host, domain)))
+        return null;
+    return { kind: "other", label: "a third-party request" };
+}
+function isRecorded(recorded, url, verdict) {
+    const host = url.hostname.toLowerCase();
+    return recorded.some((entry) => {
+        const value = entry.trim().toLowerCase();
+        return value !== "" && (value === verdict.kind || hostMatches(host, value));
+    });
+}
+function sameSite(host, baseHost) {
+    const strip = (value) => value.replace(/^www\./, "");
+    return strip(host.toLowerCase()) === strip(baseHost.toLowerCase());
+}
+/**
+ * The origin standing in for the site when there is no base URL (build-output mode): relative asset URLs resolve to it,
+ * so they count as first-party and are read from the project's build output alone.
+ */
+export const BUILD_OUTPUT_ORIGIN = "https://build-output.invalid";
+function parseBase(baseUrl) {
+    try {
+        return new URL(baseUrl);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The default reader: the project's build output for its own paths (`.next/static`, `public`, `out`), then the base
+ * URL when there is one. Never reads other hosts.
+ */
+export const readBuiltAsset = async (url, { projectRoot, baseUrl }) => {
+    const given = parseBase(baseUrl);
+    const base = given ?? new URL(BUILD_OUTPUT_ORIGIN);
+    if (!sameSite(url.hostname, base.hostname))
+        return undefined;
+    let pathname = url.pathname;
+    try {
+        pathname = decodeURIComponent(pathname);
+    }
+    catch {
+        // Keep the encoded path.
+    }
+    const root = resolve(projectRoot);
+    const candidates = pathname.startsWith("/_next/static/")
+        ? [join(root, ".next", pathname.slice("/_next/".length))]
+        : pathname.startsWith("/_next/") ? [] : [join(root, "public", pathname), join(root, "out", pathname)];
+    for (const candidate of candidates) {
+        const resolved = resolve(candidate);
+        if (resolved.startsWith(root + sep) && existsSync(resolved)) {
+            try {
+                return new Uint8Array(readFileSync(resolved));
+            }
+            catch {
+                // Fall through to the network.
+            }
+        }
+    }
+    if (!given || !/^https?:$/.test(url.protocol))
+        return undefined;
+    try {
+        const response = await fetch(url, { signal: AbortSignal.timeout(15_000) });
+        return response.ok ? new Uint8Array(await response.arrayBuffer()) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+function resolveUrl(value, page) {
+    if (!value || /^\s*(?:data|blob|about|javascript|mailto|tel):/i.test(value))
+        return null;
+    try {
+        return new URL(value.trim(), page);
+    }
+    catch {
+        return null;
+    }
+}
+/** The scripts, frames and stylesheets a page requests. */
+function pageResources(page, pageUrl) {
+    const resources = [];
+    for (const element of descendants(page.doc.root)) {
+        const { tag, attrs } = element;
+        if (tag === "script" && attrs.src) {
+            if (attrs.nomodule !== undefined)
+                continue;
+            const url = resolveUrl(attrs.src, pageUrl);
+            if (url)
+                resources.push({ url, kind: "script" });
+        }
+        else if (tag === "link") {
+            const rel = (attrs.rel ?? "").toLowerCase().split(/\s+/);
+            const wantsScript = rel.includes("modulepreload") || (rel.includes("preload") && attrs.as === "script");
+            const wantsOther = rel.includes("stylesheet") || (rel.includes("preload") && attrs.as !== "script" && attrs.as !== undefined && attrs.as !== "image");
+            if (wantsScript || wantsOther) {
+                const url = resolveUrl(attrs.href, pageUrl);
+                if (url)
+                    resources.push({ url, kind: wantsScript ? "script" : "other" });
+            }
+        }
+        else if (tag === "iframe" || tag === "embed" || tag === "object") {
+            const url = resolveUrl(attrs.src ?? attrs.data, pageUrl);
+            if (url)
+                resources.push({ url, kind: "other" });
+        }
+    }
+    return resources;
+}
+function inlineScripts(page) {
+    return findAll(page.doc.root, (element) => element.tag === "script" && !element.attrs.src && !/(?:json|importmap|speculationrules)/i.test(element.attrs.type ?? ""))
+        .map((script) => script.children.map((child) => (child.kind === "text" ? child.text : "")).join(""))
+        // The framework's streamed page data holds the page's words, not code that runs a widget.
+        .filter((text) => !text.includes("__next_f"));
+}
+function srcsetCandidates(srcset) {
+    return srcset.split(",").map((part) => part.trim().split(/\s+/)).filter((parts) => parts[0])
+        .map(([url, descriptor]) => ({ url: url, width: descriptor?.endsWith("w") ? Number.parseInt(descriptor, 10) : descriptor?.endsWith("x") ? Number.parseFloat(descriptor) * 1000 : 0 }));
+}
+/** The image the hero shows on a wide screen: the smallest candidate at least 1440 px wide, else the widest. */
+function heroImage(page) {
+    const hero = page.hero;
+    if (!hero)
+        return null;
+    const images = findAll(hero, (element) => element.tag === "img" && !page.headers.some((header) => isWithin(element, header)) && element.attrs["data-bl"] !== "logo");
+    if (images.length === 0)
+        return null;
+    const width = (image) => Number.parseInt(image.attrs.width ?? "0", 10) || 0;
+    const element = images.find((image) => image.attrs.fetchpriority === "high") ?? images.reduce((best, image) => (width(image) > width(best) ? image : best), images[0]);
+    const candidates = srcsetCandidates(element.attrs.srcset ?? "");
+    const wide = candidates.filter((candidate) => candidate.width >= B1_HERO_VIEWPORT_PX).sort((left, right) => left.width - right.width)[0]
+        ?? candidates.sort((left, right) => right.width - left.width)[0];
+    return { element, source: wide?.url ?? element.attrs.src };
+}
+function gzipBytes(bytes) {
+    return gzipSync(Buffer.from(bytes)).length;
+}
+function kilobytes(bytes) {
+    return `${Math.round(bytes / 1024)} KB`;
+}
+/** B1 over the sampled pages. */
+export async function checkLabBudgets(pages, options) {
+    const read = options.readAsset ?? readBuiltAsset;
+    const recorded = options.recordedThirdParties ?? [];
+    const cache = new Map();
+    const readCached = (url) => {
+        const key = url.href;
+        if (!cache.has(key))
+            cache.set(key, read(url, { projectRoot: options.projectRoot, baseUrl: options.baseUrl }).catch(() => undefined));
+        return cache.get(key);
+    };
+    const base = parseBase(options.baseUrl) ?? new URL(BUILD_OUTPUT_ORIGIN);
+    const failures = [];
+    const warnings = [];
+    const hostsSeen = new Set();
+    let largestJs = 0;
+    let jsPages = 0;
+    for (const page of pages) {
+        const pageUrl = new URL(page.path, base);
+        const htmlBytes = Buffer.byteLength(page.html);
+        if (htmlBytes > B1_HTML_MAX_BYTES) {
+            failures.push(failFinding("B1", page.path, `The page ${page.path} is ${kilobytes(htmlBytes)} of HTML, over the ${kilobytes(B1_HTML_MAX_BYTES)} budget.`));
+        }
+        const resources = pageResources(page, pageUrl);
+        const flagged = new Set();
+        for (const resource of resources) {
+            if (sameSite(resource.url.hostname, base.hostname))
+                continue;
+            hostsSeen.add(resource.url.hostname);
+            const verdict = judgeThirdParty(resource.url);
+            if (!verdict || isRecorded(recorded, resource.url, verdict))
+                continue;
+            const key = `${resource.url.hostname}\u0000${verdict.kind}`;
+            if (flagged.has(key))
+                continue;
+            flagged.add(key);
+            failures.push(failFinding("B1", page.path, verdict.kind === "other"
+                ? `The page ${page.path} requests ${resource.url.hostname}, a third party outside analytics, maps and the reviews feed, with no recorded decision.`
+                : `The page ${page.path} loads ${verdict.label} from ${resource.url.hostname} with no recorded decision.`));
+        }
+        for (const script of inlineScripts(page)) {
+            for (const signature of INLINE_SIGNATURES) {
+                const key = `inline\u0000${signature.kind}`;
+                if (flagged.has(key) || !signature.regex.test(script))
+                    continue;
+                if (recorded.some((entry) => entry.trim().toLowerCase() === signature.kind))
+                    continue;
+                flagged.add(key);
+                failures.push(failFinding("B1", page.path, `The page ${page.path} runs ${signature.label} from an inline script with no recorded decision.`));
+            }
+        }
+        const scripts = [...new Map(resources.filter((resource) => resource.kind === "script" && sameSite(resource.url.hostname, base.hostname)).map((resource) => [resource.url.href, resource.url])).values()];
+        if (scripts.length > 0) {
+            const sizes = await Promise.all(scripts.map(readCached));
+            const measured = sizes.filter((bytes) => bytes !== undefined);
+            const total = measured.reduce((sum, bytes) => sum + gzipBytes(bytes), 0);
+            if (measured.length > 0) {
+                jsPages += 1;
+                largestJs = Math.max(largestJs, total);
+                const unread = scripts.length - measured.length;
+                const note = unread > 0 ? ` (${unread} of ${scripts.length} script file${scripts.length === 1 ? "" : "s"} could not be read)` : "";
+                if (total > B1_FIRST_PARTY_JS_GZIP_FAIL_BYTES) {
+                    failures.push(failFinding("B1", page.path, `The page ${page.path} loads ${kilobytes(total)} of first-party JavaScript (gzip)${note}, over the ${kilobytes(B1_FIRST_PARTY_JS_GZIP_FAIL_BYTES)} budget.`));
+                }
+                else if (total > B1_FIRST_PARTY_JS_GZIP_WARN_BYTES) {
+                    warnings.push(warningFinding("B1", `Warning: the page ${page.path} loads ${kilobytes(total)} of first-party JavaScript (gzip)${note}, over the ${kilobytes(B1_FIRST_PARTY_JS_GZIP_WARN_BYTES)} warning threshold.`, page.path));
+                }
+            }
+        }
+        const hero = heroImage(page);
+        if (hero) {
+            const { element, source } = hero;
+            if (element.attrs.loading === "lazy" || element.attrs.fetchpriority === "low" || /\blazy(?:load|loaded)?\b/.test(element.attrs.class ?? "")) {
+                failures.push(failFinding("B1", page.path, `The hero image on ${page.path} is set to load lazily; the first-screen image must load straight away.`));
+            }
+            const url = resolveUrl(source, pageUrl);
+            if (url && sameSite(url.hostname, base.hostname)) {
+                const bytes = await readCached(url);
+                if (bytes && bytes.length > B1_HERO_IMAGE_MAX_BYTES) {
+                    failures.push(failFinding("B1", page.path, `The hero image on ${page.path} is ${kilobytes(bytes.length)}, over the ${kilobytes(B1_HERO_IMAGE_MAX_BYTES)} budget at ${B1_HERO_VIEWPORT_PX} px.`));
+                }
+            }
+        }
+    }
+    if (failures.length > 0)
+        return [...failures, ...warnings];
+    const jsNote = jsPages > 0 ? ` The heaviest page loads ${kilobytes(largestJs)} of first-party JavaScript (gzip).` : " Script sizes could not be read from the build output or the base URL, so the JavaScript budget was not measured.";
+    const hostNote = hostsSeen.size > 0 ? ` Third-party hosts seen: ${[...hostsSeen].sort().join(", ")}.` : " No third-party requests.";
+    const within = pages.length === 1 ? "The sampled page is" : `The ${pages.length} sampled pages are`;
+    return [passFinding("B1", `${within} within the HTML, hero image and third-party budgets.${jsNote}${hostNote}`), ...warnings];
+}
+//# sourceMappingURL=budgets.js.map