@brandlab-digital/conformance 3.7.0 → 3.9.0

package/dist/site-system/rules/form/c11-contact-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"c11-contact-route.js","sourceRoot":"","sources":["../../../../src/site-system/rules/form/c11-contact-route.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * C11 (static half): the contact route keeps the shared handler's protections (Site System v2 §13.2).\n *\n * `POST /api/contact` must come from the shared handler (`createBrandlabContactRouteHandler`, or\n * `createBrandlabContactRuntime` during the transition, the same evidence as brandlab-verify's\n * contact-provider-route rule). The shared handler strips the `bl_test` marker before delivery and reporting, so a test\n * enquiry is never delivered as a real one, and it rate-limits abuse per IP and per email address. A route that\n * writes its own handler has neither, and a route that passes `rateLimit: false` (or turns off both the per-IP and\n * per-address limits) has switched the second one off.\n *\n * The route file is read from the syntax tree, never run; one hop of local imports is followed because the handler is\n * often created in a `src/config/contact.ts` the route re-exports.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport ts from \"typescript\";\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { fail, notApplicable, pass, type ParsedPage } from \"../enquiry/common.js\";\nimport { isQuoteForm } from \"../enquiry/c2-quote-form.js\";\nimport { descendants } from \"../enquiry/html.js\";\nimport { LiteralReader, isLiteralObject, type Literal } from \"../enquiry/literal.js\";\n\nexport const C11_ROUTE_CANDIDATES = [\n  \"src/app/api/contact/route\",\n  \"app/api/contact/route\",\n] as const;\nconst EXTENSIONS = [\".ts\", \".tsx\", \".mts\", \".js\", \".mjs\"];\nconst SHARED_HANDLERS = new Set([\"createBrandlabContactRouteHandler\", \"createBrandlabContactRuntime\"]);\nconst SHARED_MODULE = /^@brandlab-digital\\/site-next\\/contact(?:\\/|$)/;\n\nfunction fileWithExtension(base: string): string | undefined {\n  for (const extension of EXTENSIONS) if (existsSync(base + extension)) return base + extension;\n  for (const extension of EXTENSIONS) if (existsSync(join(base, `index${extension}`))) return join(base, `index${extension}`);\n  return existsSync(base) && /\\.[a-z]+$/.test(base) ? base : undefined;\n}\n\ninterface ModuleSource {\n  readonly file: string;\n  readonly text: string;\n  readonly source: ts.SourceFile;\n}\n\nfunction readModule(file: string): ModuleSource | undefined {\n  try {\n    const text = readFileSync(file, \"utf8\");\n    return { file, text, source: ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX) };\n  } catch {\n    return undefined;\n  }\n}\n\n/** The names a module imports from the shared contact entry points, by local name. */\nfunction sharedImports(module: ModuleSource): Map<string, string> {\n  const names = new Map<string, string>();\n  for (const statement of module.source.statements) {\n    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) continue;\n    if (!SHARED_MODULE.test(statement.moduleSpecifier.text)) continue;\n    const bindings = statement.importClause?.namedBindings;\n    if (bindings && ts.isNamedImports(bindings)) {\n      for (const element of bindings.elements) names.set(element.name.text, (element.propertyName ?? element.name).text);\n    }\n  }\n  return names;\n}\n\nfunction usesSharedHandler(module: ModuleSource): boolean {\n  const imported = sharedImports(module);\n  let used = false;\n  const visit = (node: ts.Node) => {\n    if (ts.isCallExpression(node) && ts.isIdentifier(node.expression)) {\n      const original = imported.get(node.expression.text);\n      if (original !== undefined && SHARED_HANDLERS.has(original)) used = true;\n    }\n    if (!used) ts.forEachChild(node, visit);\n  };\n  visit(module.source);\n  return used;\n}\n\nfunction localImports(module: ModuleSource, projectRoot: string): ModuleSource[] {\n  const found: ModuleSource[] = [];\n  for (const statement of module.source.statements) {\n    if (!(ts.isImportDeclaration(statement) || ts.isExportDeclaration(statement)) || !statement.moduleSpecifier || !ts.isStringLiteral(statement.moduleSpecifier)) continue;\n    const specifier = statement.moduleSpecifier.text;\n    let base: string | undefined;\n    if (specifier.startsWith(\".\")) base = resolve(dirname(module.file), specifier);\n    else if (specifier.startsWith(\"@/\")) base = join(projectRoot, \"src\", specifier.slice(2));\n    else continue;\n    const file = fileWithExtension(base);\n    const imported = file ? readModule(file) : undefined;\n    if (imported) found.push(imported);\n  }\n  return found;\n}\n\n/** What a `rateLimit` option turns off: \"all\" for `false` (or both limits off), null when the limits stay on. */\nfunction rateLimitOff(module: ModuleSource): string | null {\n  const reader = new LiteralReader(module.text, module.file);\n  for (const expression of reader.propertyValues(\"rateLimit\")) {\n    const value: Literal = reader.evaluate(expression);\n    if (value === false) return \"rateLimit: false\";\n    if (isLiteralObject(value) && value.perIp === false && value.perAddress === false) return \"both the per-IP and per-address limits set to false\";\n  }\n  return null;\n}\n\nexport function checkC11(projectRoot: string, pages: readonly ParsedPage[] = []): SiteSystemFinding[] {\n  const routeBase = C11_ROUTE_CANDIDATES.map((base) => join(projectRoot, base)).map(fileWithExtension).find((file) => file !== undefined);\n  if (!routeBase) {\n    const hasForm = pages.some((page) => descendants(page.root).some((element) => element.tag === \"form\" && isQuoteForm(element)));\n    return hasForm\n      ? [fail(\"C11\", C11_ROUTE_CANDIDATES[0] + \".ts\", \"The site has a quote form but no /api/contact route, so enquiries have no shared handler, test-marker handling or rate limits.\")]\n      : [notApplicable(\"C11\", \"None of the sampled pages has a quote form and the project has no /api/contact route.\")];\n  }\n  const route = readModule(routeBase);\n  if (!route) return [];\n  const shown = routeBase.slice(projectRoot.length).replace(/^\\/+/, \"\");\n  const modules = [route, ...localImports(route, projectRoot)];\n\n  const off = modules.map((module) => ({ module, off: rateLimitOff(module) })).find((entry) => entry.off !== null);\n  if (off) {\n    const where = off.module.file === routeBase ? shown : off.module.file.slice(projectRoot.length).replace(/^\\/+/, \"\");\n    return [fail(\"C11\", where, `The contact route turns the rate limits off (${off.off} in ${where}); /api/contact must stay rate-limited per IP and per email address.`)];\n  }\n  if (!modules.some(usesSharedHandler)) {\n    return [fail(\"C11\", shown, `${shown} does not create its handler with the shared contact handler, so the bl_test marker is not stripped before delivery and /api/contact is not rate-limited.`)];\n  }\n  return [pass(\"C11\", `${shown} uses the shared contact handler: the bl_test marker is stripped before delivery and reporting, and /api/contact keeps its rate limits.`, shown)];\n}\n"]}

