@domandigital/craft 0.21.0 → 0.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/CHARACTER.md +134 -3
  3. package/COPY.md +10 -3
  4. package/PRINCIPLES.md +9 -0
  5. package/README.md +20 -1
  6. package/design-review.schema.json +156 -0
  7. package/dist/{audit-LQ2TDISV.js → audit-CDMZ6JHT.js} +3 -3
  8. package/dist/audit.cjs +258 -10
  9. package/dist/audit.js +258 -10
  10. package/dist/{chunk-6DRBFDWT.js → chunk-D6TAYXOS.js} +1 -1
  11. package/dist/{chunk-G47ZCBD5.js → chunk-IAU4ZAIU.js} +2 -2
  12. package/dist/{chunk-STWH5EYU.js → chunk-ICEG4S56.js} +5 -5
  13. package/dist/{chunk-BYXDX66D.js → chunk-JT2NLOQI.js} +4 -4
  14. package/dist/{chunk-FNB3NP57.js → chunk-KH56TEFK.js} +5 -5
  15. package/dist/{chunk-DE2ZAV4G.js → chunk-MLYHSPF7.js} +166 -3
  16. package/dist/{chunk-ONA73THJ.js → chunk-NV6FKMID.js} +93 -8
  17. package/dist/{chunk-4WAIOZ4W.js → chunk-WTR77PEM.js} +14 -14
  18. package/dist/{chunk-BQ7H23QP.js → chunk-XSKLVEI6.js} +109 -2
  19. package/dist/{cli-YSGPGQ7R.js → cli-223CUNU3.js} +9 -9
  20. package/dist/{cli-XAWJWK7I.js → cli-3QV4FKM4.js} +6 -6
  21. package/dist/{cli-PBCU7Z64.js → cli-4PXDNTZX.js} +4 -4
  22. package/dist/{cli-7QL26YPR.js → cli-6SMNHOCJ.js} +1 -1
  23. package/dist/{cli-5VHX5EJF.js → cli-7PPDBN6N.js} +5 -5
  24. package/dist/{cli-5QI6NIZN.js → cli-CQUORKMC.js} +6 -6
  25. package/dist/{cli-EYHRJJAX.js → cli-FKWJF4V4.js} +8 -5
  26. package/dist/{cli-RHDNHL4U.js → cli-IQ5U76AZ.js} +5 -5
  27. package/dist/cli.js +3 -3
  28. package/dist/index.cjs +261 -10
  29. package/dist/index.d.cts +49 -3
  30. package/dist/index.d.ts +49 -3
  31. package/dist/index.js +260 -10
  32. package/dist/phone.cjs +57 -7
  33. package/dist/phone.d.cts +28 -2
  34. package/dist/phone.d.ts +28 -2
  35. package/dist/phone.js +54 -7
  36. package/dist/{viewports-cli-XYYX4SKV.js → viewports-cli-H6UIUMBC.js} +43 -82
  37. package/package.json +1 -1
  38. package/word-lists.json +11 -2
package/dist/audit.js CHANGED
@@ -193,7 +193,17 @@ var REVIEW_PHRASES = [
193
193
  "by far the most",
194
194
  "hands down the",
195
195
  "arguably the best",
196
- "bar none"
196
+ "bar none",
197
+ // "plain" as a self-description, the way "clear" is: say what the reader gets.
198
+ "plain answer",
199
+ "plain answers",
200
+ "plain recommendation",
201
+ "plain explanation",
202
+ "plain explanations",
203
+ "plain advice",
204
+ "plain guidance",
205
+ "plain-speaking",
206
+ "plain speaking"
197
207
  ];
