@brandlab-digital/conformance 3.7.0 → 3.9.0

package/dist/site-system/rules/design/d4-distinctness.js

@@ -0,0 +1,207 @@
+/**
+ * D4: same-trade distinctness on the look levers (Site System v2 §7.7).
+ *
+ * `src/data/strategy.ts` records the site's own look and every same-trade competitor's. The rule compares the site
+ * with each competitor lever by lever and fails when fewer than four of the seven differ from any one of them. The
+ * seven are the display font, the action-colour family, the hero variant, the header variant, the card style (radius,
+ * border and shadow tokens), the photo treatment (crop ratio, scrim and frame) and the home page's section order and
+ * signature sections. A shared display font counts as the same lever, an action hue within 20 degrees counts as the
+ * same, and a card style, photo treatment or home page layout is the same only when every part of it matches. The
+ * levers are the recorded values: this reads the record, it does not measure the rendered look.
+ *
+ * D4 blocks every new build and redesign from 3.9.0 and is advisory before that (`siteSystemCheckBlocks`).
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { LiteralReader, isFullyResolved, isLiteralObject } from "../enquiry/literal.js";
+/** Where the site records its strategy. */
+export const D4_STRATEGY_FILE = "src/data/strategy.ts";
+/** The recorded levers (spec §7.7), as site-core's `SITE_LOOK_LEVERS` lists them (a test keeps the two lists equal). */
+export const D4_LEVERS = [
+    "displayFont",
+    "actionHue",
+    "heroVariant",
+    "headerVariant",
+    "cardStyle",
+    "photoTreatment",
+    "homeSections",
+];
+/** An action hue this close to a competitor's, in degrees, counts as the same. */
+export const D4_SAME_HUE_DEGREES = 20;
+/** At least this many levers must differ from every competitor. */
+export const D4_MIN_DIFFERING = 4;
+/** The parts of the levers that record several values. All of them must match for the lever to be the same. */
+const CARD_STYLE_PARTS = ["radius", "border", "shadow"];
+const PHOTO_TREATMENT_PARTS = ["cropRatio", "scrim", "frame"];
+/** The first family of a font stack, without quotes, lowercased: `"Plus Jakarta Sans", sans-serif` is `plus jakarta sans`. */
+function fontFamily(value) {
+    return (value.split(",")[0] ?? "").replace(/["']/g, "").trim().toLowerCase().replace(/\s+/g, " ");
+}
+function words(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, " ");
+}
+/** Smallest angle between two hues, in degrees, on the colour wheel. */
+export function hueDistance(left, right) {
+    const gap = Math.abs(left - right) % 360;
+    return Math.min(gap, 360 - gap);
+}
+function textParts(value, parts) {
+    if (!isLiteralObject(value))
+        return null;
+    const found = parts.map((part) => value[part]);
+    return found.every((item) => typeof item === "string" && item.trim() !== "") ? found.map(words) : null;
+}
+function textList(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string" && item.trim() !== "") ? value.map(words) : null;
+}
+function homeSections(value) {
+    if (!isLiteralObject(value))
+        return null;
+    const order = textList(value["sectionOrder"]);
+    const signatures = textList(value["signatures"]);
+    return order && order.length > 0 && signatures ? { order, signatures: [...new Set(signatures)].sort() } : null;
+}
+/** The lever's value if it is recorded in the shape the lever needs, otherwise undefined. */
+function recordedLever(lever, value) {
+    switch (lever) {
+        case "actionHue":
+            return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+        case "cardStyle":
+            return textParts(value, CARD_STYLE_PARTS) ? value : undefined;
+        case "photoTreatment":
+            return textParts(value, PHOTO_TREATMENT_PARTS) ? value : undefined;
+        case "homeSections":
+            return homeSections(value) ? value : undefined;
+        default:
+            return typeof value === "string" && value.trim() !== "" ? value : undefined;
+    }
+}
+/** Whether one lever is the same in both looks. A lever recorded in the wrong shape is never the same. */
+export function sameLever(lever, left, right) {
+    switch (lever) {
+        case "actionHue":
+            return typeof left === "number" && typeof right === "number" && hueDistance(left, right) <= D4_SAME_HUE_DEGREES;
+        case "displayFont":
+            return typeof left === "string" && typeof right === "string" && fontFamily(left) === fontFamily(right);
+        case "cardStyle":
+        case "photoTreatment": {
+            const parts = lever === "cardStyle" ? CARD_STYLE_PARTS : PHOTO_TREATMENT_PARTS;
+            const a = textParts(left, parts);
+            const b = textParts(right, parts);
+            return a !== null && b !== null && a.every((part, index) => part === b[index]);
+        }
+        case "homeSections": {
+            const a = homeSections(left);
+            const b = homeSections(right);
+            return (a !== null &&
+                b !== null &&
+                a.order.length === b.order.length &&
+                a.order.every((id, index) => id === b.order[index]) &&
+                a.signatures.length === b.signatures.length &&
+                a.signatures.every((name, index) => name === b.signatures[index]));
+        }
+        default:
+            return typeof left === "string" && typeof right === "string" && words(left) === words(right);
+    }
+}
+export function compareLooks(own, rival) {
+    const result = { differing: [], same: [], unrecorded: [] };
+    for (const lever of D4_LEVERS) {
+        const left = recordedLever(lever, own[lever]);
+        const right = recordedLever(lever, rival[lever]);
+        if (left === undefined || right === undefined)
+            result.unrecorded.push(lever);
+        else if (sameLever(lever, left, right))
+            result.same.push(lever);
+        else
+            result.differing.push(lever);
+    }
+    return result;
+}
+function readLook(value) {
+    if (!isLiteralObject(value))
+        return null;
+    const look = {};
+    for (const lever of D4_LEVERS) {
+        const recorded = recordedLever(lever, value[lever]);
+        if (recorded !== undefined)
+            look[lever] = recorded;
+    }
+    return look;
+}
+/** Reads the strategy record without running the site. Returns a string when it cannot be read as plain data. */
+export function readStrategy(projectRoot) {
+    const file = join(projectRoot, D4_STRATEGY_FILE);
+    if (!existsSync(file))
+        return null;
+    const reader = new LiteralReader(readFileSync(file, "utf8"), D4_STRATEGY_FILE);
+    const argument = reader.callArguments("defineSiteStrategy")[0] ?? reader.constant("strategy");
+    if (!argument)
+        return `${D4_STRATEGY_FILE} does not define the strategy with defineSiteStrategy({ … }).`;
+    const value = reader.evaluate(argument);
+    if (!isLiteralObject(value) || !isFullyResolved(value)) {
+        return `${D4_STRATEGY_FILE} is not plain data, so the look levers cannot be read; write the strategy as a literal.`;
+    }
+    const look = readLook(value["look"]);
+    // defineSiteStrategy accepts a record without these, but D4 cannot pass a new build or redesign without them.
+    if (!look)
+        return `${D4_STRATEGY_FILE} has no "look" for the site; a new build or redesign must record it.`;
+    const rawCompetitors = value["competitors"];
+    if (!Array.isArray(rawCompetitors))
+        return `${D4_STRATEGY_FILE} has no "competitors" list; a new build or redesign must record it.`;
+    const competitors = [];
+    for (const [index, item] of rawCompetitors.entries()) {
+        const competitorLook = isLiteralObject(item) ? readLook(item["look"]) : null;
+        if (!isLiteralObject(item) || !competitorLook || typeof item["domain"] !== "string") {
+            return `${D4_STRATEGY_FILE} competitor ${index + 1} needs a domain and a look.`;
+        }
+        competitors.push({ name: typeof item["name"] === "string" ? item["name"] : item["domain"], domain: item["domain"], look: competitorLook });
+    }
+    return { look, competitors };
+}
+function list(levers) {
+    return levers.join(", ");
+}
+export function checkD4(projectRoot) {
+    const strategy = readStrategy(projectRoot);
+    if (strategy === null) {
+        return [{ checkId: "D4", status: "fail", target: D4_STRATEGY_FILE, message: `The site has no ${D4_STRATEGY_FILE}, so its look cannot be compared with its competitors'.` }];
+    }
+    if (typeof strategy === "string")
+        return [{ checkId: "D4", status: "fail", target: D4_STRATEGY_FILE, message: strategy }];
+    if (strategy.competitors.length === 0) {
+        return [{ checkId: "D4", status: "not-applicable", message: "The strategy lists no competitors, so there is no look to compare against." }];
+    }
+    const ownMissing = D4_LEVERS.filter((lever) => strategy.look[lever] === undefined);
+    if (ownMissing.length > 0) {
+        return [{ checkId: "D4", status: "fail", target: D4_STRATEGY_FILE, message: `The site's own look does not record ${list(ownMissing)}, so it cannot be compared.` }];
+    }
+    const failures = [];
+    let fewest = { domain: "", count: Number.POSITIVE_INFINITY };
+    for (const competitor of strategy.competitors) {
+        const comparison = compareLooks(strategy.look, competitor.look);
+        if (comparison.unrecorded.length > 0) {
+            failures.push({ checkId: "D4", status: "fail", target: competitor.domain, message: `The look recorded for ${competitor.domain} is missing ${list(comparison.unrecorded)}, so it cannot be compared.` });
+            continue;
+        }
+        if (comparison.differing.length < fewest.count)
+            fewest = { domain: competitor.domain, count: comparison.differing.length };
+        if (comparison.differing.length < D4_MIN_DIFFERING) {
+            failures.push({
+                checkId: "D4",
+                status: "fail",
+                target: competitor.domain,
+                message: `The look is too close to ${competitor.domain}: ${comparison.differing.length} of ${D4_LEVERS.length} levers differ and at least ${D4_MIN_DIFFERING} must (same: ${list(comparison.same)}).`,
+            });
+        }
+    }
+    if (failures.length > 0)
+        return failures;
+    const count = strategy.competitors.length;
+    return [{
+            checkId: "D4",
+            status: "pass",
+            message: `The look differs from ${count === 1 ? "the listed competitor" : `all ${count} listed competitors`} on at least ${D4_MIN_DIFFERING} of ${D4_LEVERS.length} levers (closest: ${fewest.domain} with ${fewest.count}).`,
+        }];
+}
+//# sourceMappingURL=d4-distinctness.js.map

package/dist/site-system/rules/design/d4-distinctness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d4-distinctness.js","sourceRoot":"","sources":["../../../../src/site-system/rules/design/d4-distinctness.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * D4: same-trade distinctness on the look levers (Site System v2 §7.7).\n *\n * `src/data/strategy.ts` records the site's own look and every same-trade competitor's. The rule compares the site\n * with each competitor lever by lever and fails when fewer than four of the seven differ from any one of them. The\n * seven are the display font, the action-colour family, the hero variant, the header variant, the card style (radius,\n * border and shadow tokens), the photo treatment (crop ratio, scrim and frame) and the home page's section order and\n * signature sections. A shared display font counts as the same lever, an action hue within 20 degrees counts as the\n * same, and a card style, photo treatment or home page layout is the same only when every part of it matches. The\n * levers are the recorded values: this reads the record, it does not measure the rendered look.\n *\n * D4 blocks every new build and redesign from 3.9.0 and is advisory before that (`siteSystemCheckBlocks`).\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { LiteralReader, isFullyResolved, isLiteralObject, type Literal } from \"../enquiry/literal.js\";\n\n/** Where the site records its strategy. */\nexport const D4_STRATEGY_FILE = \"src/data/strategy.ts\";\n\n/** The recorded levers (spec §7.7), as site-core's `SITE_LOOK_LEVERS` lists them (a test keeps the two lists equal). */\nexport const D4_LEVERS = [\n  \"displayFont\",\n  \"actionHue\",\n  \"heroVariant\",\n  \"headerVariant\",\n  \"cardStyle\",\n  \"photoTreatment\",\n  \"homeSections\",\n] as const;\nexport type D4Lever = (typeof D4_LEVERS)[number];\n\n/** An action hue this close to a competitor's, in degrees, counts as the same. */\nexport const D4_SAME_HUE_DEGREES = 20;\n/** At least this many levers must differ from every competitor. */\nexport const D4_MIN_DIFFERING = 4;\n\n/** The parts of the levers that record several values. All of them must match for the lever to be the same. */\nconst CARD_STYLE_PARTS = [\"radius\", \"border\", \"shadow\"] as const;\nconst PHOTO_TREATMENT_PARTS = [\"cropRatio\", \"scrim\", \"frame\"] as const;\n\nexport type RecordedLook = Partial<Record<D4Lever, Literal>>;\n\nexport interface RecordedCompetitor {\n  name: string;\n  domain: string;\n  look: RecordedLook;\n}\n\n/** The first family of a font stack, without quotes, lowercased: `\"Plus Jakarta Sans\", sans-serif` is `plus jakarta sans`. */\nfunction fontFamily(value: string): string {\n  return (value.split(\",\")[0] ?? \"\").replace(/[\"']/g, \"\").trim().toLowerCase().replace(/\\s+/g, \" \");\n}\n\nfunction words(value: string): string {\n  return value.trim().toLowerCase().replace(/\\s+/g, \" \");\n}\n\n/** Smallest angle between two hues, in degrees, on the colour wheel. */\nexport function hueDistance(left: number, right: number): number {\n  const gap = Math.abs(left - right) % 360;\n  return Math.min(gap, 360 - gap);\n}\n\nfunction textParts(value: Literal | undefined, parts: readonly string[]): string[] | null {\n  if (!isLiteralObject(value)) return null;\n  const found = parts.map((part) => value[part]);\n  return found.every((item): item is string => typeof item === \"string\" && item.trim() !== \"\") ? found.map(words) : null;\n}\n\nfunction textList(value: Literal | undefined): string[] | null {\n  return Array.isArray(value) && value.every((item): item is string => typeof item === \"string\" && item.trim() !== \"\") ? value.map(words) : null;\n}\n\nfunction homeSections(value: Literal | undefined): { order: string[]; signatures: string[] } | null {\n  if (!isLiteralObject(value)) return null;\n  const order = textList(value[\"sectionOrder\"]);\n  const signatures = textList(value[\"signatures\"]);\n  return order && order.length > 0 && signatures ? { order, signatures: [...new Set(signatures)].sort() } : null;\n}\n\n/** The lever's value if it is recorded in the shape the lever needs, otherwise undefined. */\nfunction recordedLever(lever: D4Lever, value: Literal | undefined): Literal | undefined {\n  switch (lever) {\n    case \"actionHue\":\n      return typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n    case \"cardStyle\":\n      return textParts(value, CARD_STYLE_PARTS) ? value : undefined;\n    case \"photoTreatment\":\n      return textParts(value, PHOTO_TREATMENT_PARTS) ? value : undefined;\n    case \"homeSections\":\n      return homeSections(value) ? value : undefined;\n    default:\n      return typeof value === \"string\" && value.trim() !== \"\" ? value : undefined;\n  }\n}\n\n/** Whether one lever is the same in both looks. A lever recorded in the wrong shape is never the same. */\nexport function sameLever(lever: D4Lever, left: Literal, right: Literal): boolean {\n  switch (lever) {\n    case \"actionHue\":\n      return typeof left === \"number\" && typeof right === \"number\" && hueDistance(left, right) <= D4_SAME_HUE_DEGREES;\n    case \"displayFont\":\n      return typeof left === \"string\" && typeof right === \"string\" && fontFamily(left) === fontFamily(right);\n    case \"cardStyle\":\n    case \"photoTreatment\": {\n      const parts = lever === \"cardStyle\" ? CARD_STYLE_PARTS : PHOTO_TREATMENT_PARTS;\n      const a = textParts(left, parts);\n      const b = textParts(right, parts);\n      return a !== null && b !== null && a.every((part, index) => part === b[index]);\n    }\n    case \"homeSections\": {\n      const a = homeSections(left);\n      const b = homeSections(right);\n      return (\n        a !== null &&\n        b !== null &&\n        a.order.length === b.order.length &&\n        a.order.every((id, index) => id === b.order[index]) &&\n        a.signatures.length === b.signatures.length &&\n        a.signatures.every((name, index) => name === b.signatures[index])\n      );\n    }\n    default:\n      return typeof left === \"string\" && typeof right === \"string\" && words(left) === words(right);\n  }\n}\n\nexport interface LookComparison {\n  differing: D4Lever[];\n  same: D4Lever[];\n  /** Levers that are not recorded on one side; they can be neither the same nor different. */\n  unrecorded: D4Lever[];\n}\n\nexport function compareLooks(own: RecordedLook, rival: RecordedLook): LookComparison {\n  const result: LookComparison = { differing: [], same: [], unrecorded: [] };\n  for (const lever of D4_LEVERS) {\n    const left = recordedLever(lever, own[lever]);\n    const right = recordedLever(lever, rival[lever]);\n    if (left === undefined || right === undefined) result.unrecorded.push(lever);\n    else if (sameLever(lever, left, right)) result.same.push(lever);\n    else result.differing.push(lever);\n  }\n  return result;\n}\n\nexport interface RecordedStrategy {\n  look: RecordedLook;\n  competitors: RecordedCompetitor[];\n}\n\nfunction readLook(value: Literal | undefined): RecordedLook | null {\n  if (!isLiteralObject(value)) return null;\n  const look: RecordedLook = {};\n  for (const lever of D4_LEVERS) {\n    const recorded = recordedLever(lever, value[lever]);\n    if (recorded !== undefined) look[lever] = recorded;\n  }\n  return look;\n}\n\n/** Reads the strategy record without running the site. Returns a string when it cannot be read as plain data. */\nexport function readStrategy(projectRoot: string): RecordedStrategy | string | null {\n  const file = join(projectRoot, D4_STRATEGY_FILE);\n  if (!existsSync(file)) return null;\n  const reader = new LiteralReader(readFileSync(file, \"utf8\"), D4_STRATEGY_FILE);\n  const argument = reader.callArguments(\"defineSiteStrategy\")[0] ?? reader.constant(\"strategy\");\n  if (!argument) return `${D4_STRATEGY_FILE} does not define the strategy with defineSiteStrategy({ … }).`;\n  const value = reader.evaluate(argument);\n  if (!isLiteralObject(value) || !isFullyResolved(value)) {\n    return `${D4_STRATEGY_FILE} is not plain data, so the look levers cannot be read; write the strategy as a literal.`;\n  }\n  const look = readLook(value[\"look\"]);\n  // defineSiteStrategy accepts a record without these, but D4 cannot pass a new build or redesign without them.\n  if (!look) return `${D4_STRATEGY_FILE} has no \"look\" for the site; a new build or redesign must record it.`;\n  const rawCompetitors = value[\"competitors\"];\n  if (!Array.isArray(rawCompetitors)) return `${D4_STRATEGY_FILE} has no \"competitors\" list; a new build or redesign must record it.`;\n  const competitors: RecordedCompetitor[] = [];\n  for (const [index, item] of rawCompetitors.entries()) {\n    const competitorLook = isLiteralObject(item) ? readLook(item[\"look\"]) : null;\n    if (!isLiteralObject(item) || !competitorLook || typeof item[\"domain\"] !== \"string\") {\n      return `${D4_STRATEGY_FILE} competitor ${index + 1} needs a domain and a look.`;\n    }\n    competitors.push({ name: typeof item[\"name\"] === \"string\" ? item[\"name\"] : item[\"domain\"], domain: item[\"domain\"], look: competitorLook });\n  }\n  return { look, competitors };\n}\n\nfunction list(levers: readonly string[]): string {\n  return levers.join(\", \");\n}\n\nexport function checkD4(projectRoot: string): SiteSystemFinding[] {\n  const strategy = readStrategy(projectRoot);\n  if (strategy === null) {\n    return [{ checkId: \"D4\", status: \"fail\", target: D4_STRATEGY_FILE, message: `The site has no ${D4_STRATEGY_FILE}, so its look cannot be compared with its competitors'.` }];\n  }\n  if (typeof strategy === \"string\") return [{ checkId: \"D4\", status: \"fail\", target: D4_STRATEGY_FILE, message: strategy }];\n  if (strategy.competitors.length === 0) {\n    return [{ checkId: \"D4\", status: \"not-applicable\", message: \"The strategy lists no competitors, so there is no look to compare against.\" }];\n  }\n\n  const ownMissing = D4_LEVERS.filter((lever) => strategy.look[lever] === undefined);\n  if (ownMissing.length > 0) {\n    return [{ checkId: \"D4\", status: \"fail\", target: D4_STRATEGY_FILE, message: `The site's own look does not record ${list(ownMissing)}, so it cannot be compared.` }];\n  }\n\n  const failures: SiteSystemFinding[] = [];\n  let fewest = { domain: \"\", count: Number.POSITIVE_INFINITY };\n  for (const competitor of strategy.competitors) {\n    const comparison = compareLooks(strategy.look, competitor.look);\n    if (comparison.unrecorded.length > 0) {\n      failures.push({ checkId: \"D4\", status: \"fail\", target: competitor.domain, message: `The look recorded for ${competitor.domain} is missing ${list(comparison.unrecorded)}, so it cannot be compared.` });\n      continue;\n    }\n    if (comparison.differing.length < fewest.count) fewest = { domain: competitor.domain, count: comparison.differing.length };\n    if (comparison.differing.length < D4_MIN_DIFFERING) {\n      failures.push({\n        checkId: \"D4\",\n        status: \"fail\",\n        target: competitor.domain,\n        message: `The look is too close to ${competitor.domain}: ${comparison.differing.length} of ${D4_LEVERS.length} levers differ and at least ${D4_MIN_DIFFERING} must (same: ${list(comparison.same)}).`,\n      });\n    }\n  }\n  if (failures.length > 0) return failures;\n  const count = strategy.competitors.length;\n  return [{\n    checkId: \"D4\",\n    status: \"pass\",\n    message: `The look differs from ${count === 1 ? \"the listed competitor\" : `all ${count} listed competitors`} on at least ${D4_MIN_DIFFERING} of ${D4_LEVERS.length} levers (closest: ${fewest.domain} with ${fewest.count}).`,\n  }];\n}\n"]}