package/dist/site-system/rules/form/c7-thank-you.d.ts

@@ -0,0 +1,20 @@
+/**
+ * C7: the thank-you page (Site System v2 §13.2, CONV §14 item 10).
+ *
+ * After an accepted enquiry the visitor lands on a page that says when they will hear back, offers a `tel:` link for
+ * anything urgent, and keeps itself out of search (`noindex, follow`) so it never ranks and never counts as a lead.
+ * The library's `ThankYou` block and `thankYouMetadata()` do all three. A site with a quote form but no thank-you page
+ * among the sampled pages fails: the form has nowhere to send an accepted enquiry.
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "../enquiry/common.js";
+import { type HtmlElement } from "../enquiry/html.js";
+/** A sentence that says how soon the business replies: "within one business day", "in 1 to 2 hours", "within the hour". */
+export declare const C7_REPLY_TIME: RegExp;
+/**
+ * The robots directives of a page, from every `<meta name="robots">` tag. A `googlebot` tag alone does not count: it
+ * leaves Bing and every other crawler free to index the page, which is why `thankYouMetadata()` writes both.
+ */
+export declare function robotsDirectives(root: HtmlElement): string[];
+export declare function checkC7(pages: readonly ParsedPage[], missing?: readonly string[]): SiteSystemFinding[];
+//# sourceMappingURL=c7-thank-you.d.ts.map

package/dist/site-system/rules/form/c7-thank-you.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"c7-thank-you.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/form/c7-thank-you.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAyC,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9F,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjF,2HAA2H;AAC3H,eAAO,MAAM,aAAa,QASzB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAK5D;AAcD,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,iBAAiB,EAAE,CA+B1G"}

package/dist/site-system/rules/form/c7-thank-you.js

@@ -0,0 +1,67 @@
+import { fail, notApplicable, plural, resultOf } from "../enquiry/common.js";
+import { isQuoteForm } from "../enquiry/c2-quote-form.js";
+import { attr, descendants, textOf } from "../enquiry/html.js";
+import { byHook, isThankYouPath, mainOf } from "../library/common.js";
+const NUMBER = String.raw `(?:(?:a\s+)?(?:few|couple(?:\s+of)?|half(?:\s+an)?)|one|two|three|four|five|six|seven|eight|nine|ten|twelve|an?|\d+)`;
+const UNIT = String.raw `(?:minutes?|mins?|hours?|hrs?|business\s+days?|working\s+days?|days?)`;
+/** A sentence that says how soon the business replies: "within one business day", "in 1 to 2 hours", "within the hour". */
+export const C7_REPLY_TIME = new RegExp([
+    String.raw `\b(?:within|in|inside|under)\s+(?:the\s+)?(?:next\s+)?${NUMBER}(?:\s*(?:-|–|to|or)\s*${NUMBER})?\s+${UNIT}\b`,
+    String.raw `\b(?:within|in|inside|under)\s+(?:the\s+)?(?:next\s+)?(?:hour|day)\b`,
+    String.raw `\b(?:within|during|in)\s+(?:our\s+)?(?:normal\s+)?(?:business|working|office)\s+hours\b`,
+    String.raw `\b(?:same|next)(?:[-\s]+business)?[-\s]+day\b`,
+    String.raw `\bby\s+(?:the\s+)?end\s+of\s+(?:the\s+)?(?:business\s+)?day\b`,
+].join("|"), "i");
+/**
+ * The robots directives of a page, from every `<meta name="robots">` tag. A `googlebot` tag alone does not count: it
+ * leaves Bing and every other crawler free to index the page, which is why `thankYouMetadata()` writes both.
+ */
+export function robotsDirectives(root) {
+    return descendants(root)
+        .filter((element) => element.tag === "meta" && (attr(element, "name") ?? "").toLowerCase() === "robots")
+        .flatMap((element) => (attr(element, "content") ?? "").toLowerCase().split(/[,\s]+/))
+        .filter(Boolean);
+}
+function hasQuoteForm(page) {
+    return descendants(page.root).some((element) => element.tag === "form" && isQuoteForm(element));
+}
+function telLinks(scope) {
+    return descendants(scope).filter((element) => element.tag === "a" && (attr(element, "href") ?? "").trim().toLowerCase().startsWith("tel:"));
+}
+function isThankYouPage(page) {
+    return isThankYouPath(page.path) || byHook(page.root, "thank-you").length > 0;
+}
+export function checkC7(pages, missing = []) {
+    const thankYouPages = pages.filter(isThankYouPage);
+    if (thankYouPages.length === 0) {
+        const named = missing.find((path) => isThankYouPath(path));
+        if (named !== undefined) {
+            return [fail("C7", named, `The thank-you page ${named} could not be read, so its reply time, call link and noindex were not checked.`)];
+        }
+        if (!pages.some(hasQuoteForm))
+            return [notApplicable("C7", "None of the sampled pages has a quote form or a thank-you page.")];
+        return [fail("C7", undefined, "The site has a quote form but no thank-you page for an accepted enquiry to open.")];
+    }
+    const failures = [];
+    for (const page of thankYouPages) {
+        const block = byHook(page.root, "thank-you")[0];
+        const scope = block ?? mainOf(page.root);
+        const reply = descendants(scope).find((element) => attr(element, "data-slot") === "reply");
+        const replyText = reply ? textOf(reply) : textOf(scope);
+        if (!C7_REPLY_TIME.test(replyText)) {
+            failures.push(fail("C7", page.path, `The thank-you page ${page.path} does not say when the business will reply (for example "within one business day").`));
+        }
+        if (telLinks(scope).length === 0) {
+            failures.push(fail("C7", page.path, `The thank-you page ${page.path} has no tel: link for anything urgent.`));
+        }
+        const directives = robotsDirectives(page.root);
+        if (!directives.includes("noindex") && !directives.includes("none")) {
+            failures.push(fail("C7", page.path, `The thank-you page ${page.path} is not noindex; it carries robots "${directives.join(", ") || "none"}" instead of "noindex, follow".`));
+        }
+        else if (directives.includes("nofollow") || directives.includes("none")) {
+            failures.push(fail("C7", page.path, `The thank-you page ${page.path} is noindex but also nofollow; its links should still be followed ("noindex, follow").`));
+        }
+    }
+    return resultOf("C7", failures, `Checked ${plural(thankYouPages.length, "thank-you page")}: each gives a reply time and a tel: link and is noindex, follow.`);
+}
+//# sourceMappingURL=c7-thank-you.js.map