198
208
  var SALES_TAGLINES = [
199
209
  /\bwhere it (?:really |truly )?(?:counts|matters)(?: most)?\b/i,
@@ -249,6 +259,34 @@ var CLIPPED = [
249
259
  // "Alright Carlo, built you a proper site": the "I" left out
250
260
  /(?<=^|[\n>"“]|[.!?—–-]\s*|,\s+)(?:[Bb]uilt|[Mm]ade|[Pp]ut together|[Kk]nocked up)\s+(?:you|your\s+\w+|the\s+\w+)\s+an?\b/
251
261
  ];
262
+ var PLAIN_FAMILY = [
263
+ /\b(?:plain english|explained plainly|plainly explained)\b/i,
264
+ /\bplainly\b(?!\s+marked\b)/i,
265
+ /\bin\s+plain\s+(?:terms|language|words|speak)\b/i
266
+ ];
267
+ var CONFESSION = [
268
+ // "What this is and is not:", "what we are and aren't"
269
+ /\bwhat\s+(?:this|it|we|our\s+\w+)\s+(?:is|are)\s+and\s+(?:is\s+not|isn['’]t|are\s+not|aren['’]t)\b/i,
270
+ // "What we are not", a label on its own; not "what we are not responsible for"
271
+ /(?<!\band\s)\bwhat\s+we(?:\s+are|['’]re)\s+not\b(?!\s+(?:responsible|liable|able|allowed|sure)\b)/i,
272
+ /\bwhat\s+we\s+(?:don['’]t|do\s+not)\s+do\b/i,
273
+ // "We have not yet built and run", "we haven't yet worked with"
274
+ /\bwe(?:\s+have|['’]ve)\s+not\s+yet\s+(?:built|run|done|worked|delivered|shipped|launched)\b/i,
275
+ /\bwe\s+haven['’]t\s+(?:yet\s+)?(?:built|run|done|worked\s+with|delivered)\b/i,
276
+ /\bwhat\s+we\s+have\s+and\s+(?:haven['’]t|have\s+not)\s+(?:done|built|run)\b/i,
277
+ // "Our clinic experience so far is one practice"
278
+ /\bour\s+(?:[\w-]+\s+){0,3}experience\s+so\s+far\s+(?:is|has\s+been|covers)\b/i,
279
+ /\bso\s+far\s+(?:is|has\s+been)\s+(?:one|a\s+single|just\s+one)\b/i,
280
+ /\bwhere\s+our\s+experience\s+(?:applies|ends|stops|runs\s+out)\b/i,
281
+ /\bwhat\s+we\s+(?:would|['’]d|will|still)\s+need\s+to\s+learn\b/i,
282
+ // "what we would and wouldn't take on", "what we won't take on"
283
+ /\b(?:would|will)\s+and\s+(?:wouldn['’]t|would\s+not|won['’]t|will\s+not)\s+take\s+on\b/i,
284
+ /\bwhat\s+we\s+(?:won['’]t|wouldn['’]t|would\s+not|will\s+not)\s+take\s+on\b/i,
285
+ // "Who we don't work with", "who this is not for", "we're not for everyone"
286
+ /\bwho\s+we\s+(?:don['’]t|do\s+not|won['’]t|will\s+not)\s+(?:work\s+with|serve|help|take\s+on)\b/i,
287
+ /\bwho\s+(?:this|it|we)\s+(?:is|are|['’]re)\s+not\s+for\b|\bwho\s+(?:this|it)\s+isn['’]t\s+for\b/i,
288
+ /\b(?:we|this)\s+(?:are|is|['’]re|['’]s)\s+not\s+(?:for\s+everyone|the\s+right\s+fit\s+for)\b/i
289
+ ];
252
290
  var NEGATION = [
253
291
  // "It's not just a haircut, it's an experience."
254
292
  /\b(?:it['’]?s|it is|this is|this isn['’]t|we['’]re|we are|they['’]re)\s+(?:not|more than)\s+(?:just|only|merely|simply)?\s*[^.!?\n]{1,60}?[,;.—-]\s*(?:it['’]?s|it is|this is|we['’]re|we are|they['’]re)\b/i,
@@ -378,12 +416,25 @@ var COPY_TELLS = [
378
416
  generation: 2,
379
417
  severity: "warn",
380
418
  surface: "copy",
381
- why: "Told to avoid jargon, a model announces that it is avoiding jargon. 'Explained plainly' swaps a synonym and keeps the tell.",
382
- fix: "Use the house replacement, 'properly explained', or drop the claim and let the copy show it.",
383
- detect: phrases([/\b(?:plain english|explained plainly|plainly explained)\b/i], quoted),
419
+ why: "Told to avoid jargon, a model announces that it is avoiding jargon: 'in plain English', 'stated plainly', 'we'll tell you plainly', 'in plain terms'. The founder bans the whole family (20 October 2026); a reader takes it as filler.",
420
+ fix: "Drop the adverb and say the thing: 'Our prices, stated plainly' becomes 'Our prices'. Where the claim matters, the house replacement for 'plain English' is 'properly explained'.",
421
+ detect: phrases(PLAIN_FAMILY, quoted),
384
422
  fixtures: {
385
- flag: [f("content/home.md", "Your options, in plain English.")],
386
- pass: [f("content/home.md", "Your options, properly explained.")]
423
+ flag: [
424
+ f("content/home.md", "Your options, in plain English."),
425
+ // Eunice Ordor's draft lines, Pastel 986559 #12 and #13 (her diagnosis taken, her wording not).
426
+ f("content/clinics.md", "Tell us what's happening and we'll say plainly what we would take on."),
427
+ f("content/pricing.md", "DD's payment terms, plainly stated."),
428
+ f("content/clinics.md", "We explain our findings in plain terms."),
429
+ f("content/clinics.md", "We share findings in plain language.")
430
+ ],
431
+ pass: [
432
+ f("content/home.md", "Your options, properly explained."),
433
+ f("content/pricing.md", "Our payment terms: 30% when you sign, the rest at launch."),
434
+ // The Apache and zlib licence wording, copied into a repo as it is.
435
+ f("LICENSE.txt", "Altered source versions must be plainly marked as such."),
436
+ f("content/menu.md", "Plain or seeded bagels, and plain-language allergen notes.")
437
+ ]
387
438
  }
388
439
  },
389
440
  {
@@ -434,11 +485,11 @@ var COPY_TELLS = [
434
485
  generation: 1,
435
486
  severity: "warn",
436
487
  surface: "copy",
437
- why: "Truly, genuinely, clear, ultimately, 'the single most', 'bar none': normal English once, and a tell when they stack. The house rules keep them for review, never blocking.",
488
+ why: "Truly, genuinely, clear, ultimately, 'a plain recommendation', 'the single most', 'bar none': normal English once, and a tell when they stack. The house rules keep them for review, never blocking.",
438
489
  fix: "Keep the one that lands hardest and cut the rest. 'What is genuinely excellent' reads better as 'what is excellent'.",
439
490
  detect: phrases([new RegExp(`(?:^|\\b)(?:${[...REVIEW_PHRASES].sort((a, b) => b.length - a.length).map((p) => escape(p).replace(/^(\w)/, "\\b$1").replace(/(\w)$/, "$1\\b")).join("|")})`, "i")], quoted),
440
491
  fixtures: {
441
- flag: [f("content/home.md", "We are truly proud of it."), f("content/home.md", "You leave with a clear next step.")],
492
+ flag: [f("content/home.md", "We are truly proud of it."), f("content/home.md", "You leave with a clear next step."), f("content/process.md", "You get a plain recommendation and someone who knows your systems.")],
442
493
  pass: [f("content/home.md", "We have fitted 400 boilers since 2009."), f("content/home.md", "Keep a safe clearance around the meter.")]
443
494
  }
444
495
  },
@@ -519,6 +570,40 @@ var COPY_TELLS = [
519
570
  ]
520
571
  }
521
572
  },
573
+ {
574
+ id: "confession-line",
575
+ name: "Confession line",
576
+ generation: 2,
577
+ severity: "warn",
578
+ surface: "copy",
579
+ why: "'What this is and is not', 'we have not yet built', 'our experience so far is one practice', 'what we would and wouldn't take on': a model scopes a business by confessing its limits. It reads as small print, and it turns a buyer away before they make contact.",
580
+ fix: "Scope by being precise about what is true, and leave the door open: 'Built and run by us for Sensphere, a practice whose clinicians work across several sites.' Keep contractual facts (eligibility, who runs what) and say them as what the buyer gets.",
581
+ detect: phrases(CONFESSION, quoted),
582
+ fixtures: {
583
+ flag: [
584
+ // Each one from the DD site, as Eunice Ordor flagged it (Pastel 986559 #8, #12, #13).
585
+ f("content/clinics.md", "What this is and is not: a practice portal we built and run for one practice."),
586
+ f("content/clinics.md", "We have not yet built and run the digital systems of a practice with several clinicians."),
587
+ f("content/home.md", "Including the client portal we run for Sensphere. Our clinic experience so far is one practice."),
588
+ f("content/clinics.md", "Tell us what's happening and we'll say what we would and wouldn't take on."),
589
+ f("content/clinics.md", "We will say what carries over from this work and what we would need to learn first."),
590
+ f("content/clinics.md", "We will tell you where our experience applies directly and where it is close."),
591
+ f("content/about.md", "What we are not"),
592
+ f("content/about.md", "Who we don't work with: anyone who needs a site this week."),
593
+ f("content/mobile.md", "Mobile is our newest line, so we tell you what we have and haven't done.")
594
+ ],
595
+ pass: [
596
+ f("content/clinics.md", "Built and run by us for Sensphere, a growing practice whose clinicians work remotely."),
597
+ f("content/home.md", "The client portal we run for Sensphere."),
598
+ // Contractual facts, said as they are.
599
+ f("content/pricing.md", "Pay monthly is open to UK residents aged 18 and over, subject to status."),
600
+ f("content/pricing.md", "Your monthly payments do not buy the site; the buy-out price does."),
601
+ f("content/terms.md", "What we are responsible for, and what we are not responsible for, is in clause 4."),
602
+ f("content/insurance.md", "Ask what your policy does and does not cover."),
603
+ f("emails/deposit.md", "We have not yet received your deposit, so the date is still open.")
604
+ ]
605
+ }
606
+ },
522
607
  {
523
608
  id: "hollow-imperative",
524
609
  name: "Hollow imperative",
@@ -1920,6 +2005,69 @@ function eyebrowChipHits(ctx) {
1920
2005
  }
1921
2006
  return hits;
1922
2007
  }
2008
+ var HERO_OPEN = /<(section|header|div|main|article|Section|Container)\b[^>]*?\b(?:class|className|id)\s*=\s*(?:"|'|\{\s*[`"']?)[^"'`>]*?(?<![a-z])hero(?![a-z])[^>]*>/gi;
2009
+ function closeOf(text, tag, from) {
2010
+ const re = new RegExp(`<(/?)${tag}\\b[^>]*?(/?)>`, "g");
2011
+ re.lastIndex = from;
2012
+ let depth = 0;
2013
+ for (let m = re.exec(text); m; m = re.exec(text)) {
2014
+ if (m[2] === "/") continue;
2015
+ depth += m[1] === "/" ? -1 : 1;
2016
+ if (depth === 0) return m.index + m[0].length;
2017
+ if (m.index - from > 8e3) break;
2018
+ }
2019
+ return Math.min(text.length, from + 4e3);
2020
+ }
2021
+ function heroSpans(path, text) {
2022
+ if (/(?:^|[\\/])[\w-]*hero[\w-]*\.(?:astro|tsx|jsx|vue|svelte)$/i.test(path)) return [[0, text.length]];
2023
+ const spans = [];
2024
+ for (const m of text.matchAll(HERO_OPEN)) {
2025
+ const at = m.index ?? 0;
2026
+ if (spans.some(([a, b]) => at >= a && at < b)) continue;
2027
+ spans.push([at, closeOf(text, m[1], at)]);
2028
+ }
2029
+ if (spans.length > 0) return spans;
2030
+ const h1 = text.search(/<h1\b/);
2031
+ if (h1 === -1) return [];
2032
+ const rest = text.slice(h1);
2033
+ const end = rest.search(/<\/(?:section|header)>|<section\b/);
2034
+ return [[h1, h1 + Math.min(end === -1 ? rest.length : end, 1500)]];
2035
+ }
2036
+ var CONTROL = /<(a|button|Button|ButtonLink|LinkButton|Link|Cta|CTA|CallToAction)\b([^>]*)>([\s\S]{0,300}?)<\/\1>/g;
2037
+ var BUTTON_COMPONENT = /^(?:Button|ButtonLink|LinkButton|Cta|CTA|CallToAction)$/;
2038
+ var BUTTON_CLASS = /(?<![a-z])(?:btn|button|cta)(?![a-z])/i;
2039
+ var TOGGLE = /\baria-(?:expanded|controls|haspopup)\b|\btype\s*=\s*["']submit["']/;
2040
+ var NOT_A_LANDING = /(?:^|[\\/])(?:error|global-error|not-found|404|500)\.\w+$|[\\/](?:admin|portal|dashboard|account|\(qa\)|\(app\)|qa)[\\/]/i;
2041
+ function buttonLabel(attrs, inner) {
2042
+ const text = inner.replace(/<[^>]*>/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\s+/g, " ").trim();
2043
+ if (text && !/[{}()=]/.test(text)) return text.slice(0, 40);
2044
+ return attrs.match(/\bhref\s*=\s*["'{`$]*\{?([^"'}`\s]+)/)?.[1] ?? "a button";
2045
+ }
2046
+ function heroCtaPairHits(ctx) {
2047
+ const hits = [];
2048
+ for (const file of ctx.files) {
2049
+ if (file.kind !== "markup" || NOT_A_LANDING.test(file.path)) continue;
2050
+ const text = file.text.replace(/\\"/g, ' "');
2051
+ for (const [start, end] of heroSpans(file.path, text)) {
2052
+ const span = text.slice(start, end).replace(/<(nav|form)\b[\s\S]*?<\/\1>/gi, (s) => " ".repeat(s.length));
2053
+ const buttons = [];
2054
+ for (const m of span.matchAll(CONTROL)) {
2055
+ const [, tag, attrs, inner] = m;
2056
+ if (TOGGLE.test(attrs)) continue;
2057
+ const cls = attrs.match(/\b(?:class|className|variant)\s*=\s*(?:"([^"]*)"|'([^']*)'|\{([^}]*)\})/g)?.join(" ") ?? "";
2058
+ const tw = /\bpx-\d/.test(cls) && /\bpy-\d/.test(cls) && /\b(?:bg-|border\b|border-|rounded)/.test(cls);
2059
+ if (BUTTON_COMPONENT.test(tag) || BUTTON_CLASS.test(cls) || tw || /\brole\s*=\s*["']button["']/.test(attrs)) {
2060
+ buttons.push({ label: buttonLabel(attrs, inner), offset: start + (m.index ?? 0) });
2061
+ }
2062
+ }
2063
+ if (buttons.length >= 2) {
2064
+ const names = buttons.slice(0, 3).map((b) => `"${b.label}"`).join(", ");
2065
+ hits.push({ path: file.path, offset: buttons[1].offset, message: `${buttons.length} buttons side by side in the hero: ${names}` });
2066
+ }
2067
+ }
2068
+ }
2069
+ return hits;
2070
+ }
1923
2071
  function iconTiles(file) {
1924
2072
  return file.classUnits.filter((unit) => {
1925
2073
  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);
@@ -2370,6 +2518,75 @@ const inter = Inter({ subsets: ["latin"] });`),
2370
2518
  <span className="inline-flex rounded-full border px-3 py-1 text-xs">Tag</span>`)]
2371
2519
  }
2372
2520
  },
2521
+ {
2522
+ id: "hero-cta-pair",
2523
+ name: "Two buttons in the hero",
2524
+ generation: 1,
2525
+ severity: "warn",
2526
+ surface: "source",
2527
+ 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.",
2528
+ 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.",
2529
+ detect: heroCtaPairHits,
2530
+ fixtures: {
2531
+ flag: [
2532
+ // Eunice Ordor's #5 and #36 (Pastel 986559): the DD site's own hero and process close.
2533
+ f3(
2534
+ "src/components/Hero.astro",
2535
+ `<section class="hero">
2536
+ <h1>We run the systems behind your website</h1>
2537
+ <a href="/contact" class="btn btn-primary">Get in touch</a>
2538
+ <a href="/work" class="btn btn-ghost">See our work</a>
2539
+ </section>`
2540
+ ),
2541
+ // The null build's hero, verbatim in shape (calibration/null/rmp/pages/05.html).
2542
+ f3(
2543
+ "index.html",
2544
+ `<nav><a class="btn" href="#contact">Quote</a></nav>
2545
+ <section id="hero" class="hero">
2546
+ <h1>Electricians in Uxbridge</h1>
2547
+ <a href="#contact" class="btn btn-primary">Book a Free Quote</a>
2548
+ <a href="tel:+441895555210" class="btn btn-outline">Call 01895 555 210</a>
2549
+ </section>`
2550
+ ),
2551
+ f3(
2552
+ "app/page.tsx",
2553
+ `<section className="relative py-24">
2554
+ <h1 className="text-5xl">Nails in Brackley</h1>
2555
+ <div className="flex gap-4">
2556
+ <Button asChild><a href="/book">Book now</a></Button>
2557
+ <Button variant="outline">View treatments</Button>
2558
+ </div>
2559
+ </section>`
2560
+ )
2561
+ ],
2562
+ pass: [
2563
+ // One button, and the second route as a text link in the sentence.
2564
+ f3(
2565
+ "src/components/Hero.astro",
2566
+ `<section class="hero">
2567
+ <h1>We run the systems behind your website</h1>
2568
+ <p>Tell us what's going on, or <a href="/work">see the work first</a>.</p>
2569
+ <a href="/contact" class="btn btn-primary">Get in touch</a>
2570
+ </section>`
2571
+ ),
2572
+ // A button in the nav and a search form are not the hero's ask.
2573
+ f3(
2574
+ "index.html",
2575
+ `<header class="hero">
2576
+ <nav><a class="btn" href="/book">Book</a></nav>
2577
+ <h1>Barbers in Manchester</h1>
2578
+ <a class="btn" href="/book">Book a cut</a>
2579
+ <form><button class="btn" type="submit">Search</button></form>
2580
+ </header>`
2581
+ ),
2582
+ f3("app/page.tsx", `<section className="py-24">
2583
+ <h1 className="text-5xl">Nails in Brackley</h1>
2584
+ <a className="rounded bg-ink px-5 py-3" href="/book">Book now</a>
2585
+ </section>
2586
+ <section><a className="rounded bg-ink px-5 py-3" href="/prices">Prices</a></section>`)
2587
+ ]
2588
+ }
2589
+ },
2373
2590
  {
2374
2591
  id: "icon-tile-stack",
2375
2592
  name: "Icon in a tinted tile",
@@ -3123,7 +3340,9 @@ var HOUSE = {
3123
3340
  "no-x-badge": { tier: "block", label: 'standalone "No X" badge. Reads as a slapped-on kicker, and worse when reused across pieces' },
3124
3341
  "ai-phrase": { tier: "block", label: "AI tell" },
3125
3342
  "plainer-word": { tier: "block", label: "a plainer word exists. Name the mechanism instead" },
3126
- "plain-english": { tier: "block", label: 'use "properly explained"' },
3343
+ // Widened 2026-10-20 (founder) to bare "plainly" and "in plain terms/language/words";
3344
+ // estate hits read first (DOM-1058), nearly all the stock "stated plainly".
3345
+ "plain-english": { tier: "block", label: 'the plain-English family. Drop the adverb and say the thing, or use "properly explained"' },
3127
3346
  buzzword: { tier: "block", label: "forbidden phrase" },
3128
3347
  "negative-reassurance": { tier: "block", label: "negative reassurance, say what they get" },
3129
3348
  // Evidence of a pasted chat reply, not a matter of style. Moved from review
@@ -3137,6 +3356,8 @@ var HOUSE = {
3137
3356
  "stock-email-line": { tier: "review", label: "stock email line, start with the reason for writing and end with the next step" },
3138
3357
  // New 2026-10-19 (founder): review first, like every new tell, until estate hits are read.
3139
3358
  "matey-register": { tier: "review", label: "matey register, write plain and complete British English" },
3359
+ // New 2026-10-20 (founder, from Eunice Ordor's review): review first, like every new tell.
3360
+ "confession-line": { tier: "review", label: "confession line, scope the work by saying precisely what is true" },
3140
3361
  "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
3141
3362
  "stock-phrase": { tier: "review", label: "stock phrase" },
3142
3363
  "hollow-imperative": { tier: "review", label: "hollow imperative" },
@@ -3362,6 +3583,33 @@ var RENDERED_PATHS = {
3362
3583
  detect: (s) => s.effects.eyebrowChip ? [hit(s, "a small bordered pill sits above the headline")] : [],
3363
3584
  fixtures: { flag: [makeSnapshot({ effects: { eyebrowChip: true } })], pass: [makeSnapshot()] }
3364
3585
  },
3586
+ "hero-cta-pair": {
3587
+ // Version 2 geometry counts buttons and button-styled links per section. A
3588
+ // header painted inside the hero's box adds its own button, which the
3589
+ // source path can tell apart and this one cannot; a ghost button with no
3590
+ // fill or border is not counted, so this path under-reports.
3591
+ detect: (s) => {
3592
+ const first = s.sections[0];
3593
+ const controls = first?.geometry?.controls ?? 0;
3594
+ return first && (first.role ?? first.kind) === "hero" && controls >= 2 ? [hit(s, `${controls} buttons in the hero`, first.label)] : [];
3595
+ },
3596
+ fixtures: {
3597
+ flag: [
3598
+ {
3599
+ ...makeSnapshot(),
3600
+ 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)
3601
+ }
3602
+ ],
3603
+ pass: [
3604
+ makeSnapshot(),
3605
+ // One button, with the second route as a text link: one control.
3606
+ {
3607
+ ...makeSnapshot(),
3608
+ 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)
3609
+ }
3610
+ ]
3611
+ }
3612
+ },
3365
3613
  "icon-tile-grid": {
3366
3614
  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)),
3367
3615
  fixtures: {
@@ -3878,7 +4126,7 @@ var IMAGERY_TELLS = [
3878
4126
  ];
3879
4127
 
3880
4128
  // src/character/check.ts
3881
- var CATALOGUE_VERSION = "2026.10.4";
4129
+ var CATALOGUE_VERSION = "2026.10.5";
3882
4130
  var CATALOGUE = [
3883
4131
  ...[...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map((t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t),
3884
4132
  ...SPECIFICITY_COPY_TELLS,
@@ -4,7 +4,7 @@ import {
4
4
  import {
5
5
  auditSnapshot,
6
6
  fingerprint
7
- } from "./chunk-DE2ZAV4G.js";
7
+ } from "./chunk-MLYHSPF7.js";
8
8
  import {
9
9
  SNAPSHOT_VERSION
10
10
  } from "./chunk-QYBAVU3P.js";
@@ -10,10 +10,10 @@ import {
10
10
  levenshtein,
11
11
  normaliseFamily,
12
12
  parseColour
13
- } from "./chunk-DE2ZAV4G.js";
13
+ } from "./chunk-MLYHSPF7.js";
14
14
  import {
15
15
  TRADE_NOUNS
16
- } from "./chunk-ONA73THJ.js";
16
+ } from "./chunk-NV6FKMID.js";
17
17
 
18
18
  // src/direction/types.ts
19
19
  var DIRECTION_VERSION = 2;
@@ -4,13 +4,13 @@ import {
4
4
  formatDirectionMatches,
5
5
  summariseDirection,
6
6
  validateDirection
7
- } from "./chunk-G47ZCBD5.js";
7
+ } from "./chunk-IAU4ZAIU.js";
8
8
  import {
9
9
  loadNull
10
- } from "./chunk-FNB3NP57.js";
10
+ } from "./chunk-KH56TEFK.js";
11
11
  import {
12
12
  parseFlags
13
- } from "./chunk-4WAIOZ4W.js";
13
+ } from "./chunk-WTR77PEM.js";
14
14
  import {
15
15
  toJson
16
16
  } from "./chunk-QIEDBL4J.js";
@@ -30,7 +30,7 @@ import {
30
30
  rhythmOf,
31
31
  shapeName,
32
32
  temperatureName
33
- } from "./chunk-DE2ZAV4G.js";
33
+ } from "./chunk-MLYHSPF7.js";
34
34
 
35
35
  // src/estate/cli.ts
36
36
  import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -133,7 +133,7 @@ async function snapshotOf(target, cwd) {
133
133
  return snap;
134
134
  }
135
135
  if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL, a snapshot file, nor a site in the register`);
136
- const { snapshotUrl } = await import("./audit-LQ2TDISV.js");
136
+ const { snapshotUrl } = await import("./audit-CDMZ6JHT.js");
137
137
  return snapshotUrl(target);
138
138
  }
139
139
  var line = (distance, sibling, shared) => `${distance.toFixed(2)}${sibling ? " SIBLING" : ""}${shared.length ? ` shares ${shared.join(", ")}` : ""}`;
@@ -1,11 +1,11 @@
1
1
  import {
2
2
  snapshotUrl,
3
3
  snapshotUrls
4
- } from "./chunk-6DRBFDWT.js";
4
+ } from "./chunk-D6TAYXOS.js";
5
5
  import {
6
6
  describeTypicality,
7
7
  loadNull
8
- } from "./chunk-FNB3NP57.js";
8
+ } from "./chunk-KH56TEFK.js";
9
9
  import {
10
10
  SOURCE_FILE,
11
11
  finish,
@@ -14,7 +14,7 @@ import {
14
14
  parseFlags,
15
15
  prepareReport,
16
16
  readPaths
17
- } from "./chunk-4WAIOZ4W.js";
17
+ } from "./chunk-WTR77PEM.js";
18
18
  import {
19
19
  toJson
20
20
  } from "./chunk-QIEDBL4J.js";
@@ -28,7 +28,7 @@ import {
28
28
  rhythmOf,
29
29
  scanSource,
30
30
  typicality
31
- } from "./chunk-DE2ZAV4G.js";
31
+ } from "./chunk-MLYHSPF7.js";
32
32
 
33
33
  // src/audit/cli.ts
34
34
  import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -3,7 +3,7 @@ import {
3
3
  } from "./chunk-OQXTQQAU.js";
4
4
  import {
5
5
  parseFlags
6
- } from "./chunk-4WAIOZ4W.js";
6
+ } from "./chunk-WTR77PEM.js";
7
7
  import {
8
8
  toJson
9
9
  } from "./chunk-QIEDBL4J.js";
@@ -22,10 +22,10 @@ import {
22
22
  hueSwatch,
23
23
  nullPrompt,
24
24
  scanSource
25
- } from "./chunk-DE2ZAV4G.js";
25
+ } from "./chunk-MLYHSPF7.js";
26
26
  import {
27
27
  extractStrings
28
- } from "./chunk-ONA73THJ.js";
28
+ } from "./chunk-NV6FKMID.js";
29
29
 
30
30
  // src/null/cli.ts
31
31
  import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
@@ -120,7 +120,7 @@ async function build(flags, io) {
120
120
  const toShoot = ids.filter((id) => existsSync(join(pages, `${id}.html`)) && !existsSync(join(shots, `${id}.json`)));
121
121
  if (toShoot.length) {
122
122
  io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"}`);
123
- const { snapshotUrls } = await import("./audit-LQ2TDISV.js");
123
+ const { snapshotUrls } = await import("./audit-CDMZ6JHT.js");
124
124
  const results = await snapshotUrls(toShoot.map((id) => pathToFileURL(join(pages, `${id}.html`)).href));
125
125
  results.forEach((r, i) => {
126
126
  const id = toShoot[i];
@@ -241,7 +241,7 @@ async function importPages(flags, io) {
241
241
  const toShoot = pages.filter((p) => !existsSync(join(shots, `${p.id}.json`)));
242
242
  if (toShoot.length) {
243
243
  io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"} from ${flags.builder}`);
244
- const { snapshotUrls } = await import("./audit-LQ2TDISV.js");
244
+ const { snapshotUrls } = await import("./audit-CDMZ6JHT.js");
245
245
  const servers = /* @__PURE__ */ new Map();
246
246
  try {
247
247
  for (const p of toShoot) if (!servers.has(p.root)) servers.set(p.root, await serveDir(p.root));