@domandigital/craft 0.22.0 → 0.23.0

package/dist/{chunk-DE2ZAV4G.js → chunk-3LCBLDAO.js}

@@ -9,7 +9,7 @@ import {
   parseFile,
   sentencesOf,
   specificity
-} from "./chunk-ONA73THJ.js";
+} from "./chunk-KIBDFRHT.js";
 import {
   SNAPSHOT_VERSION
 } from "./chunk-QYBAVU3P.js";
@@ -770,6 +770,69 @@ function eyebrowChipHits(ctx) {
   }
   return hits;
 }
+var HERO_OPEN = /<(section|header|div|main|article|Section|Container)\b[^>]*?\b(?:class|className|id)\s*=\s*(?:"|'|\{\s*[`"']?)[^"'`>]*?(?<![a-z])hero(?![a-z])[^>]*>/gi;
+function closeOf(text, tag, from) {
+  const re = new RegExp(`<(/?)${tag}\\b[^>]*?(/?)>`, "g");
+  re.lastIndex = from;
+  let depth = 0;
+  for (let m = re.exec(text); m; m = re.exec(text)) {
+    if (m[2] === "/") continue;
+    depth += m[1] === "/" ? -1 : 1;
+    if (depth === 0) return m.index + m[0].length;
+    if (m.index - from > 8e3) break;
+  }
+  return Math.min(text.length, from + 4e3);
+}
+function heroSpans(path, text) {
+  if (/(?:^|[\\/])[\w-]*hero[\w-]*\.(?:astro|tsx|jsx|vue|svelte)$/i.test(path)) return [[0, text.length]];
+  const spans = [];
+  for (const m of text.matchAll(HERO_OPEN)) {
+    const at = m.index ?? 0;
+    if (spans.some(([a, b]) => at >= a && at < b)) continue;
+    spans.push([at, closeOf(text, m[1], at)]);
+  }
+  if (spans.length > 0) return spans;
+  const h1 = text.search(/<h1\b/);
+  if (h1 === -1) return [];
+  const rest = text.slice(h1);
+  const end = rest.search(/<\/(?:section|header)>|<section\b/);
+  return [[h1, h1 + Math.min(end === -1 ? rest.length : end, 1500)]];
+}
+var CONTROL = /<(a|button|Button|ButtonLink|LinkButton|Link|Cta|CTA|CallToAction)\b([^>]*)>([\s\S]{0,300}?)<\/\1>/g;
+var BUTTON_COMPONENT = /^(?:Button|ButtonLink|LinkButton|Cta|CTA|CallToAction)$/;
+var BUTTON_CLASS = /(?<![a-z])(?:btn|button|cta)(?![a-z])/i;
+var TOGGLE = /\baria-(?:expanded|controls|haspopup)\b|\btype\s*=\s*["']submit["']/;
+var NOT_A_LANDING = /(?:^|[\\/])(?:error|global-error|not-found|404|500)\.\w+$|[\\/](?:admin|portal|dashboard|account|\(qa\)|\(app\)|qa)[\\/]/i;
+function buttonLabel(attrs, inner) {
+  const text = inner.replace(/<[^>]*>/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\s+/g, " ").trim();
+  if (text && !/[{}()=]/.test(text)) return text.slice(0, 40);
+  return attrs.match(/\bhref\s*=\s*["'{`$]*\{?([^"'}`\s]+)/)?.[1] ?? "a button";
+}
+function heroCtaPairHits(ctx) {
+  const hits = [];
+  for (const file of ctx.files) {
+    if (file.kind !== "markup" || NOT_A_LANDING.test(file.path)) continue;
+    const text = file.text.replace(/\\"/g, ' "');
+    for (const [start, end] of heroSpans(file.path, text)) {
+      const span = text.slice(start, end).replace(/<(nav|form)\b[\s\S]*?<\/\1>/gi, (s) => " ".repeat(s.length));
+      const buttons = [];
+      for (const m of span.matchAll(CONTROL)) {
+        const [, tag, attrs, inner] = m;
+        if (TOGGLE.test(attrs)) continue;
+        const cls = attrs.match(/\b(?:class|className|variant)\s*=\s*(?:"([^"]*)"|'([^']*)'|\{([^}]*)\})/g)?.join(" ") ?? "";
+        const tw = /\bpx-\d/.test(cls) && /\bpy-\d/.test(cls) && /\b(?:bg-|border\b|border-|rounded)/.test(cls);
+        if (BUTTON_COMPONENT.test(tag) || BUTTON_CLASS.test(cls) || tw || /\brole\s*=\s*["']button["']/.test(attrs)) {
+          buttons.push({ label: buttonLabel(attrs, inner), offset: start + (m.index ?? 0) });
+        }
+      }
+      if (buttons.length >= 2) {
+        const names = buttons.slice(0, 3).map((b) => `"${b.label}"`).join(", ");
+        hits.push({ path: file.path, offset: buttons[1].offset, message: `${buttons.length} buttons side by side in the hero: ${names}` });
+      }
+    }
+  }
+  return hits;
+}
 function iconTiles(file) {
   return file.classUnits.filter((unit) => {
     const sized = has(unit, /^size-(?:8|9|10|11|12|14)$/) || (find(unit, /^h-(?:8|9|10|11|12|14)$/) ?? "x").slice(2) === (find(unit, /^w-(?:8|9|10|11|12|14)$/) ?? "y").slice(2);
@@ -1220,6 +1283,75 @@ const inter = Inter({ subsets: ["latin"] });`),
 <span className="inline-flex rounded-full border px-3 py-1 text-xs">Tag</span>`)]
     }
   },
+  {
+    id: "hero-cta-pair",
+    name: "Two buttons in the hero",
+    generation: 1,
+    severity: "warn",
+    surface: "source",
+    why: "A filled button beside an outline or ghost one ('Get a free quote' / 'See our plans') is in 140 of 140 heroes Claude builds for a brief. Two equal asks make the visitor choose before they know anything, and say nobody decided what the page is for.",
+    fix: "Keep one button, the ask the page exists for. Put the second route in the copy as a text link ('or see the work first'), or lower down where it answers a question.",
+    detect: heroCtaPairHits,
+    fixtures: {
+      flag: [
+        // Eunice Ordor's #5 and #36 (Pastel 986559): the DD site's own hero and process close.
+        f(
+          "src/components/Hero.astro",
+          `<section class="hero">
+  <h1>We run the systems behind your website</h1>
+  <a href="/contact" class="btn btn-primary">Get in touch</a>
+  <a href="/work" class="btn btn-ghost">See our work</a>
+</section>`
+        ),
+        // The null build's hero, verbatim in shape (calibration/null/rmp/pages/05.html).
+        f(
+          "index.html",
+          `<nav><a class="btn" href="#contact">Quote</a></nav>
+<section id="hero" class="hero">
+  <h1>Electricians in Uxbridge</h1>
+  <a href="#contact" class="btn btn-primary">Book a Free Quote</a>
+  <a href="tel:+441895555210" class="btn btn-outline">Call 01895 555 210</a>
+</section>`
+        ),
+        f(
+          "app/page.tsx",
+          `<section className="relative py-24">
+  <h1 className="text-5xl">Nails in Brackley</h1>
+  <div className="flex gap-4">
+    <Button asChild><a href="/book">Book now</a></Button>
+    <Button variant="outline">View treatments</Button>
+  </div>
+</section>`
+        )
+      ],
+      pass: [
+        // One button, and the second route as a text link in the sentence.
+        f(
+          "src/components/Hero.astro",
+          `<section class="hero">
+  <h1>We run the systems behind your website</h1>
+  <p>Tell us what's going on, or <a href="/work">see the work first</a>.</p>
+  <a href="/contact" class="btn btn-primary">Get in touch</a>
+</section>`
+        ),
+        // A button in the nav and a search form are not the hero's ask.
+        f(
+          "index.html",
+          `<header class="hero">
+  <nav><a class="btn" href="/book">Book</a></nav>
+  <h1>Barbers in Manchester</h1>
+  <a class="btn" href="/book">Book a cut</a>
+  <form><button class="btn" type="submit">Search</button></form>
+</header>`
+        ),
+        f("app/page.tsx", `<section className="py-24">
+  <h1 className="text-5xl">Nails in Brackley</h1>
+  <a className="rounded bg-ink px-5 py-3" href="/book">Book now</a>
+</section>
+<section><a className="rounded bg-ink px-5 py-3" href="/prices">Prices</a></section>`)
+      ]
+    }
+  },
   {
     id: "icon-tile-stack",
     name: "Icon in a tinted tile",
@@ -2418,7 +2550,9 @@ var HOUSE = {
   "no-x-badge": { tier: "block", label: 'standalone "No X" badge. Reads as a slapped-on kicker, and worse when reused across pieces' },
   "ai-phrase": { tier: "block", label: "AI tell" },
   "plainer-word": { tier: "block", label: "a plainer word exists. Name the mechanism instead" },
-  "plain-english": { tier: "block", label: 'use "properly explained"' },
+  // Widened 2026-10-20 (founder) to bare "plainly" and "in plain terms/language/words";
+  // estate hits read first (DOM-1058), nearly all the stock "stated plainly".
+  "plain-english": { tier: "block", label: 'the plain-English family. Drop the adverb and say the thing, or use "properly explained"' },
   buzzword: { tier: "block", label: "forbidden phrase" },
   "negative-reassurance": { tier: "block", label: "negative reassurance, say what they get" },
   // Evidence of a pasted chat reply, not a matter of style. Moved from review
@@ -2432,6 +2566,13 @@ var HOUSE = {
   "stock-email-line": { tier: "review", label: "stock email line, start with the reason for writing and end with the next step" },
   // New 2026-10-19 (founder): review first, like every new tell, until estate hits are read.
   "matey-register": { tier: "review", label: "matey register, write plain and complete British English" },
+  // New 2026-10-20 (founder, from Eunice Ordor's review): review first, like every new tell.
+  "confession-line": { tier: "review", label: "confession line, scope the work by saying precisely what is true" },
+  // New 2026-10-23 (a 92EL report passed the gate with three): review, because a
+  // genuine disclaimer has the same shape. The gerund pair joined not-just-but.
+  // New 2026-10-23 (founder, from 92EL deliverables): review, since a short slide label is often fine.
+  "parallel-pair": { tier: "review", label: "verbless parallel pair, write the sentence it stands for" },
+  "trailing-contrast": { tier: "review", label: "trailing contrast. Say the positive claim, unless it is a disclaimer the reader needs" },
   "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
   "stock-phrase": { tier: "review", label: "stock phrase" },
   "hollow-imperative": { tier: "review", label: "hollow imperative" },
@@ -2614,6 +2755,33 @@ var RENDERED_PATHS = {
     detect: (s) => s.effects.eyebrowChip ? [hit(s, "a small bordered pill sits above the headline")] : [],
     fixtures: { flag: [makeSnapshot({ effects: { eyebrowChip: true } })], pass: [makeSnapshot()] }
   },
+  "hero-cta-pair": {
+    // Version 2 geometry counts buttons and button-styled links per section. A
+    // header painted inside the hero's box adds its own button, which the
+    // source path can tell apart and this one cannot; a ghost button with no
+    // fill or border is not counted, so this path under-reports.
+    detect: (s) => {
+      const first = s.sections[0];
+      const controls = first?.geometry?.controls ?? 0;
+      return first && (first.role ?? first.kind) === "hero" && controls >= 2 ? [hit(s, `${controls} buttons in the hero`, first.label)] : [];
+    },
+    fixtures: {
+      flag: [
+        {
+          ...makeSnapshot(),
+          sections: makeSnapshot().sections.map((x, i) => i === 0 ? { ...x, role: "hero", geometry: { centredShare: 0.2, mirrorSymmetry: 0.6, whitespaceRatio: 0.6, contentWidthRatio: 0.8, background: "rgb(255, 255, 255)", controls: 2 } } : x)
+        }
+      ],
+      pass: [
+        makeSnapshot(),
+        // One button, with the second route as a text link: one control.
+        {
+          ...makeSnapshot(),
+          sections: makeSnapshot().sections.map((x, i) => i === 0 ? { ...x, role: "hero", geometry: { centredShare: 0.2, mirrorSymmetry: 0.6, whitespaceRatio: 0.6, contentWidthRatio: 0.8, background: "rgb(255, 255, 255)", controls: 1 } } : x)
+        }
+      ]
+    }
+  },
   "icon-tile-grid": {
     detect: (s) => s.sections.filter((x) => x.cards >= 3 && x.iconCards >= 3).map((x) => hit(s, `${x.iconCards} icon cards in a row`, x.label)),
     fixtures: {
@@ -3027,7 +3195,7 @@ var IMAGERY_TELLS = [
 ];
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.10.4";
+var CATALOGUE_VERSION = "2026.10.7";
 var CATALOGUE = [
   ...[...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map((t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t),
   ...SPECIFICITY_COPY_TELLS,

package/dist/{chunk-6PZG4MJS.js → chunk-3LHIKF5L.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-OQXTQQAU.js";
 import {
   parseFlags
-} from "./chunk-OVWVKMPS.js";
+} from "./chunk-KGEJ2TGT.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -22,10 +22,10 @@ import {
   hueSwatch,
   nullPrompt,
   scanSource
-} from "./chunk-DE2ZAV4G.js";
+} from "./chunk-3LCBLDAO.js";
 import {
   extractStrings
-} from "./chunk-ONA73THJ.js";
+} from "./chunk-KIBDFRHT.js";
 
 // src/null/cli.ts
 import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
@@ -120,7 +120,7 @@ async function build(flags, io) {
   const toShoot = ids.filter((id) => existsSync(join(pages, `${id}.html`)) && !existsSync(join(shots, `${id}.json`)));
   if (toShoot.length) {
     io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"}`);
-    const { snapshotUrls } = await import("./audit-LQ2TDISV.js");
+    const { snapshotUrls } = await import("./audit-CRTC7JSF.js");
     const results = await snapshotUrls(toShoot.map((id) => pathToFileURL(join(pages, `${id}.html`)).href));
     results.forEach((r, i) => {
       const id = toShoot[i];
@@ -241,7 +241,7 @@ async function importPages(flags, io) {
   const toShoot = pages.filter((p) => !existsSync(join(shots, `${p.id}.json`)));
   if (toShoot.length) {
     io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"} from ${flags.builder}`);
-    const { snapshotUrls } = await import("./audit-LQ2TDISV.js");
+    const { snapshotUrls } = await import("./audit-CRTC7JSF.js");
     const servers = /* @__PURE__ */ new Map();
     try {
       for (const p of toShoot) if (!servers.has(p.root)) servers.set(p.root, await serveDir(p.root));

package/dist/{chunk-G47ZCBD5.js → chunk-4NON4PVK.js}

@@ -10,10 +10,10 @@ import {
   levenshtein,
   normaliseFamily,
   parseColour
-} from "./chunk-DE2ZAV4G.js";
+} from "./chunk-3LCBLDAO.js";
 import {
   TRADE_NOUNS
-} from "./chunk-ONA73THJ.js";
+} from "./chunk-KIBDFRHT.js";
 
 // src/direction/types.ts
 var DIRECTION_VERSION = 2;

package/dist/{chunk-6DRBFDWT.js → chunk-A7KUKNX6.js}

@@ -4,7 +4,7 @@ import {
 import {
   auditSnapshot,
   fingerprint
-} from "./chunk-DE2ZAV4G.js";
+} from "./chunk-3LCBLDAO.js";
 import {
   SNAPSHOT_VERSION
 } from "./chunk-QYBAVU3P.js";

package/dist/{chunk-OVWVKMPS.js → chunk-KGEJ2TGT.js}

@@ -10,7 +10,7 @@ import {
   holdHouseBlocks,
   houseRule,
   scanSource
-} from "./chunk-DE2ZAV4G.js";
+} from "./chunk-3LCBLDAO.js";
 import {
   compareCompetitor,
   compareFacts,
@@ -21,7 +21,7 @@ import {
   pageCopy,
   protectedFacts,
   visibleText
-} from "./chunk-ONA73THJ.js";
+} from "./chunk-KIBDFRHT.js";
 
 // src/character/config.ts
 var DEFAULT_IGNORE = [".claude", ".agents", ".cursor"];
@@ -622,7 +622,7 @@ async function pageSnapshot(target, cwd) {
     return readSnapshot(JSON.parse(readFileSync(local, "utf8")), target);
   }
   if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL nor a snapshot file`);
-  const { snapshotUrl } = await import("./audit-LQ2TDISV.js");
+  const { snapshotUrl } = await import("./audit-CRTC7JSF.js");
   return snapshotUrl(target);
 }
 async function briefFor(flags, cwd) {
@@ -633,7 +633,7 @@ async function briefFor(flags, cwd) {
     if (typeof brief === "string" && brief.trim()) return brief;
   } else if (flags.direction) throw new Error(`no such file: ${flags.direction}`);
   if (flags.null) {
-    const { loadNull } = await import("./cli-SZ4SZLUN.js");
+    const { loadNull } = await import("./cli-HWGSNSDD.js");
     return loadNull(flags.null, cwd).brief;
   }
   return void 0;
@@ -659,37 +659,37 @@ async function compareWithCompetitor(flags, io) {
 function run(argv, io) {
   const [command, ...rest] = argv;
   if (command === "direction") {
-    return import("./cli-R2HBESHI.js").then((m) => m.runDirection(rest, io));
+    return import("./cli-E2CFVIGZ.js").then((m) => m.runDirection(rest, io));
   }
   if (command === "report" || command === "retrofit") {
-    return import("./cli-T7A3BU5J.js").then((m) => m.runReport(command, rest, io));
+    return import("./cli-TPV2EIIN.js").then((m) => m.runReport(command, rest, io));
   }
   if (command === "register") {
-    return import("./cli-7QL26YPR.js").then((m) => m.runRegister(rest, io));
+    return import("./cli-YRRBBU27.js").then((m) => m.runRegister(rest, io));
   }
   if (command === "estate") {
-    return import("./cli-WZA5IXSR.js").then((m) => m.runEstate(rest, io));
+    return import("./cli-X3RZE4GM.js").then((m) => m.runEstate(rest, io));
   }
   if (command === "null") {
-    return import("./cli-SZ4SZLUN.js").then((m) => m.runNull(rest, io));
+    return import("./cli-HWGSNSDD.js").then((m) => m.runNull(rest, io));
   }
   if (command === "calibrate") {
-    return import("./cli-AM4FLXGM.js").then((m) => m.runCalibrate(rest, io));
+    return import("./cli-ROVZDHVR.js").then((m) => m.runCalibrate(rest, io));
   }
   if (command === "tells" && rest[0] === "harvest") {
-    return import("./cli-SZ4SZLUN.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+    return import("./cli-HWGSNSDD.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
       io.err(`craft: ${error.message}`);
       return 2;
     });
   }
   if (command === "phone-first") {
-    return import("./cli-YNIJOEJK.js").then((m) => m.runPhoneFirst(rest, io));
+    return import("./cli-RHU3MAZY.js").then((m) => m.runPhoneFirst(rest, io));
   }
   if (command === "viewports") {
-    return import("./viewports-cli-F7KJIVZL.js").then((m) => m.runViewports(rest, io));
+    return import("./viewports-cli-EAUVLHFJ.js").then((m) => m.runViewports(rest, io));
   }
   if (command === "snapshot" || command === "audit") {
-    return import("./cli-7DL4BKA7.js").then((m) => m.runAudit(command, rest, io));
+    return import("./cli-IYRJZWMN.js").then((m) => m.runAudit(command, rest, io));
   }
   if (!command || command === "help" || command === "--help" || command === "-h") {
     io.out(HELP);