package/dist/site-system/rules/form/c7-thank-you.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"c7-thank-you.js","sourceRoot":"","sources":["../../../../src/site-system/rules/form/c7-thank-you.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * C7: the thank-you page (Site System v2 §13.2, CONV §14 item 10).\n *\n * After an accepted enquiry the visitor lands on a page that says when they will hear back, offers a `tel:` link for\n * anything urgent, and keeps itself out of search (`noindex, follow`) so it never ranks and never counts as a lead.\n * The library's `ThankYou` block and `thankYouMetadata()` do all three. A site with a quote form but no thank-you page\n * among the sampled pages fails: the form has nowhere to send an accepted enquiry.\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { fail, notApplicable, plural, resultOf, type ParsedPage } from \"../enquiry/common.js\";\nimport { isQuoteForm } from \"../enquiry/c2-quote-form.js\";\nimport { attr, descendants, textOf, type HtmlElement } from \"../enquiry/html.js\";\nimport { byHook, isThankYouPath, mainOf } from \"../library/common.js\";\n\nconst NUMBER = String.raw`(?:(?:a\\s+)?(?:few|couple(?:\\s+of)?|half(?:\\s+an)?)|one|two|three|four|five|six|seven|eight|nine|ten|twelve|an?|\\d+)`;\nconst UNIT = String.raw`(?:minutes?|mins?|hours?|hrs?|business\\s+days?|working\\s+days?|days?)`;\n\n/** A sentence that says how soon the business replies: \"within one business day\", \"in 1 to 2 hours\", \"within the hour\". */\nexport const C7_REPLY_TIME = new RegExp(\n  [\n    String.raw`\\b(?:within|in|inside|under)\\s+(?:the\\s+)?(?:next\\s+)?${NUMBER}(?:\\s*(?:-|–|to|or)\\s*${NUMBER})?\\s+${UNIT}\\b`,\n    String.raw`\\b(?:within|in|inside|under)\\s+(?:the\\s+)?(?:next\\s+)?(?:hour|day)\\b`,\n    String.raw`\\b(?:within|during|in)\\s+(?:our\\s+)?(?:normal\\s+)?(?:business|working|office)\\s+hours\\b`,\n    String.raw`\\b(?:same|next)(?:[-\\s]+business)?[-\\s]+day\\b`,\n    String.raw`\\bby\\s+(?:the\\s+)?end\\s+of\\s+(?:the\\s+)?(?:business\\s+)?day\\b`,\n  ].join(\"|\"),\n  \"i\",\n);\n\n/**\n * The robots directives of a page, from every `<meta name=\"robots\">` tag. A `googlebot` tag alone does not count: it\n * leaves Bing and every other crawler free to index the page, which is why `thankYouMetadata()` writes both.\n */\nexport function robotsDirectives(root: HtmlElement): string[] {\n  return descendants(root)\n    .filter((element) => element.tag === \"meta\" && (attr(element, \"name\") ?? \"\").toLowerCase() === \"robots\")\n    .flatMap((element) => (attr(element, \"content\") ?? \"\").toLowerCase().split(/[,\\s]+/))\n    .filter(Boolean);\n}\n\nfunction hasQuoteForm(page: ParsedPage): boolean {\n  return descendants(page.root).some((element) => element.tag === \"form\" && isQuoteForm(element));\n}\n\nfunction telLinks(scope: HtmlElement): HtmlElement[] {\n  return descendants(scope).filter((element) => element.tag === \"a\" && (attr(element, \"href\") ?? \"\").trim().toLowerCase().startsWith(\"tel:\"));\n}\n\nfunction isThankYouPage(page: ParsedPage): boolean {\n  return isThankYouPath(page.path) || byHook(page.root, \"thank-you\").length > 0;\n}\n\nexport function checkC7(pages: readonly ParsedPage[], missing: readonly string[] = []): SiteSystemFinding[] {\n  const thankYouPages = pages.filter(isThankYouPage);\n  if (thankYouPages.length === 0) {\n    const named = missing.find((path) => isThankYouPath(path));\n    if (named !== undefined) {\n      return [fail(\"C7\", named, `The thank-you page ${named} could not be read, so its reply time, call link and noindex were not checked.`)];\n    }\n    if (!pages.some(hasQuoteForm)) return [notApplicable(\"C7\", \"None of the sampled pages has a quote form or a thank-you page.\")];\n    return [fail(\"C7\", undefined, \"The site has a quote form but no thank-you page for an accepted enquiry to open.\")];\n  }\n\n  const failures: SiteSystemFinding[] = [];\n  for (const page of thankYouPages) {\n    const block = byHook(page.root, \"thank-you\")[0];\n    const scope = block ?? mainOf(page.root);\n    const reply = descendants(scope).find((element) => attr(element, \"data-slot\") === \"reply\");\n    const replyText = reply ? textOf(reply) : textOf(scope);\n    if (!C7_REPLY_TIME.test(replyText)) {\n      failures.push(fail(\"C7\", page.path, `The thank-you page ${page.path} does not say when the business will reply (for example \"within one business day\").`));\n    }\n    if (telLinks(scope).length === 0) {\n      failures.push(fail(\"C7\", page.path, `The thank-you page ${page.path} has no tel: link for anything urgent.`));\n    }\n    const directives = robotsDirectives(page.root);\n    if (!directives.includes(\"noindex\") && !directives.includes(\"none\")) {\n      failures.push(fail(\"C7\", page.path, `The thank-you page ${page.path} is not noindex; it carries robots \"${directives.join(\", \") || \"none\"}\" instead of \"noindex, follow\".`));\n    } else if (directives.includes(\"nofollow\") || directives.includes(\"none\")) {\n      failures.push(fail(\"C7\", page.path, `The thank-you page ${page.path} is noindex but also nofollow; its links should still be followed (\"noindex, follow\").`));\n    }\n  }\n  return resultOf(\"C7\", failures, `Checked ${plural(thankYouPages.length, \"thank-you page\")}: each gives a reply time and a tel: link and is noindex, follow.`);\n}\n"]}

package/dist/site-system/rules/form/c8-forgiving-form.d.ts

@@ -0,0 +1,19 @@
+/**
+ * C8: the forgiving form (Site System v2 §13.2, CONV §4.2).
+ *
+ * People type their phone number every way there is: "0412 345 678", "(02) 9123 4567", "+61 412 345 678", "13 14 15",
+ * "1300 123 456", "1800 123 456". The phone input must be `type="tel"` (or carry `inputmode="tel"`), must not carry a
+ * `pattern`, `maxlength` or `minlength` that turns any of those away, and every field names its `autocomplete` token so
+ * a phone can fill the form in one tap: `name`, `address-level2` for the suburb, `tel`, `email`. The photo input never
+ * carries `capture`, which would force the camera and hide the photo library.
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "../enquiry/common.js";
+import { type HtmlElement } from "../enquiry/html.js";
+/** Phone numbers a real visitor types; a pattern, minimum or maximum length must accept every one. */
+export declare const C8_PHONE_SAMPLES: readonly ["0412 345 678", "0412345678", "04 1234 5678", "(02) 9123 4567", "02 9123 4567", "02-9123-4567", "+61 412 345 678", "+61412345678", "+61 2 9123 4567", "13 14 15", "131415", "1300 123 456", "1300123456", "1800 123 456", "1800123456"];
+/** What is wrong with the phone input, as short fragments. */
+export declare function phoneInputProblems(input: HtmlElement): string[];
+export declare function formProblems(form: HtmlElement): string[];
+export declare function checkC8(pages: readonly ParsedPage[]): SiteSystemFinding[];
+//# sourceMappingURL=c8-forgiving-form.d.ts.map