package/dist/site-system/rules/design/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The design rules (release 3.8.0): D4, same-trade distinctness. It reads the site's recorded strategy, so it needs
+ * the project root and ignores the sampled pages. The runner has the signature the ready gate registers.
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+export { D4_LEVERS, D4_MIN_DIFFERING, D4_SAME_HUE_DEGREES, D4_STRATEGY_FILE, checkD4, compareLooks, hueDistance, readStrategy, sameLever, } from "./d4-distinctness.js";
+export interface DesignRuleInput {
+    readonly baseUrl: string;
+    readonly pages: readonly {
+        readonly path: string;
+        readonly html: string;
+    }[];
+    readonly projectRoot: string;
+}
+/** Runs D4 against the strategy record at `projectRoot`. */
+export declare function runDesignRules(input: DesignRuleInput): Promise<readonly SiteSystemFinding[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/site-system/rules/design/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/design/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,4DAA4D;AAC5D,wBAAsB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAElG"}

package/dist/site-system/rules/design/index.js

@@ -0,0 +1,7 @@
+import { checkD4 } from "./d4-distinctness.js";
+export { D4_LEVERS, D4_MIN_DIFFERING, D4_SAME_HUE_DEGREES, D4_STRATEGY_FILE, checkD4, compareLooks, hueDistance, readStrategy, sameLever, } from "./d4-distinctness.js";
+/** Runs D4 against the strategy record at `projectRoot`. */
+export async function runDesignRules(input) {
+    return checkD4(input.projectRoot);
+}
+//# sourceMappingURL=index.js.map

package/dist/site-system/rules/design/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/site-system/rules/design/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,GACV,MAAM,sBAAsB,CAAC;AAQ9B,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAsB;IACzD,OAAO,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC","sourcesContent":["/**\n * The design rules (release 3.8.0): D4, same-trade distinctness. It reads the site's recorded strategy, so it needs\n * the project root and ignores the sampled pages. The runner has the signature the ready gate registers.\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { checkD4 } from \"./d4-distinctness.js\";\n\nexport {\n  D4_LEVERS,\n  D4_MIN_DIFFERING,\n  D4_SAME_HUE_DEGREES,\n  D4_STRATEGY_FILE,\n  checkD4,\n  compareLooks,\n  hueDistance,\n  readStrategy,\n  sameLever,\n} from \"./d4-distinctness.js\";\n\nexport interface DesignRuleInput {\n  readonly baseUrl: string;\n  readonly pages: readonly { readonly path: string; readonly html: string }[];\n  readonly projectRoot: string;\n}\n\n/** Runs D4 against the strategy record at `projectRoot`. */\nexport async function runDesignRules(input: DesignRuleInput): Promise<readonly SiteSystemFinding[]> {\n  return checkD4(input.projectRoot);\n}\n"]}

package/dist/site-system/rules/enquiry/c2-quote-form.d.ts

@@ -0,0 +1,31 @@
+/**
+ * C2: the quote form's layout and labels (Site System v2 §3.1 F8, §9.3).
+ *
+ * One five-field form: name, suburb, phone, email, "How can we help?", then photos. Phone and email are both
+ * required. There is no "(required)" text, no job-type select, no helper or reassurance line, and exactly one
+ * consent line (the line that links the privacy policy). Every enquiry already carries its page path, so there is nothing to choose about the job.
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "./common.js";
+import { type HtmlElement } from "./html.js";
+/** The fields of the form, in the order they appear. */
+export declare const C2_FIELD_ORDER: readonly ["name", "suburb", "phone", "email", "message", "photos"];
+export type C2Field = (typeof C2_FIELD_ORDER)[number];
+/** The message field's label. The trade-specific prompt goes in the placeholder, never the label. */
+export declare const C2_MESSAGE_LABEL = "How can we help?";
+/** Helper and reassurance lines the spec names. They are written here as examples; the patterns below match them. */
+export declare const C2_HELPER_LINE_EXAMPLES: readonly ["We only use your details to reply", "All fields needed; photos are optional"];
+/** Wording that explains the form or reassures the visitor. None of it belongs inside the quote form. */
+export declare const C2_HELPER_LINE_PATTERNS: readonly RegExp[];
+/** Marks that tell the visitor which fields are required or optional. Required fields use the `required` attribute. */
+export declare const C2_REQUIRED_MARKER_PATTERNS: readonly RegExp[];
+/**
+ * The consent line is the one line that links the site's own privacy policy. A notice that links somewhere else (a
+ * spam-protection widget's privacy link, for example) is not a second consent line.
+ */
+export declare const C2_CONSENT_LINK: RegExp;
+export declare function isQuoteForm(form: HtmlElement): boolean;
+/** Every problem with one quote form, as short fragments that complete "The quote form on /x …". */
+export declare function quoteFormProblems(form: HtmlElement, baseUrl?: string): string[];
+export declare function checkC2(pages: readonly ParsedPage[], baseUrl?: string): SiteSystemFinding[];
+//# sourceMappingURL=c2-quote-form.d.ts.map

package/dist/site-system/rules/enquiry/c2-quote-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"c2-quote-form.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/enquiry/c2-quote-form.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAyC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAwF,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnI,wDAAwD;AACxD,eAAO,MAAM,cAAc,oEAAqE,CAAC;AACjG,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,qGAAqG;AACrG,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,qHAAqH;AACrH,eAAO,MAAM,uBAAuB,0FAG1B,CAAC;AAEX,yGAAyG;AACzG,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAYpD,CAAC;AAEF,uHAAuH;AACvH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAMxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAa,CAAC;AAqD1C,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAGtD;AAWD,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,SAAK,GAAG,MAAM,EAAE,CAgE3E;AA2BD,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,SAAK,GAAG,iBAAiB,EAAE,CAiBvF"}