package/dist/site-system/rules/form/c8-forgiving-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"c8-forgiving-form.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/form/c8-forgiving-form.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEpF,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG7F,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,mPAgBnB,CAAC;AAuCX,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,CAqB/D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAoBxD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,iBAAiB,EAAE,CAczE"}

package/dist/site-system/rules/form/c8-forgiving-form.js

@@ -0,0 +1,128 @@
+import { notApplicable, pass, plural } from "../enquiry/common.js";
+import { isQuoteForm } from "../enquiry/c2-quote-form.js";
+import { attr, descendants, isHiddenFromPeople } from "../enquiry/html.js";
+import { PageProblems } from "../library/common.js";
+/** Phone numbers a real visitor types; a pattern, minimum or maximum length must accept every one. */
+export const C8_PHONE_SAMPLES = [
+    "0412 345 678",
+    "0412345678",
+    "04 1234 5678",
+    "(02) 9123 4567",
+    "02 9123 4567",
+    "02-9123-4567",
+    "+61 412 345 678",
+    "+61412345678",
+    "+61 2 9123 4567",
+    "13 14 15",
+    "131415",
+    "1300 123 456",
+    "1300123456",
+    "1800 123 456",
+    "1800123456",
+];
+const AUTOCOMPLETE_TOKENS = {
+    name: ["name", "given-name"],
+    suburb: ["address-level2"],
+    phone: ["tel", "tel-national"],
+    email: ["email"],
+};
+function token(value) {
+    return (value ?? "").trim().toLowerCase();
+}
+/** Which of the four text fields an input is, from its type, autocomplete token, name and id. */
+function fieldOf(input) {
+    const type = token(attr(input, "type"));
+    const autocomplete = token(attr(input, "autocomplete")).split(/\s+/);
+    const identity = `${token(attr(input, "name"))} ${token(attr(input, "id"))}`;
+    if (type === "tel" || token(attr(input, "inputmode")) === "tel" || autocomplete.some((part) => part.startsWith("tel")) || /phone|mobile|\btel\b/.test(identity))
+        return "phone";
+    if (type === "email" || autocomplete.includes("email") || /e-?mail/.test(identity))
+        return "email";
+    if (autocomplete.includes("address-level2") || /suburb|locality|town|city/.test(identity))
+        return "suburb";
+    if (autocomplete.some((part) => part === "name" || part === "given-name" || part === "family-name") || /(?:^|[\s_-])(?:full|first|your)?[_-]?name\b/.test(identity))
+        return "name";
+    return null;
+}
+/** The pattern as the browser applies it: the whole value must match. Null when it is not a usable expression. */
+function wholeValuePattern(pattern) {
+    for (const flags of ["v", "u"]) {
+        try {
+            return new RegExp(`^(?:${pattern})$`, flags);
+        }
+        catch {
+            // try the next flag set
+        }
+    }
+    return null;
+}
+/** What is wrong with the phone input, as short fragments. */
+export function phoneInputProblems(input) {
+    const problems = [];
+    const type = token(attr(input, "type"));
+    if (type !== "tel" && token(attr(input, "inputmode")) !== "tel") {
+        problems.push(`the phone input is type="${type || "text"}" without inputmode="tel", so phones show the wrong keyboard`);
+    }
+    const pattern = attr(input, "pattern");
+    if (pattern !== undefined && pattern !== "") {
+        const expression = wholeValuePattern(pattern);
+        const rejected = expression ? C8_PHONE_SAMPLES.filter((sample) => !expression.test(sample)) : [];
+        if (rejected.length > 0) {
+            problems.push(`the phone pattern turns away ${rejected.slice(0, 3).map((sample) => `"${sample}"`).join(", ")}${rejected.length > 3 ? ` and ${rejected.length - 3} more` : ""}`);
+        }
+    }
+    const longest = Math.max(...C8_PHONE_SAMPLES.map((sample) => sample.length));
+    const shortest = Math.min(...C8_PHONE_SAMPLES.map((sample) => sample.length));
+    const maxlength = Number.parseInt(attr(input, "maxlength") ?? "", 10);
+    if (Number.isFinite(maxlength) && maxlength < longest)
+        problems.push(`maxlength="${maxlength}" is too short for a number typed with +61 and spaces`);
+    const minlength = Number.parseInt(attr(input, "minlength") ?? "", 10);
+    if (Number.isFinite(minlength) && minlength > shortest)
+        problems.push(`minlength="${minlength}" turns away a 13 number such as "131415"`);
+    return problems;
+}
+export function formProblems(form) {
+    const problems = [];
+    const inputs = descendants(form).filter((element) => element.tag === "input" && !isHiddenFromPeople(element) && attr(element, "tabindex") !== "-1");
+    const seen = new Set();
+    for (const input of inputs) {
+        if (token(attr(input, "type")) === "file")
+            continue;
+        const field = fieldOf(input);
+        if (!field)
+            continue;
+        seen.add(field);
+        const autocomplete = token(attr(input, "autocomplete")).split(/\s+/).filter(Boolean);
+        if (!autocomplete.some((part) => AUTOCOMPLETE_TOKENS[field].includes(part))) {
+            problems.push(`the ${field} input has no autocomplete="${AUTOCOMPLETE_TOKENS[field][0]}"`);
+        }
+        if (field === "phone")
+            problems.push(...phoneInputProblems(input));
+    }
+    if (!seen.has("phone"))
+        problems.push("the form has no phone input to check");
+    for (const file of descendants(form).filter((element) => element.tag === "input" && token(attr(element, "type")) === "file")) {
+        if (attr(file, "capture") !== undefined)
+            problems.push("the photo input has a capture attribute, which forces the camera and hides the photo library");
+    }
+    return problems;
+}
+export function checkC8(pages) {
+    const problems = new PageProblems();
+    let forms = 0;
+    const formPages = new Set();
+    for (const page of pages) {
+        for (const form of descendants(page.root).filter((element) => element.tag === "form" && isQuoteForm(element))) {
+            forms += 1;
+            formPages.add(page.path);
+            for (const problem of formProblems(form))
+                problems.add(page.path, `The quote form is not forgiving: ${problem}`);
+        }
+    }
+    if (forms === 0)
+        return [notApplicable("C8", "None of the sampled pages has a quote form.")];
+    if (problems.size > 0)
+        return problems.findings("C8");
+    return [pass("C8", `Checked ${plural(forms, "quote form")} on ${plural(formPages.size, "page")}: each takes a phone number in any format and names its autocomplete tokens, and the photo input has no capture.`)];
+}
+//# sourceMappingURL=c8-forgiving-form.js.map

package/dist/site-system/rules/form/c8-forgiving-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"c8-forgiving-form.js","sourceRoot":"","sources":["../../../../src/site-system/rules/form/c8-forgiving-form.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * C8: the forgiving form (Site System v2 §13.2, CONV §4.2).\n *\n * People type their phone number every way there is: \"0412 345 678\", \"(02) 9123 4567\", \"+61 412 345 678\", \"13 14 15\",\n * \"1300 123 456\", \"1800 123 456\". The phone input must be `type=\"tel\"` (or carry `inputmode=\"tel\"`), must not carry a\n * `pattern`, `maxlength` or `minlength` that turns any of those away, and every field names its `autocomplete` token so\n * a phone can fill the form in one tap: `name`, `address-level2` for the suburb, `tel`, `email`. The photo input never\n * carries `capture`, which would force the camera and hide the photo library.\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { notApplicable, pass, plural, type ParsedPage } from \"../enquiry/common.js\";\nimport { isQuoteForm } from \"../enquiry/c2-quote-form.js\";\nimport { attr, descendants, isHiddenFromPeople, type HtmlElement } from \"../enquiry/html.js\";\nimport { PageProblems } from \"../library/common.js\";\n\n/** Phone numbers a real visitor types; a pattern, minimum or maximum length must accept every one. */\nexport const C8_PHONE_SAMPLES = [\n  \"0412 345 678\",\n  \"0412345678\",\n  \"04 1234 5678\",\n  \"(02) 9123 4567\",\n  \"02 9123 4567\",\n  \"02-9123-4567\",\n  \"+61 412 345 678\",\n  \"+61412345678\",\n  \"+61 2 9123 4567\",\n  \"13 14 15\",\n  \"131415\",\n  \"1300 123 456\",\n  \"1300123456\",\n  \"1800 123 456\",\n  \"1800123456\",\n] as const;\n\nconst AUTOCOMPLETE_TOKENS = {\n  name: [\"name\", \"given-name\"],\n  suburb: [\"address-level2\"],\n  phone: [\"tel\", \"tel-national\"],\n  email: [\"email\"],\n} as const;\n\ntype Field = keyof typeof AUTOCOMPLETE_TOKENS;\n\nfunction token(value: string | undefined): string {\n  return (value ?? \"\").trim().toLowerCase();\n}\n\n/** Which of the four text fields an input is, from its type, autocomplete token, name and id. */\nfunction fieldOf(input: HtmlElement): Field | null {\n  const type = token(attr(input, \"type\"));\n  const autocomplete = token(attr(input, \"autocomplete\")).split(/\\s+/);\n  const identity = `${token(attr(input, \"name\"))} ${token(attr(input, \"id\"))}`;\n  if (type === \"tel\" || token(attr(input, \"inputmode\")) === \"tel\" || autocomplete.some((part) => part.startsWith(\"tel\")) || /phone|mobile|\\btel\\b/.test(identity)) return \"phone\";\n  if (type === \"email\" || autocomplete.includes(\"email\") || /e-?mail/.test(identity)) return \"email\";\n  if (autocomplete.includes(\"address-level2\") || /suburb|locality|town|city/.test(identity)) return \"suburb\";\n  if (autocomplete.some((part) => part === \"name\" || part === \"given-name\" || part === \"family-name\") || /(?:^|[\\s_-])(?:full|first|your)?[_-]?name\\b/.test(identity)) return \"name\";\n  return null;\n}\n\n/** The pattern as the browser applies it: the whole value must match. Null when it is not a usable expression. */\nfunction wholeValuePattern(pattern: string): RegExp | null {\n  for (const flags of [\"v\", \"u\"]) {\n    try {\n      return new RegExp(`^(?:${pattern})$`, flags);\n    } catch {\n      // try the next flag set\n    }\n  }\n  return null;\n}\n\n/** What is wrong with the phone input, as short fragments. */\nexport function phoneInputProblems(input: HtmlElement): string[] {\n  const problems: string[] = [];\n  const type = token(attr(input, \"type\"));\n  if (type !== \"tel\" && token(attr(input, \"inputmode\")) !== \"tel\") {\n    problems.push(`the phone input is type=\"${type || \"text\"}\" without inputmode=\"tel\", so phones show the wrong keyboard`);\n  }\n  const pattern = attr(input, \"pattern\");\n  if (pattern !== undefined && pattern !== \"\") {\n    const expression = wholeValuePattern(pattern);\n    const rejected = expression ? C8_PHONE_SAMPLES.filter((sample) => !expression.test(sample)) : [];\n    if (rejected.length > 0) {\n      problems.push(`the phone pattern turns away ${rejected.slice(0, 3).map((sample) => `\"${sample}\"`).join(\", \")}${rejected.length > 3 ? ` and ${rejected.length - 3} more` : \"\"}`);\n    }\n  }\n  const longest = Math.max(...C8_PHONE_SAMPLES.map((sample) => sample.length));\n  const shortest = Math.min(...C8_PHONE_SAMPLES.map((sample) => sample.length));\n  const maxlength = Number.parseInt(attr(input, \"maxlength\") ?? \"\", 10);\n  if (Number.isFinite(maxlength) && maxlength < longest) problems.push(`maxlength=\"${maxlength}\" is too short for a number typed with +61 and spaces`);\n  const minlength = Number.parseInt(attr(input, \"minlength\") ?? \"\", 10);\n  if (Number.isFinite(minlength) && minlength > shortest) problems.push(`minlength=\"${minlength}\" turns away a 13 number such as \"131415\"`);\n  return problems;\n}\n\nexport function formProblems(form: HtmlElement): string[] {\n  const problems: string[] = [];\n  const inputs = descendants(form).filter((element) => element.tag === \"input\" && !isHiddenFromPeople(element) && attr(element, \"tabindex\") !== \"-1\");\n  const seen = new Set<Field>();\n  for (const input of inputs) {\n    if (token(attr(input, \"type\")) === \"file\") continue;\n    const field = fieldOf(input);\n    if (!field) continue;\n    seen.add(field);\n    const autocomplete = token(attr(input, \"autocomplete\")).split(/\\s+/).filter(Boolean);\n    if (!autocomplete.some((part) => (AUTOCOMPLETE_TOKENS[field] as readonly string[]).includes(part))) {\n      problems.push(`the ${field} input has no autocomplete=\"${AUTOCOMPLETE_TOKENS[field][0]}\"`);\n    }\n    if (field === \"phone\") problems.push(...phoneInputProblems(input));\n  }\n  if (!seen.has(\"phone\")) problems.push(\"the form has no phone input to check\");\n  for (const file of descendants(form).filter((element) => element.tag === \"input\" && token(attr(element, \"type\")) === \"file\")) {\n    if (attr(file, \"capture\") !== undefined) problems.push(\"the photo input has a capture attribute, which forces the camera and hides the photo library\");\n  }\n  return problems;\n}\n\nexport function checkC8(pages: readonly ParsedPage[]): SiteSystemFinding[] {\n  const problems = new PageProblems();\n  let forms = 0;\n  const formPages = new Set<string>();\n  for (const page of pages) {\n    for (const form of descendants(page.root).filter((element) => element.tag === \"form\" && isQuoteForm(element))) {\n      forms += 1;\n      formPages.add(page.path);\n      for (const problem of formProblems(form)) problems.add(page.path, `The quote form is not forgiving: ${problem}`);\n    }\n  }\n  if (forms === 0) return [notApplicable(\"C8\", \"None of the sampled pages has a quote form.\")];\n  if (problems.size > 0) return problems.findings(\"C8\");\n  return [pass(\"C8\", `Checked ${plural(forms, \"quote form\")} on ${plural(formPages.size, \"page\")}: each takes a phone number in any format and names its autocomplete tokens, and the photo input has no capture.`)];\n}\n"]}

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