package/dist/site-system/rules/enquiry/c2-quote-form.js

@@ -0,0 +1,211 @@
+import { fail, notApplicable, plural, resultOf } from "./common.js";
+import { accessibleLabel, attr, descendants, isHiddenFromPeople, normaliseText, readableLines } from "./html.js";
+/** The fields of the form, in the order they appear. */
+export const C2_FIELD_ORDER = ["name", "suburb", "phone", "email", "message", "photos"];
+/** The message field's label. The trade-specific prompt goes in the placeholder, never the label. */
+export const C2_MESSAGE_LABEL = "How can we help?";
+/** Helper and reassurance lines the spec names. They are written here as examples; the patterns below match them. */
+export const C2_HELPER_LINE_EXAMPLES = [
+    "We only use your details to reply",
+    "All fields needed; photos are optional",
+];
+/** Wording that explains the form or reassures the visitor. None of it belongs inside the quote form. */
+export const C2_HELPER_LINE_PATTERNS = [
+    /\bwe\s+(?:only|will\s+only)\s+use\s+(?:your|the)\s+(?:details|information|info)\b/i,
+    /\ball\s+(?:the\s+)?fields\s+(?:are\s+)?(?:needed|required|mandatory)\b/i,
+    /\bphotos?\s+(?:are|is)\s+optional\b/i,
+    /\bwe(?:'|’)ll\s+never\s+(?:share|sell|spam)\b/i,
+    /\bwe\s+(?:will\s+)?never\s+(?:share|sell|spam)\b/i,
+    /\bno\s+(?:spam|obligation|pressure|hidden\s+fees)\b/i,
+    /\byour\s+(?:details|information|privacy)\s+(?:is|are)\s+(?:safe|secure|private|protected)\b/i,
+    /\btakes?\s+(?:less\s+than|under|only|just)\s+(?:a|an|\d+)\s+(?:minute|second|min)/i,
+    /\bfill\s+(?:in|out)\s+(?:the|this)\s+(?:form|short\s+form)\b/i,
+    /\bwe(?:'|’)ll\s+(?:get\s+back\s+to\s+you|reply|respond|be\s+in\s+touch)\b/i,
+    /\b(?:free|quick|easy)[,\s]+(?:no[- ]obligation|no[- ]hassle)\b/i,
+];
+/** Marks that tell the visitor which fields are required or optional. Required fields use the `required` attribute. */
+export const C2_REQUIRED_MARKER_PATTERNS = [
+    /\(\s*required\s*\)/i,
+    /\(\s*optional\s*\)/i,
+    /\brequired\s+fields?\b/i,
+    /\*\s*required\b/i,
+    /\brequired\s*\*/i,
+];
+/**
+ * The consent line is the one line that links the site's own privacy policy. A notice that links somewhere else (a
+ * spam-protection widget's privacy link, for example) is not a second consent line.
+ */
+export const C2_CONSENT_LINK = /privacy/i;
+const IGNORED_INPUT_TYPES = new Set(["hidden", "submit", "button", "reset", "image", "checkbox"]);
+function token(value) {
+    return (value ?? "").toLowerCase();
+}
+/** What a control is, judged from its visible label when its name and attributes do not say. */
+function classifyByLabel(label) {
+    const text = label.toLowerCase().replace(/[^a-z\s]/g, " ").replace(/\s+/g, " ").trim();
+    if (/\b(?:suburb|locality|postcode|post code|location|area|town|city)\b/.test(text))
+        return "suburb";
+    if (/\b(?:phone|mobile|telephone)\b/.test(text))
+        return "phone";
+    if (/\be ?mail\b/.test(text))
+        return "email";
+    if (/^(?:your |full |first |last )?name\b/.test(text))
+        return "name";
+    return null;
+}
+function classify(control) {
+    const type = token(attr(control, "type"));
+    const autocomplete = token(attr(control, "autocomplete"));
+    const identity = `${token(attr(control, "name"))} ${token(attr(control, "id"))}`;
+    if (control.tag === "select")
+        return "select";
+    if (control.tag === "textarea")
+        return "message";
+    if (type === "file")
+        return "photos";
+    if (type === "radio")
+        return "choice";
+    if (type === "tel" || /\btel\b/.test(autocomplete) || /phone|mobile|\btel\b/.test(identity))
+        return "phone";
+    if (type === "email" || /\bemail\b/.test(autocomplete) || /e-?mail/.test(identity))
+        return "email";
+    if (/address-level2|postal-code/.test(autocomplete) || /suburb|locality|postcode|location|area|town|city/.test(identity))
+        return "suburb";
+    if (/^(?:name|given-name|family-name)$/.test(autocomplete) || /(?:^|[\s_-])(?:full|first|last|your)?[_-]?name\b/.test(identity))
+        return "name";
+    return "other";
+}
+/** The controls a visitor sees and fills in, with what each is. A control the attributes do not identify is judged by its label. */
+function visibleControls(form) {
+    return descendants(form)
+        .filter((element) => ["input", "textarea", "select"].includes(element.tag))
+        .filter((element) => !IGNORED_INPUT_TYPES.has(token(attr(element, "type"))))
+        // The honeypot ("website" in the shared contact runtime) is out of the tab order and hidden from people.
+        .filter((element) => attr(element, "name") !== "website" && attr(element, "tabindex") !== "-1" && !isHiddenFromPeople(element))
+        .map((element) => {
+        const kind = classify(element);
+        if (kind !== "other")
+            return { element, kind };
+        const label = accessibleLabel(element, form) || attr(element, "placeholder") || "";
+        return { element, kind: classifyByLabel(label) ?? "other" };
+    });
+}
+export function isQuoteForm(form) {
+    if (attr(form, "data-bl") === "quote-form")
+        return true;
+    return visibleControls(form).some((control) => control.kind === "phone");
+}
+function isRequired(control) {
+    return attr(control, "required") !== undefined || attr(control, "aria-required") === "true";
+}
+function sameLabel(actual, expected) {
+    const simplify = (value) => normaliseText(value).replace(/[?.!:’']/g, "").toLowerCase();
+    return simplify(actual) === simplify(expected);
+}
+/** Every problem with one quote form, as short fragments that complete "The quote form on /x …". */
+export function quoteFormProblems(form, baseUrl = "") {
+    const problems = [];
+    const controls = visibleControls(form);
+    for (const field of C2_FIELD_ORDER) {
+        if (!controls.some((control) => control.kind === field))
+            problems.push(`has no ${field} field`);
+    }
+    const seen = C2_FIELD_ORDER.map((field) => controls.findIndex((control) => control.kind === field));
+    const present = seen.filter((position) => position !== -1);
+    if (present.some((position, index) => index > 0 && position < present[index - 1])) {
+        problems.push(`lists its fields out of order; they run ${C2_FIELD_ORDER.join(", ")}`);
+    }
+    for (const control of controls) {
+        if (control.kind === "select") {
+            problems.push(`has a select (${attr(control.element, "name") ?? attr(control.element, "id") ?? "unnamed"}); the form has no job-type dropdown`);
+        }
+        else if (control.kind === "choice") {
+            problems.push(`asks the visitor to choose between options (${attr(control.element, "name") ?? "unnamed"}); the form has no job-type choice`);
+        }
+        else if (control.kind === "other") {
+            problems.push(`has a field beyond the five (${attr(control.element, "name") ?? attr(control.element, "id") ?? attr(control.element, "type") ?? "unnamed"})`);
+        }
+    }
+    for (const field of ["phone", "email"]) {
+        const control = controls.find((candidate) => candidate.kind === field);
+        if (control && !isRequired(control.element))
+            problems.push(`does not require the ${field} field`);
+    }
+    const message = controls.find((control) => control.kind === "message");
+    if (message) {
+        const label = accessibleLabel(message.element, form);
+        if (!sameLabel(label, C2_MESSAGE_LABEL)) {
+            problems.push(`labels the message field "${label || "(no label)"}" instead of "${C2_MESSAGE_LABEL}"`);
+        }
+    }
+    const readable = readableLines(form);
+    const lines = readable.map((line) => line.text);
+    const placeholders = descendants(form).map((element) => attr(element, "placeholder")).filter((value) => Boolean(value));
+    const wording = [...lines, ...placeholders];
+    for (const pattern of C2_REQUIRED_MARKER_PATTERNS) {
+        const line = wording.find((candidate) => pattern.test(candidate));
+        if (line) {
+            problems.push(`marks fields as required or optional in its wording ("${shorten(line)}")`);
+            break;
+        }
+    }
+    const helper = lines.find((line) => C2_HELPER_LINE_PATTERNS.some((pattern) => pattern.test(line)));
+    if (helper)
+        problems.push(`carries a helper or reassurance line ("${shorten(helper)}")`);
+    const siteHost = hostOf(baseUrl);
+    const consentLines = readable.filter((line) => line.hrefs.some((href) => linksPrivacyPolicy(href, siteHost)));
+    if (consentLines.length === 0)
+        problems.push("has no consent line linking the privacy policy");
+    else if (consentLines.length > 1)
+        problems.push(`has ${consentLines.length} lines linking the privacy policy instead of one consent line`);
+    const hasSubmit = descendants(form).some((element) => (element.tag === "button" && ["submit", ""].includes(token(attr(element, "type")))) ||
+        (element.tag === "input" && token(attr(element, "type")) === "submit"));
+    if (!hasSubmit)
+        problems.push("has no submit button");
+    return problems;
+}
+function hostOf(baseUrl) {
+    try {
+        return new URL(baseUrl).hostname.replace(/^www\./, "");
+    }
+    catch {
+        return "";
+    }
+}
+/** Whether a link goes to the site's own privacy policy: a relative link, or one on the site's host, with "privacy" in the path. */
+function linksPrivacyPolicy(href, siteHost) {
+    let url;
+    try {
+        url = new URL(href, "https://site.invalid");
+    }
+    catch {
+        return false;
+    }
+    const relative = !/^[a-z][a-z0-9+.-]*:/i.test(href) && !href.startsWith("//");
+    const sameSite = relative || (siteHost !== "" && url.hostname.replace(/^www\./, "") === siteHost);
+    return sameSite && C2_CONSENT_LINK.test(url.pathname);
+}
+function shorten(line) {
+    return line.length > 70 ? `${line.slice(0, 67)}...` : line;
+}
+export function checkC2(pages, baseUrl = "") {
+    const failures = [];
+    let forms = 0;
+    let pagesWithForms = 0;
+    for (const page of pages) {
+        const pageForms = descendants(page.root).filter((element) => element.tag === "form" && isQuoteForm(element));
+        if (pageForms.length > 0)
+            pagesWithForms += 1;
+        pageForms.forEach((form, index) => {
+            forms += 1;
+            const which = pageForms.length > 1 ? `quote form ${index + 1}` : "quote form";
+            for (const problem of quoteFormProblems(form, baseUrl)) {
+                failures.push(fail("C2", page.path, `The ${which} on ${page.path} ${problem}.`));
+            }
+        });
+    }
+    if (forms === 0)
+        return [notApplicable("C2", "None of the sampled pages has a quote form.")];
+    return resultOf("C2", failures, `Checked ${plural(forms, "quote form")} on ${plural(pagesWithForms, "page")}: all follow the form layout.`);
+}
+//# sourceMappingURL=c2-quote-form.js.map

package/dist/site-system/rules/enquiry/c2-quote-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"c2-quote-form.js","sourceRoot":"","sources":["../../../../src/site-system/rules/enquiry/c2-quote-form.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * C2: the quote form's layout and labels (Site System v2 §3.1 F8, §9.3).\n *\n * One five-field form: name, suburb, phone, email, \"How can we help?\", then photos. Phone and email are both\n * required. There is no \"(required)\" text, no job-type select, no helper or reassurance line, and exactly one\n * consent line (the line that links the privacy policy). Every enquiry already carries its page path, so there is nothing to choose about the job.\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { fail, notApplicable, plural, resultOf, type ParsedPage } from \"./common.js\";\nimport { accessibleLabel, attr, descendants, isHiddenFromPeople, normaliseText, readableLines, type HtmlElement } from \"./html.js\";\n\n/** The fields of the form, in the order they appear. */\nexport const C2_FIELD_ORDER = [\"name\", \"suburb\", \"phone\", \"email\", \"message\", \"photos\"] as const;\nexport type C2Field = (typeof C2_FIELD_ORDER)[number];\n\n/** The message field's label. The trade-specific prompt goes in the placeholder, never the label. */\nexport const C2_MESSAGE_LABEL = \"How can we help?\";\n\n/** Helper and reassurance lines the spec names. They are written here as examples; the patterns below match them. */\nexport const C2_HELPER_LINE_EXAMPLES = [\n  \"We only use your details to reply\",\n  \"All fields needed; photos are optional\",\n] as const;\n\n/** Wording that explains the form or reassures the visitor. None of it belongs inside the quote form. */\nexport const C2_HELPER_LINE_PATTERNS: readonly RegExp[] = [\n  /\\bwe\\s+(?:only|will\\s+only)\\s+use\\s+(?:your|the)\\s+(?:details|information|info)\\b/i,\n  /\\ball\\s+(?:the\\s+)?fields\\s+(?:are\\s+)?(?:needed|required|mandatory)\\b/i,\n  /\\bphotos?\\s+(?:are|is)\\s+optional\\b/i,\n  /\\bwe(?:'|’)ll\\s+never\\s+(?:share|sell|spam)\\b/i,\n  /\\bwe\\s+(?:will\\s+)?never\\s+(?:share|sell|spam)\\b/i,\n  /\\bno\\s+(?:spam|obligation|pressure|hidden\\s+fees)\\b/i,\n  /\\byour\\s+(?:details|information|privacy)\\s+(?:is|are)\\s+(?:safe|secure|private|protected)\\b/i,\n  /\\btakes?\\s+(?:less\\s+than|under|only|just)\\s+(?:a|an|\\d+)\\s+(?:minute|second|min)/i,\n  /\\bfill\\s+(?:in|out)\\s+(?:the|this)\\s+(?:form|short\\s+form)\\b/i,\n  /\\bwe(?:'|’)ll\\s+(?:get\\s+back\\s+to\\s+you|reply|respond|be\\s+in\\s+touch)\\b/i,\n  /\\b(?:free|quick|easy)[,\\s]+(?:no[- ]obligation|no[- ]hassle)\\b/i,\n];\n\n/** Marks that tell the visitor which fields are required or optional. Required fields use the `required` attribute. */\nexport const C2_REQUIRED_MARKER_PATTERNS: readonly RegExp[] = [\n  /\\(\\s*required\\s*\\)/i,\n  /\\(\\s*optional\\s*\\)/i,\n  /\\brequired\\s+fields?\\b/i,\n  /\\*\\s*required\\b/i,\n  /\\brequired\\s*\\*/i,\n];\n\n/**\n * The consent line is the one line that links the site's own privacy policy. A notice that links somewhere else (a\n * spam-protection widget's privacy link, for example) is not a second consent line.\n */\nexport const C2_CONSENT_LINK = /privacy/i;\n\nconst IGNORED_INPUT_TYPES = new Set([\"hidden\", \"submit\", \"button\", \"reset\", \"image\", \"checkbox\"]);\n\ninterface Control {\n  element: HtmlElement;\n  kind: C2Field | \"select\" | \"choice\" | \"other\";\n}\n\nfunction token(value: string | undefined): string {\n  return (value ?? \"\").toLowerCase();\n}\n\n/** What a control is, judged from its visible label when its name and attributes do not say. */\nfunction classifyByLabel(label: string): C2Field | null {\n  const text = label.toLowerCase().replace(/[^a-z\\s]/g, \" \").replace(/\\s+/g, \" \").trim();\n  if (/\\b(?:suburb|locality|postcode|post code|location|area|town|city)\\b/.test(text)) return \"suburb\";\n  if (/\\b(?:phone|mobile|telephone)\\b/.test(text)) return \"phone\";\n  if (/\\be ?mail\\b/.test(text)) return \"email\";\n  if (/^(?:your |full |first |last )?name\\b/.test(text)) return \"name\";\n  return null;\n}\n\nfunction classify(control: HtmlElement): Control[\"kind\"] {\n  const type = token(attr(control, \"type\"));\n  const autocomplete = token(attr(control, \"autocomplete\"));\n  const identity = `${token(attr(control, \"name\"))} ${token(attr(control, \"id\"))}`;\n  if (control.tag === \"select\") return \"select\";\n  if (control.tag === \"textarea\") return \"message\";\n  if (type === \"file\") return \"photos\";\n  if (type === \"radio\") return \"choice\";\n  if (type === \"tel\" || /\\btel\\b/.test(autocomplete) || /phone|mobile|\\btel\\b/.test(identity)) return \"phone\";\n  if (type === \"email\" || /\\bemail\\b/.test(autocomplete) || /e-?mail/.test(identity)) return \"email\";\n  if (/address-level2|postal-code/.test(autocomplete) || /suburb|locality|postcode|location|area|town|city/.test(identity)) return \"suburb\";\n  if (/^(?:name|given-name|family-name)$/.test(autocomplete) || /(?:^|[\\s_-])(?:full|first|last|your)?[_-]?name\\b/.test(identity)) return \"name\";\n  return \"other\";\n}\n\n/** The controls a visitor sees and fills in, with what each is. A control the attributes do not identify is judged by its label. */\nfunction visibleControls(form: HtmlElement): Control[] {\n  return descendants(form)\n    .filter((element) => [\"input\", \"textarea\", \"select\"].includes(element.tag))\n    .filter((element) => !IGNORED_INPUT_TYPES.has(token(attr(element, \"type\"))))\n    // The honeypot (\"website\" in the shared contact runtime) is out of the tab order and hidden from people.\n    .filter((element) => attr(element, \"name\") !== \"website\" && attr(element, \"tabindex\") !== \"-1\" && !isHiddenFromPeople(element))\n    .map((element): Control => {\n      const kind = classify(element);\n      if (kind !== \"other\") return { element, kind };\n      const label = accessibleLabel(element, form) || attr(element, \"placeholder\") || \"\";\n      return { element, kind: classifyByLabel(label) ?? \"other\" };\n    });\n}\n\nexport function isQuoteForm(form: HtmlElement): boolean {\n  if (attr(form, \"data-bl\") === \"quote-form\") return true;\n  return visibleControls(form).some((control) => control.kind === \"phone\");\n}\n\nfunction isRequired(control: HtmlElement): boolean {\n  return attr(control, \"required\") !== undefined || attr(control, \"aria-required\") === \"true\";\n}\n\nfunction sameLabel(actual: string, expected: string): boolean {\n  const simplify = (value: string) => normaliseText(value).replace(/[?.!:’']/g, \"\").toLowerCase();\n  return simplify(actual) === simplify(expected);\n}\n\n/** Every problem with one quote form, as short fragments that complete \"The quote form on /x …\". */\nexport function quoteFormProblems(form: HtmlElement, baseUrl = \"\"): string[] {\n  const problems: string[] = [];\n  const controls = visibleControls(form);\n\n  for (const field of C2_FIELD_ORDER) {\n    if (!controls.some((control) => control.kind === field)) problems.push(`has no ${field} field`);\n  }\n  const seen = C2_FIELD_ORDER.map((field) => controls.findIndex((control) => control.kind === field));\n  const present = seen.filter((position) => position !== -1);\n  if (present.some((position, index) => index > 0 && position < present[index - 1]!)) {\n    problems.push(`lists its fields out of order; they run ${C2_FIELD_ORDER.join(\", \")}`);\n  }\n\n  for (const control of controls) {\n    if (control.kind === \"select\") {\n      problems.push(`has a select (${attr(control.element, \"name\") ?? attr(control.element, \"id\") ?? \"unnamed\"}); the form has no job-type dropdown`);\n    } else if (control.kind === \"choice\") {\n      problems.push(`asks the visitor to choose between options (${attr(control.element, \"name\") ?? \"unnamed\"}); the form has no job-type choice`);\n    } else if (control.kind === \"other\") {\n      problems.push(`has a field beyond the five (${attr(control.element, \"name\") ?? attr(control.element, \"id\") ?? attr(control.element, \"type\") ?? \"unnamed\"})`);\n    }\n  }\n\n  for (const field of [\"phone\", \"email\"] as const) {\n    const control = controls.find((candidate) => candidate.kind === field);\n    if (control && !isRequired(control.element)) problems.push(`does not require the ${field} field`);\n  }\n\n  const message = controls.find((control) => control.kind === \"message\");\n  if (message) {\n    const label = accessibleLabel(message.element, form);\n    if (!sameLabel(label, C2_MESSAGE_LABEL)) {\n      problems.push(`labels the message field \"${label || \"(no label)\"}\" instead of \"${C2_MESSAGE_LABEL}\"`);\n    }\n  }\n\n  const readable = readableLines(form);\n  const lines = readable.map((line) => line.text);\n  const placeholders = descendants(form).map((element) => attr(element, \"placeholder\")).filter((value): value is string => Boolean(value));\n  const wording = [...lines, ...placeholders];\n\n  for (const pattern of C2_REQUIRED_MARKER_PATTERNS) {\n    const line = wording.find((candidate) => pattern.test(candidate));\n    if (line) {\n      problems.push(`marks fields as required or optional in its wording (\"${shorten(line)}\")`);\n      break;\n    }\n  }\n  const helper = lines.find((line) => C2_HELPER_LINE_PATTERNS.some((pattern) => pattern.test(line)));\n  if (helper) problems.push(`carries a helper or reassurance line (\"${shorten(helper)}\")`);\n\n  const siteHost = hostOf(baseUrl);\n  const consentLines = readable.filter((line) => line.hrefs.some((href) => linksPrivacyPolicy(href, siteHost)));\n  if (consentLines.length === 0) problems.push(\"has no consent line linking the privacy policy\");\n  else if (consentLines.length > 1) problems.push(`has ${consentLines.length} lines linking the privacy policy instead of one consent line`);\n\n  const hasSubmit = descendants(form).some(\n    (element) =>\n      (element.tag === \"button\" && [\"submit\", \"\"].includes(token(attr(element, \"type\")))) ||\n      (element.tag === \"input\" && token(attr(element, \"type\")) === \"submit\"),\n  );\n  if (!hasSubmit) problems.push(\"has no submit button\");\n\n  return problems;\n}\n\nfunction hostOf(baseUrl: string): string {\n  try {\n    return new URL(baseUrl).hostname.replace(/^www\\./, \"\");\n  } catch {\n    return \"\";\n  }\n}\n\n/** Whether a link goes to the site's own privacy policy: a relative link, or one on the site's host, with \"privacy\" in the path. */\nfunction linksPrivacyPolicy(href: string, siteHost: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(href, \"https://site.invalid\");\n  } catch {\n    return false;\n  }\n  const relative = !/^[a-z][a-z0-9+.-]*:/i.test(href) && !href.startsWith(\"//\");\n  const sameSite = relative || (siteHost !== \"\" && url.hostname.replace(/^www\\./, \"\") === siteHost);\n  return sameSite && C2_CONSENT_LINK.test(url.pathname);\n}\n\nfunction shorten(line: string): string {\n  return line.length > 70 ? `${line.slice(0, 67)}...` : line;\n}\n\nexport function checkC2(pages: readonly ParsedPage[], baseUrl = \"\"): SiteSystemFinding[] {\n  const failures: SiteSystemFinding[] = [];\n  let forms = 0;\n  let pagesWithForms = 0;\n  for (const page of pages) {\n    const pageForms = descendants(page.root).filter((element) => element.tag === \"form\" && isQuoteForm(element));\n    if (pageForms.length > 0) pagesWithForms += 1;\n    pageForms.forEach((form, index) => {\n      forms += 1;\n      const which = pageForms.length > 1 ? `quote form ${index + 1}` : \"quote form\";\n      for (const problem of quoteFormProblems(form, baseUrl)) {\n        failures.push(fail(\"C2\", page.path, `The ${which} on ${page.path} ${problem}.`));\n      }\n    });\n  }\n  if (forms === 0) return [notApplicable(\"C2\", \"None of the sampled pages has a quote form.\")];\n  return resultOf(\"C2\", failures, `Checked ${plural(forms, \"quote form\")} on ${plural(pagesWithForms, \"page\")}: all follow the form layout.`);\n}\n"]}

package/dist/site-system/rules/enquiry/common.d.ts

@@ -0,0 +1,37 @@
+import type { SiteSystemCheckId, SiteSystemFinding } from "../../checks.js";
+import { type HtmlElement } from "./html.js";
+/** What every rendered rule receives: the sampled pages' server HTML and where the project lives. */
+export interface EnquiryRuleInput {
+    readonly baseUrl: string;
+    readonly pages: readonly {
+        readonly path: string;
+        readonly html: string;
+    }[];
+    readonly projectRoot: string;
+}
+/** Options for tests; a real run uses the defaults. */
+export interface EnquiryRuleOptions {
+    /** The date licences are judged on. Defaults to now. */
+    readonly asOf?: Date;
+}
+export interface ParsedPage {
+    /** The page path, normalised: a leading slash, no trailing slash (except home), no query or fragment. */
+    readonly path: string;
+    readonly html: string;
+    readonly root: HtmlElement;
+}
+/** A path as the route catalogue writes it: leading slash, no query or fragment, no trailing slash except for home. */
+export declare function normalisePath(path: string): string;
+export declare function parsePages(pages: EnquiryRuleInput["pages"]): ParsedPage[];
+export declare function fail(checkId: SiteSystemCheckId, target: string | undefined, message: string): SiteSystemFinding;
+export declare function pass(checkId: SiteSystemCheckId, message: string, target?: string): SiteSystemFinding;
+export declare function notApplicable(checkId: SiteSystemCheckId, message: string): SiteSystemFinding;
+/** The failures when there are any; otherwise one pass finding. */
+export declare function resultOf(checkId: SiteSystemCheckId, failures: readonly SiteSystemFinding[], passMessage: string): SiteSystemFinding[];
+export declare function plural(count: number, singular: string, pluralForm?: string): string;
+/** The outermost `data-bl-section` elements of a page, in document order. A section nested in one is part of it. */
+export declare function topLevelSections(root: HtmlElement): HtmlElement[];
+export declare function sectionId(section: HtmlElement): string;
+/** Dollar figures in a piece of text, as numbers. A range such as "$450 to 900" counts both ends. */
+export declare function dollarFigures(text: string): number[];
+//# sourceMappingURL=common.d.ts.map