@@ -0,0 +1,14 @@
+/**
+ * The form rule module (release 3.10.0): C7 the thank-you page, C8 the forgiving form and C11 the contact route's
+ * protections. C7 and C8 read the sampled pages' server HTML; C11 reads the project's `/api/contact` route.
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+import type { SiteSystemRenderedInput } from "../../runners.js";
+export { C11_ROUTE_CANDIDATES, checkC11 } from "./c11-contact-route.js";
+export { C7_REPLY_TIME, checkC7, robotsDirectives } from "./c7-thank-you.js";
+export { C8_PHONE_SAMPLES, checkC8, formProblems, phoneInputProblems } from "./c8-forgiving-form.js";
+/** Runs C7, C8 and C11. */
+export declare function runFormRules(input: Pick<SiteSystemRenderedInput, "baseUrl" | "pages" | "projectRoot"> & {
+    readonly missing?: readonly string[];
+}): Promise<readonly SiteSystemFinding[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/form/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAKhE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAErG,2BAA2B;AAC3B,wBAAsB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAG9L"}

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

@@ -0,0 +1,13 @@
+import { parsePages } from "../enquiry/common.js";
+import { checkC11 } from "./c11-contact-route.js";
+import { checkC7 } from "./c7-thank-you.js";
+import { checkC8 } from "./c8-forgiving-form.js";
+export { C11_ROUTE_CANDIDATES, checkC11 } from "./c11-contact-route.js";
+export { C7_REPLY_TIME, checkC7, robotsDirectives } from "./c7-thank-you.js";
+export { C8_PHONE_SAMPLES, checkC8, formProblems, phoneInputProblems } from "./c8-forgiving-form.js";
+/** Runs C7, C8 and C11. */
+export async function runFormRules(input) {
+    const pages = parsePages(input.pages);
+    return [...checkC7(pages, input.missing ?? []), ...checkC8(pages), ...checkC11(input.projectRoot, pages)];
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/site-system/rules/form/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAErG,2BAA2B;AAC3B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAoH;IACrJ,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;AAC5G,CAAC","sourcesContent":["/**\n * The form rule module (release 3.10.0): C7 the thank-you page, C8 the forgiving form and C11 the contact route's\n * protections. C7 and C8 read the sampled pages' server HTML; C11 reads the project's `/api/contact` route.\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { parsePages } from \"../enquiry/common.js\";\nimport type { SiteSystemRenderedInput } from \"../../runners.js\";\nimport { checkC11 } from \"./c11-contact-route.js\";\nimport { checkC7 } from \"./c7-thank-you.js\";\nimport { checkC8 } from \"./c8-forgiving-form.js\";\n\nexport { C11_ROUTE_CANDIDATES, checkC11 } from \"./c11-contact-route.js\";\nexport { C7_REPLY_TIME, checkC7, robotsDirectives } from \"./c7-thank-you.js\";\nexport { C8_PHONE_SAMPLES, checkC8, formProblems, phoneInputProblems } from \"./c8-forgiving-form.js\";\n\n/** Runs C7, C8 and C11. */\nexport async function runFormRules(input: Pick<SiteSystemRenderedInput, \"baseUrl\" | \"pages\" | \"projectRoot\"> & { readonly missing?: readonly string[] }): Promise<readonly SiteSystemFinding[]> {\n  const pages = parsePages(input.pages);\n  return [...checkC7(pages, input.missing ?? []), ...checkC8(pages), ...checkC11(input.projectRoot, pages)];\n}\n"]}

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

@@ -0,0 +1,36 @@
+/**
+ * Helpers the 3.9.0 to 3.11.0 rule modules (library, form, sections) share: the same problem found on many pages is
+ * one finding that names a few of them, and a page is found by the last segment of its path so a site mounted below a
+ * prefix (the component catalogue) reads like a site mounted at the root.
+ */
+import type { SiteSystemCheckId, SiteSystemFinding } from "../../checks.js";
+import { type HtmlElement } from "../enquiry/html.js";
+/** "/a", "/a and /b", "/a, /b and /c", or "/a, /b, /c and 4 other pages". */
+export declare function pagesPhrase(paths: readonly string[]): string;
+/** Collects `problem` (a clause with no subject) against the pages it was found on. */
+export declare class PageProblems {
+    private readonly found;
+    add(path: string, problem: string): void;
+    get size(): number;
+    /** One failing finding per distinct problem: "{problem} on {pages}." The target is the first page. */
+    findings(checkId: SiteSystemCheckId): SiteSystemFinding[];
+}
+/** The path's last segment, lower case: "/aa-tree/contact" and "/contact" both give "contact"; home gives "". */
+export declare function lastSegment(path: string): string;
+export declare function isContactPath(path: string): boolean;
+/** The contact page: a contact path, or any page that holds the library's contact section. */
+export declare function isContactPage(page: {
+    readonly path: string;
+    readonly root: HtmlElement;
+}): boolean;
+export declare function isThankYouPath(path: string): boolean;
+/** The first element below `node` for which `test` holds. */
+export declare function findElement(node: HtmlElement, test: (element: HtmlElement) => boolean): HtmlElement | undefined;
+export declare function hookOf(element: HtmlElement): string | undefined;
+/** Elements carrying `data-bl="name"`. */
+export declare function byHook(root: HtmlElement, name: string): HtmlElement[];
+/** The `<main>` element, or the whole document when the page has none. */
+export declare function mainOf(root: HtmlElement): HtmlElement;
+/** The first `n` items of a list, then "and N more": for messages that name files or images. */
+export declare function namedList(items: readonly string[], shown?: number): string;
+//# sourceMappingURL=common.d.ts.map

package/dist/site-system/rules/library/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/library/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKzE,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAO5D;AAED,uFAAuF;AACvF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IAErD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IASxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sGAAsG;IACtG,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE;CAG1D;AAED,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG,OAAO,CAElG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,GAAG,SAAS,CAE/G;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED,0CAA0C;AAC1C,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAErE;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAErD;AAED,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,CAGrE"}

package/dist/site-system/rules/library/common.js

@@ -0,0 +1,70 @@
+import { fail } from "../enquiry/common.js";
+import { attr, descendants } from "../enquiry/html.js";
+/** How many page paths a message names before it says "and N other pages". */
+const NAMED_PAGES = 3;
+/** "/a", "/a and /b", "/a, /b and /c", or "/a, /b, /c and 4 other pages". */
+export function pagesPhrase(paths) {
+    const unique = [...new Set(paths)];
+    if (unique.length <= NAMED_PAGES) {
+        return unique.length <= 1 ? (unique[0] ?? "the site") : `${unique.slice(0, -1).join(", ")} and ${unique[unique.length - 1]}`;
+    }
+    const rest = unique.length - NAMED_PAGES;
+    return `${unique.slice(0, NAMED_PAGES).join(", ")} and ${rest} other ${rest === 1 ? "page" : "pages"}`;
+}
+/** Collects `problem` (a clause with no subject) against the pages it was found on. */
+export class PageProblems {
+    found = new Map();
+    add(path, problem) {
+        const paths = this.found.get(problem);
+        if (paths) {
+            if (!paths.includes(path))
+                paths.push(path);
+        }
+        else {
+            this.found.set(problem, [path]);
+        }
+    }
+    get size() {
+        return this.found.size;
+    }
+    /** One failing finding per distinct problem: "{problem} on {pages}." The target is the first page. */
+    findings(checkId) {
+        return [...this.found].map(([problem, paths]) => fail(checkId, paths[0], `${problem} on ${pagesPhrase(paths)}.`));
+    }
+}
+/** The path's last segment, lower case: "/aa-tree/contact" and "/contact" both give "contact"; home gives "". */
+export function lastSegment(path) {
+    const parts = path.split("/").filter(Boolean);
+    return (parts[parts.length - 1] ?? "").toLowerCase();
+}
+export function isContactPath(path) {
+    return ["contact", "contact-us", "get-in-touch"].includes(lastSegment(path));
+}
+/** The contact page: a contact path, or any page that holds the library's contact section. */
+export function isContactPage(page) {
+    return isContactPath(page.path) || descendants(page.root).some((element) => attr(element, "data-bl-section") === "contact");
+}
+export function isThankYouPath(path) {
+    return /^(?:thank-you|thanks|thankyou|enquiry-sent|message-sent)$/.test(lastSegment(path));
+}
+/** The first element below `node` for which `test` holds. */
+export function findElement(node, test) {
+    return descendants(node).find(test);
+}
+export function hookOf(element) {
+    return attr(element, "data-bl");
+}
+/** Elements carrying `data-bl="name"`. */
+export function byHook(root, name) {
+    return descendants(root).filter((element) => attr(element, "data-bl") === name);
+}
+/** The `<main>` element, or the whole document when the page has none. */
+export function mainOf(root) {
+    return descendants(root).find((element) => element.tag === "main") ?? root;
+}
+/** The first `n` items of a list, then "and N more": for messages that name files or images. */
+export function namedList(items, shown = 5) {
+    const head = items.slice(0, shown).join(", ");
+    return items.length > shown ? `${head} and ${items.length - shown} more` : head;
+}
+//# sourceMappingURL=common.js.map

package/dist/site-system/rules/library/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/site-system/rules/library/common.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Helpers the 3.9.0 to 3.11.0 rule modules (library, form, sections) share: the same problem found on many pages is\n * one finding that names a few of them, and a page is found by the last segment of its path so a site mounted below a\n * prefix (the component catalogue) reads like a site mounted at the root.\n */\nimport type { SiteSystemCheckId, SiteSystemFinding } from \"../../checks.js\";\nimport { fail } from \"../enquiry/common.js\";\nimport { attr, descendants, type HtmlElement } from \"../enquiry/html.js\";\n\n/** How many page paths a message names before it says \"and N other pages\". */\nconst NAMED_PAGES = 3;\n\n/** \"/a\", \"/a and /b\", \"/a, /b and /c\", or \"/a, /b, /c and 4 other pages\". */\nexport function pagesPhrase(paths: readonly string[]): string {\n  const unique = [...new Set(paths)];\n  if (unique.length <= NAMED_PAGES) {\n    return unique.length <= 1 ? (unique[0] ?? \"the site\") : `${unique.slice(0, -1).join(\", \")} and ${unique[unique.length - 1]}`;\n  }\n  const rest = unique.length - NAMED_PAGES;\n  return `${unique.slice(0, NAMED_PAGES).join(\", \")} and ${rest} other ${rest === 1 ? \"page\" : \"pages\"}`;\n}\n\n/** Collects `problem` (a clause with no subject) against the pages it was found on. */\nexport class PageProblems {\n  private readonly found = new Map<string, string[]>();\n\n  add(path: string, problem: string): void {\n    const paths = this.found.get(problem);\n    if (paths) {\n      if (!paths.includes(path)) paths.push(path);\n    } else {\n      this.found.set(problem, [path]);\n    }\n  }\n\n  get size(): number {\n    return this.found.size;\n  }\n\n  /** One failing finding per distinct problem: \"{problem} on {pages}.\" The target is the first page. */\n  findings(checkId: SiteSystemCheckId): SiteSystemFinding[] {\n    return [...this.found].map(([problem, paths]) => fail(checkId, paths[0], `${problem} on ${pagesPhrase(paths)}.`));\n  }\n}\n\n/** The path's last segment, lower case: \"/aa-tree/contact\" and \"/contact\" both give \"contact\"; home gives \"\". */\nexport function lastSegment(path: string): string {\n  const parts = path.split(\"/\").filter(Boolean);\n  return (parts[parts.length - 1] ?? \"\").toLowerCase();\n}\n\nexport function isContactPath(path: string): boolean {\n  return [\"contact\", \"contact-us\", \"get-in-touch\"].includes(lastSegment(path));\n}\n\n/** The contact page: a contact path, or any page that holds the library's contact section. */\nexport function isContactPage(page: { readonly path: string; readonly root: HtmlElement }): boolean {\n  return isContactPath(page.path) || descendants(page.root).some((element) => attr(element, \"data-bl-section\") === \"contact\");\n}\n\nexport function isThankYouPath(path: string): boolean {\n  return /^(?:thank-you|thanks|thankyou|enquiry-sent|message-sent)$/.test(lastSegment(path));\n}\n\n/** The first element below `node` for which `test` holds. */\nexport function findElement(node: HtmlElement, test: (element: HtmlElement) => boolean): HtmlElement | undefined {\n  return descendants(node).find(test);\n}\n\nexport function hookOf(element: HtmlElement): string | undefined {\n  return attr(element, \"data-bl\");\n}\n\n/** Elements carrying `data-bl=\"name\"`. */\nexport function byHook(root: HtmlElement, name: string): HtmlElement[] {\n  return descendants(root).filter((element) => attr(element, \"data-bl\") === name);\n}\n\n/** The `<main>` element, or the whole document when the page has none. */\nexport function mainOf(root: HtmlElement): HtmlElement {\n  return descendants(root).find((element) => element.tag === \"main\") ?? root;\n}\n\n/** The first `n` items of a list, then \"and N more\": for messages that name files or images. */\nexport function namedList(items: readonly string[], shown = 5): string {\n  const head = items.slice(0, shown).join(\", \");\n  return items.length > shown ? `${head} and ${items.length - shown} more` : head;\n}\n"]}

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

@@ -0,0 +1,16 @@
+/**
+ * The library rule module (release 3.9.0): K1, shared components in use. It reads the declared tier from
+ * brandlab.config.ts so the enquiry-tier parts (quote form, reviews band, CTA band, footer) are required only where
+ * the tier covers them; a config it cannot read leaves the shell parts, which every tier requires.
+ */
+import type { SiteSystemFinding, SiteSystemTier } from "../../checks.js";
+import { type EnquiryRuleInput } from "../enquiry/common.js";
+export { K1_SHELL_PARTS, checkK1 } from "./k1-shared-components.js";
+export { PageProblems, isContactPath, isThankYouPath, lastSegment, pagesPhrase } from "./common.js";
+export interface LibraryRuleOptions {
+    /** Replaces the tier read from brandlab.config.ts (tests). */
+    readonly tier?: SiteSystemTier;
+}
+/** Runs K1 over the sampled pages. */
+export declare function runLibraryRules(input: EnquiryRuleInput, options?: LibraryRuleOptions): Promise<readonly SiteSystemFinding[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/library/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpG,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;CAChC;AAUD,sCAAsC;AACtC,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAGtI"}

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

@@ -0,0 +1,19 @@
+import { readSiteSystemProjectConfig } from "../../config.js";
+import { parsePages } from "../enquiry/common.js";
+import { checkK1 } from "./k1-shared-components.js";
+export { K1_SHELL_PARTS, checkK1 } from "./k1-shared-components.js";
+export { PageProblems, isContactPath, isThankYouPath, lastSegment, pagesPhrase } from "./common.js";
+function declaredTier(projectRoot) {
+    try {
+        return readSiteSystemProjectConfig(projectRoot).siteSystem?.tier ?? "shell";
+    }
+    catch {
+        return "shell";
+    }
+}
+/** Runs K1 over the sampled pages. */
+export async function runLibraryRules(input, options = {}) {
+    const tier = options.tier ?? declaredTier(input.projectRoot);
+    return checkK1(parsePages(input.pages), tier);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/site-system/rules/library/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAyB,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOpG,SAAS,YAAY,CAAC,WAAmB;IACvC,IAAI,CAAC;QACH,OAAO,2BAA2B,CAAC,WAAW,CAAC,CAAC,UAAU,EAAE,IAAI,IAAI,OAAO,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAuB,EAAE,UAA8B,EAAE;IAC7F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7D,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC","sourcesContent":["/**\n * The library rule module (release 3.9.0): K1, shared components in use. It reads the declared tier from\n * brandlab.config.ts so the enquiry-tier parts (quote form, reviews band, CTA band, footer) are required only where\n * the tier covers them; a config it cannot read leaves the shell parts, which every tier requires.\n */\nimport type { SiteSystemFinding, SiteSystemTier } from \"../../checks.js\";\nimport { readSiteSystemProjectConfig } from \"../../config.js\";\nimport { parsePages, type EnquiryRuleInput } from \"../enquiry/common.js\";\nimport { checkK1 } from \"./k1-shared-components.js\";\n\nexport { K1_SHELL_PARTS, checkK1 } from \"./k1-shared-components.js\";\nexport { PageProblems, isContactPath, isThankYouPath, lastSegment, pagesPhrase } from \"./common.js\";\n\nexport interface LibraryRuleOptions {\n  /** Replaces the tier read from brandlab.config.ts (tests). */\n  readonly tier?: SiteSystemTier;\n}\n\nfunction declaredTier(projectRoot: string): SiteSystemTier {\n  try {\n    return readSiteSystemProjectConfig(projectRoot).siteSystem?.tier ?? \"shell\";\n  } catch {\n    return \"shell\";\n  }\n}\n\n/** Runs K1 over the sampled pages. */\nexport async function runLibraryRules(input: EnquiryRuleInput, options: LibraryRuleOptions = {}): Promise<readonly SiteSystemFinding[]> {\n  const tier = options.tier ?? declaredTier(input.projectRoot);\n  return checkK1(parsePages(input.pages), tier);\n}\n"]}

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

@@ -0,0 +1,29 @@
+/**
+ * K1: shared components in use where the declared tier covers them (Site System v2 §13.2).
+ *
+ * The library components mark their root with `data-bl="<name>"` in the server HTML, so use is read from the rendered
+ * pages. The shell parts (header, drawer, call bar, back-to-top) are all in the server HTML: the call bar and
+ * back-to-top are client islands, but they render hidden and `inert` on the server (`data-state="hidden"`), so a page
+ * that lacks them has not mounted the library's shell. From the enquiry tier the quote form, reviews band, CTA band
+ * and footer must also be the library's wherever the page has such a part. The lint rule catches a literal `tel:`
+ * href in source; this rule is its rendered counterpart: no `tel:` link outside an element with
+ * `data-bl="phone-link"`, so a hand-written call link cannot hide behind a wrapper the lint cannot see through.
+ */
+import type { SiteSystemFinding, SiteSystemTier } from "../../checks.js";
+import { type ParsedPage } from "../enquiry/common.js";
+/** The shell parts every page carries, by the tier that requires them. */
+export declare const K1_SHELL_PARTS: readonly [{
+    readonly hook: "header";
+    readonly name: "header";
+}, {
+    readonly hook: "drawer";
+    readonly name: "mobile drawer";
+}, {
+    readonly hook: "callbar";
+    readonly name: "call bar";
+}, {
+    readonly hook: "back-to-top";
+    readonly name: "back-to-top control";
+}];
+export declare function checkK1(pages: readonly ParsedPage[], tier?: SiteSystemTier): SiteSystemFinding[];
+//# sourceMappingURL=k1-shared-components.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"k1-shared-components.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/library/k1-shared-components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKpF,0EAA0E;AAC1E,eAAO,MAAM,cAAc;;;;;;;;;;;;EAKjB,CAAC;AA8CX,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,GAAE,cAAwB,GAAG,iBAAiB,EAAE,CA8CzG"}