@domandigital/craft 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @domandigital/craft
 
+## 0.7.0
+
+### Minor Changes
+
+- dbdef56: Signal 2, the counterfactual. `craft null build --brief "..." --out <dir>` asks `claude -p` for about 20 home pages from the brief alone, renders and fingerprints each, and writes `null.json`. `craft audit <url> --null <dir>` scores how typical a page is against them: the share of the model's own pages that sit further out than this one, typical at 0.10 or above, with the choices it shares with most of them. `craft tells harvest <dir>` lists what recurs across null pages and which tell already catches it, so the next generation of tells comes from what the model builds now. `snapshotUrls` in `@domandigital/craft/audit` snapshots several pages through one browser. The rendered reveal check now also reads the text blocks inside a section, so reveals on cards two levels down are no longer read as a still page.
+- f765c69: Signal 3, the estate. `craft estate add <url | snapshot.json> --id <id>` fingerprints a shipped site into `estate.json`; `craft estate compare` lists every pair, or one site against the rest, closest first, and marks siblings: two sites closer together than two pages Claude builds for one brief (0.31, or measured again from `--null`). What a pair shares is named in plain words ("Fraunces headline", "no accent"). `--strict` exits 1 on a sibling. `craft direction propose --estate estate.json` reads the register. The fingerprint no longer takes a small painted patch, such as a floating chat button, for the accent: a painted colour needs a panel's worth of area.
+- f3c3dc0: The character report. `craft report <url | snapshot.json>` reads a site against all three signals and the reason rule (`--repo`, `--null`, `--estate`, `--direction`) and gives a verdict: default, mixed, decided, or unproven when something was not measured. The actions come in retrofit order, one per choice, with every reason that points at it. `craft retrofit` writes them as a Markdown checklist that names the art-direction choice settling each change, shows the decided value, and ends with what to leave alone. `characterReport` and `retrofitPlan` are exported. System font keywords such as `ui-monospace` no longer read as CSS variable names.
+
+### Patch Changes
+
+- 235b558: Export the copy catalogue's word and phrase lists as portable JSON
+  (`wordListsJson()`, checked in at `word-lists.json`), so a non-TypeScript
+  consumer can source from them instead of duplicating them by hand.
+
+  `claude-kit`'s `copy_check.py` hardcoded its own copies of these same lists
+  and had drifted from this package (documented in claude-kit's
+  `house-style/copy-rules.md`, "Note the enforcement gap"). `word-lists.json` is
+  the file that ends the drift: `install/sync-copy-wordlists.sh` on that side
+  copies it in verbatim, the same shape `sync-craft-standard.sh` already uses
+  for `STANDARD.md`.
+
+  No tell's detection or severity changed. Regenerate the checked-in file with
+  `pnpm --filter @domandigital/craft run docs` after editing any list in
+  `tells/copy.ts`.
+
 ## 0.6.0
 
 ### Minor Changes

package/CHARACTER.md

@@ -29,8 +29,8 @@ model defaults move.
 | Signal | Question | Status |
 | --- | --- | --- |
 | 1. Known tells | Does it use a choice on the catalogue below? | **Shipped**: source, copy, and on the rendered page for 18 tells (`craft audit`). |
-| 2. Counterfactual typicality | Would Claude have built this anyway, for this brief? | Planned. About 20 `claude -p` runs per brief; distance from those answers. |
-| 3. Distance from the estate | Does it look like the agency's other sites? | Fingerprint and distance shipped; the estate register is planned. The agency's biggest tell is its clients looking like siblings. |
+| 2. Counterfactual typicality | Would Claude have built this anyway, for this brief? | **Shipped**: `craft null build` generates about 20 pages from the brief; `craft audit --null` scores a page against them. |
+| 3. Distance from the estate | Does it look like the agency's other sites? | **Shipped**: `craft estate add` fingerprints each shipped site into `estate.json`; `craft estate compare` marks siblings. The agency's biggest tell is its clients looking like each other. |
 
 **The reason rule.** Every expressive choice records a `because`, with evidence
 from the client's real world: the shopfront, the van, the trade's own look, the
@@ -43,7 +43,7 @@ adds character rather than only removing tells. It lives in `art-direction.json`
 | --- | --- |
 | 1 | The first wave: indigo, blue-to-purple gradients, Inter, glass, three icon cards. |
 | 2 | What models moved to once the first wave was named: cream grounds and italic serifs, eyebrow chips, bento grids, marquees, intro cinematics. |
-| 3 | Whatever the harvester finds next. |
+| 3 | Whatever `craft tells harvest` finds next in the null models, once a person has read it. |
 
 A report counts findings by generation, so it can say *which* wave a site was
 built in, not only that it has tells.
@@ -185,6 +185,98 @@ against different sets.
 Known limit: a computed font family is the family the stylesheet asked for.
 A face that failed to load is still reported under its name.
 
+## The counterfactual
+
+A list of tells goes stale; the model does not. So signal 2 asks the model
+directly: given this brief and nothing else, what would you build?
+
+```bash
+craft null build --brief "RMP Electrical, electricians based in Uxbridge ..." --out null/rmp
+craft audit https://www.rmp-electrical.co.uk --null null/rmp
+```
+
+`null build` runs `claude -p` about 20 times (`--runs`), from an empty folder
+with no tools, settings, skills or MCP servers, so each page is what the model
+builds from the brief alone. The prompt is recorded in `null.json` and says
+nothing about how the page should look. Each page is rendered, snapshotted and
+fingerprinted like any other. A reply that is a note instead of a page is kept
+as `NN.reply.txt` and generated again. The build is resumable: run the same
+command to fill in anything that failed. `--brief` can come from
+`art-direction.json` with `--direction`.
+
+**Typicality** is a page's mean fingerprint distance to its three nearest null
+pages, ranked against the same measure for every null page against the
+others. A score of 0.40 means 40% of the model's own pages sit further from
+the rest than this one does. A page is typical at 0.10 or above, so a page the
+model built is flagged nine times in ten by construction, and the threshold
+comes from the model's own spread rather than a number picked here. The report
+lists what the page shares with most of the null ("display Inter, 14 of 20"),
+which is where to start changing it.
+
+**The harvest** reads null models the other way round. `craft tells harvest
+calibration/null` lists the choices that recur across the null pages (faces,
+accent families, grounds, button shapes, openings, phrases) and says which
+tell already catches each. The ones nothing catches are the candidates for
+generation 3. A phrase has to turn up across more than one brief, so a trade's
+own words do not count, and navigation labels, form labels and the legal footer
+are left out as page grammar. Nothing is added to the catalogue automatically:
+a candidate becomes a tell with a flag case and a pass case like every other.
+
+Known limits: a user-level `CLAUDE.md` on the machine that builds the null
+still reaches the model. The null is only as current as its build date; rebuild
+it when the model changes.
+
+## The estate
+
+The agency's biggest tell is not on any one site. It is its clients looking
+like each other. `estate.json` holds one fingerprint per shipped site:
+
+```bash
+craft estate add https://www.rmp-electrical.co.uk --id rmp --client "RMP Electrical"
+craft estate compare            # every pair, closest first
+craft estate compare rmp        # one site against the rest
+craft estate compare https://staging.example.test   # a new build before it ships
+```
+
+**Siblings** are two sites closer together than two pages Claude builds for
+the same brief usually are: the median of that distance over the null models,
+0.31 on 2026-09-23 (`--null` measures it again from any null models given).
+If a barber and an electrician look more alike than two drafts of one barber,
+neither look was chosen. The report says what the pair shares in plain words
+("Fraunces headline", "no accent", "pill buttons"), which is where to start
+pulling them apart. A sibling is a warning; `--strict` exits 1 on one, for a
+pipeline that has decided to hold the line.
+
+`craft direction propose --estate estate.json` reads the register too, so a
+proposed accent steers away from one a sibling already uses.
+
+## The character report
+
+`craft report` reads one site against everything above and gives a verdict:
+
+```bash
+craft report https://www.rmp-electrical.co.uk --repo . --null null/rmp --estate ../estate.json
+craft retrofit https://www.rmp-electrical.co.uk --repo . --null null/rmp --estate ../estate.json --out RETROFIT.md
+```
+
+| Verdict | When |
+|---|---|
+| default | Two or more signals raised: three or more design tells, typical of the brief's null, a sibling in the estate, or fewer than five choices decided with a reason. |
+| mixed | One raised. |
+| decided | None raised, and all four measured. |
+| unproven | None raised, but something was not measured. Unverified is never a pass. |
+
+The actions come in the order a retrofit works: decide first, then type,
+colour, shape, effects, motion, how sections look, and copy. Where a tell, the
+null model and a sibling all point at one choice, they are one action with
+three reasons. Sharing a white page or a still one with the null is never
+an action: that would reward strangeness.
+
+`craft retrofit` writes the same as a checklist. Each change names the
+art-direction choice that settles it, and shows the decided value and its
+reason, or says it waits on that decision. It ends with what to leave alone:
+navigation, the order of sections, where the call to action sits.
+
 ## The house copy rules live here
 
 Since catalogue `2026.09.2` the rule lists of claude-kit's
@@ -212,9 +304,10 @@ reason that rule exists.
 The targets, recorded here with the date once each has been run:
 
 - **AI set** (pages generated by `claude -p` from about 20 briefs): 90% or more
-  flagged as typical or tell-heavy. *Not yet run.*
+  flagged as typical or tell-heavy. **First run 2026-09-23: 19 of 20 (95%)**, below.
 - **Human set** (the ten references in claude-kit's `reference-set.md`): zero
-  block hits and low typicality. *Not yet run.*
+  block hits and low typicality. **First run 2026-09-23: zero block hits, none
+  typical**, below.
 - **Estate baseline** (all seven client repos and live URLs): every hit read by
   a person before any rule blocks. **First run 2026-09-23**, below.
 
@@ -240,7 +333,7 @@ blocks; it is for a person to read.
 | `glass-panel` | 9 / · | 45 / · | 13 / · |  | 1 / · |  |  |
 | `hero-then-proof` | 9 / · | 1 / R | · / R |  | 1 / · | 1 / · | 2 / R |
 | `icon-tile-grid` | 1 / R | 9 / · | · / R |  | · / R |  | 1 / R |
-| `reveal-everywhere` | 1 / · | 1 / · |  |  |  |  |  |
+| `reveal-everywhere` | 1 / · | 1 / · |  |  |  | · / R |  |
 | `pill-everything` | 1 / R | 1 / · | 1 / · |  |  |  | 1 / R |
 | `shadcn-dump` |  | 1 / · |  |  |  |  |  |
 | `cream-palette` |  | 3 / · |  |  |  |  | 18 / R |
@@ -258,15 +351,17 @@ What it shows:
 - **The three survey findings reproduce where they can.** Sensphere's violet
   is found in source (18) and on its buttons; MMM's intro, glows and glass are
   in source and its intro and glows on the page; MMM reveals 60% of the
-  sections below its fold on scroll, three of five, one short of the rendered
-  threshold, and its source is over the reveal limit. Rise & Bloom's glass
+  sections below its fold on scroll, all three of them, one short of the
+  four the rendered rule needs, and its source is over the reveal limit. Rise & Bloom's glass
   hero and icon grid could not be checked: that repo is not attached to this
   session.
 - **Every site ships a reflex face.** Twelve of fourteen site-face pairs are
   on one of the two lists. Fraunces sets the headline on DD, HJ Beauty and RMP.
-- **DD and RMP are the closest pair** (fingerprint distance 0.46: Fraunces
-  headlines, pill buttons, a green accent). Chair and Blade is furthest from
-  everything (0.59 to 0.77). This is signal 3's first measurement.
+- **DD and RMP were read as the closest pair** (0.46) on the first run, with
+  a green accent in common. DD's "green" was its floating WhatsApp button,
+  48px square, the only saturated paint on a near-black and white page. The
+  fingerprint now needs a panel's worth of area before a painted colour
+  counts as the accent. The corrected pairs are under *The estate*, below.
 - **DD's violet is its brand.** Its 36 source hits wait for the exception in
   its `art-direction.json`.
 
@@ -280,9 +375,157 @@ False positives found and fixed in this run:
   `cormorantGaramond`) are now read back to the face's name, or every Next.js
   site would have passed the font tells.
 
+- The rendered reveal check read only a section and its direct children.
+  Found through the null models (below): a reveal on the cards two levels
+  down read as a still page. It now reads the text blocks inside a section
+  too, ignoring anything fixed. Re-run the same day: Chair and Blade, which
+  has a `RevealWrapper`, now shows `reveal-everywhere` on the page (six of
+  nine sections below the fold).
+
 Not yet read by a person: the source counts for `icon-tile-stack` (MMM 93)
 and `glass-panel` (MMM 45) look high and are the first to check.
 
+### Signal 2 first read, 2026-09-23
+
+Seven null models, one per estate brief, 20 pages each (140 pages), built
+with `craft null build` from the briefs in `calibration/briefs.json`. Eight
+replies were notes instead of pages and were generated again (kept as
+`*.reply.txt`). Everything is in `calibration/null/`; `score.mjs` reproduces
+the numbers and writes `results.json`.
+
+**AI set.** Twenty briefs the null never saw (a dentist, a bakery, a
+landscaper and so on), one page each, scored against all 140 null pages.
+Flagged means typical (0.10 or above) or tell-heavy (three or more distinct
+design tells), a rule fixed before any result was read.
+
+| | Pages | Share |
+|---|---|---|
+| Flagged | 19 of 20 | 95% (target 90%) |
+| Typical on its own | 13 of 20 | 65% |
+| Tell-heavy on its own | 16 of 20 | 80% |
+
+The one miss is the landscaper: dark forest green on a cream ground,
+Cormorant Garamond over Karla, square buttons. Two tells (`cream-palette`,
+`reflex-font-2`), one short of tell-heavy, and a score of 0.01 against the
+pooled null because no estate brief is a garden business. Neither signal alone reaches the
+target; together they do, which is the reason for having more than one.
+
+**The model's look depends on the brief.** Each brief's null pages scored
+against the other six briefs' pages are typical only 2 to 13 times in 20.
+A barber and an electrician get different pages. So a site is scored against
+the null built from its own brief, and pooling briefs is a weaker test.
+
+**The estate against its own brief's null.** Score, then what it shares with
+most of the null.
+
+| Site | Score | Typical | Shares with the null |
+|---|---|---|---|
+| DD | 0.15 | yes | pill buttons (19 of 20), Fraunces headline (13 of 20) |
+| Harrison James | 0.10 | yes, at the line | Inter body (18 of 20), yellow accent (16 of 20), white ground |
+| MMM | 0.05 | no | white ground, radial glow (13 of 20), Cormorant Garamond (9 of 20) |
+| HJ Beauty | 0.05 | no | white ground, Fraunces (5 of 20), marquee (5 of 20) |
+| Chair and Blade | 0.05 | no | square buttons (18 of 20), Bebas Neue (9 of 20), dark ground |
+| RMP | 0.05 | no | eyebrow chip (14 of 20), Manrope body |
+| Sensphere | 0.00 | no | radial glow (10 of 20), Inter body |
+
+Read with care: "not typical" says the site is not what Claude builds from
+the brief today. It does not say the site was decided. Sensphere scores 0.00
+and still carries five catalogue tells on the page, violet among them: Claude
+no longer builds that look for this brief, but it is still a known tell. That
+is what signal 1 is for. DD and Harrison James are the
+two a model would most nearly have built unprompted.
+
+**The harvest** (`calibration/null/harvest.txt`). No face outside the two
+reflex lists is chosen by a quarter of the null pages, so the font lists still
+cover what the model picks today: Inter 69 of 140, Fraunces 51, Poppins 36.
+The catalogue tells the model still produces most: `reflex-font-2` 103 of
+140, `glass-panel` 100, `reflex-font` 94, `cream-palette` 81,
+`pill-everything` 79. Candidates nothing catches yet, for a person to read:
+
+- A coral or terracotta accent (around `#e77a63`): 66 of 140, five briefs.
+- Phrases across five or more briefs: "done properly" (33 pages, six briefs),
+  "exactly what" (27, all seven), "who actually" (24, five), "within one
+  working day" (32, five), "rather than" (27, six).
+- The opening "hero > hero > cards" (54 of 140) is how the section reader
+  splits a nav band from the hero, not a model habit. Not a candidate.
+
+`glass-panel` at 100 of 140 includes source hits on blurred sticky navs, the
+same false positive fixed on the rendered path. The source rule needs the same
+fix before that count means anything.
+
+### Signal 3 first read, 2026-09-23
+
+`craft estate add` on the seven live snapshots, then `craft estate compare
+--null calibration/null/*` (the line measured again: 0.31). Register and output
+in `calibration/estate/`.
+
+| Pair | Distance | Shares |
+|---|---|---|
+| DD + HJ Beauty | **0.28, siblings** | no accent, Fraunces headline, no reveals |
+| DD + RMP | 0.49 | Fraunces headline, grey ground, pill buttons |
+| Harrison James + Sensphere | 0.50 | white ground, square buttons, no reveals |
+| HJ Beauty + RMP | 0.56 | Fraunces headline |
+| Chair and Blade + anything | 0.60 to 0.86 | at most a marquee (with HJ Beauty) |
+
+One sibling pair in twenty-one, and it is the agency's own site with one of
+its clients: the same Fraunces headline over a near-black and white page with
+no colour of its own. Fraunces sets the headline on three of the seven. Chair
+and Blade shares nothing with anyone but a marquee. Not yet read by a person.
+
+### Human set, 2026-09-23
+
+The references in claude-kit's `reference-set.md`, live home pages, scored as
+the AI set is: typicality against all seven null models pooled, and the
+design tells on the rendered page. The tenth reference is "any
+generated-looking site" and is left out by definition. Snapshots and
+`score.mjs` in `calibration/human/`.
+
+| Site | Score | Tells on the page | Flagged |
+|---|---|---|---|
+| Linear | 0.00 | 7: violet, grid, icon grid, marquee, glow, Inter, hairline shadow | tell-heavy |
+| Stripe | 0.00 | 5: violet, blue-to-purple, glass, icon grid, glow | tell-heavy |
+| DD | 0.00 | 4: icon grid, pills, glow, Fraunces | tell-heavy |
+| animations.dev | 0.00 | 2: marquee, Inter | no |
+| Utopia | 0.00 | 2: hero then proof, pills | no |
+| APCA (Myndex) | 0.00 | 0 | no |
+| rauno.me | 0.01 | 0 | no |
+| StarrLuxury | 0.01 | not measured: a preview gate, not the site | |
+| candy-aesthetics | 0.05 | not measured: "This preview has ended" | |
+
+- **Zero block hits and none typical**: both targets met. Every score is 0.05
+  or under.
+- **Three of the seven measured are tell-heavy.** Linear and Stripe are where
+  the first-wave look came from: the indigo, the glow, the gradient were
+  theirs before they were every model's. The tell list describes them too,
+  which is the reason no single signal decides the verdict.
+- **The comparison is not like for like.** The null models are small-business
+  briefs; these are software and portfolio sites, so a low score is easier to
+  reach. A human set of small-business sites nobody generated is the better
+  test and is still to find.
+- Both house demos had expired or gated previews on the day. They are not
+  measured, not clean.
+
+### Character report first read, 2026-09-23
+
+`craft report` on each live snapshot with its repo, its own brief's null and
+the register. Reports and retrofit plans are in `calibration/report/`.
+
+| Site | Verdict | Raised | Actions |
+|---|---|---|---|
+| DD | default | tells (12), typical (0.15), sibling of HJ Beauty | 26 |
+| HJ Beauty | default | tells (6), sibling of DD | 18 |
+| MMM | mixed | tells (18) | 27 |
+| Sensphere | mixed | tells (9) | 18 |
+| Chair and Blade | mixed | tells (7) | 11 |
+| RMP | mixed | tells (8) | 18 |
+| Harrison James | mixed | typical (0.10) | 9 |
+
+No site has an `art-direction.json`, so the reasons are not measured on any of
+them and none can be *decided* yet. The first change after deciding is the
+same on all seven: the display face. It is the estate's common default, and
+the one choice the retrofits (phase G) should settle first. Not yet read by a
+person.
+
 ## The catalogue
 
 Generated from the package. Run `pnpm --filter @domandigital/craft run docs`

package/dist/audit-YNODYB3U.js

@@ -0,0 +1,20 @@
+import {
+  audit,
+  collectInPage,
+  loadPlaywright,
+  overlayInPage,
+  snapshotPage,
+  snapshotUrl,
+  snapshotUrls
+} from "./chunk-OA7SGPN4.js";
+import "./chunk-Q54JSNC5.js";
+import "./chunk-3AP4PJMX.js";
+export {
+  audit,
+  collectInPage,
+  loadPlaywright,
+  overlayInPage,
+  snapshotPage,
+  snapshotUrl,
+  snapshotUrls
+};

package/dist/audit.cjs

@@ -25,7 +25,8 @@ __export(audit_exports, {
   loadPlaywright: () => loadPlaywright,
   overlayInPage: () => overlayInPage,
   snapshotPage: () => snapshotPage,
-  snapshotUrl: () => snapshotUrl
+  snapshotUrl: () => snapshotUrl,
+  snapshotUrls: () => snapshotUrls
 });
 module.exports = __toCommonJS(audit_exports);
 
@@ -1208,7 +1209,7 @@ const inter = Inter({ subsets: ["latin"] });`),
     severity: "warn",
     surface: "source",
     why: "Ban Inter and a model reaches for Inter Tight, DM Sans, Manrope, Space Grotesk or an Instrument/Fraunces serif. A swap inside the reflex list is not a decision.",
-    fix: "Same as reflex-font. If this face really is the right one, declare an exception with the reason and the evidence.",
+    fix: "Pick the display face from the client's world (signage, packaging, the trade's lettering) and record why in art-direction.json. If this face really is the right one, declare an exception with the reason and the evidence.",
     detect: fontTell(REFLEX_FONTS_2),
     fixtures: {
       flag: [f2("src/styles.css", `@theme {
@@ -1640,15 +1641,16 @@ function makeSnapshot(patch = {}) {
 }
 
 // src/snapshot/fonts.ts
+var SYSTEM = /^(?:system-ui|-apple-system|BlinkMacSystemFont|ui-sans-serif|ui-serif|ui-monospace|ui-rounded|sans-serif|serif|monospace|cursive)$/i;
 function normaliseFamily(raw) {
   let name = raw.replace(/["']/g, "").trim();
   const next = name.match(/^__(.+?)(?:_Fallback)?_[0-9a-f]{5,8}$/i);
   if (next) name = next[1].replace(/_/g, " ");
   name = name.replace(/\s+Fallback$/i, "").replace(/\s+Variable$/i, "");
+  if (SYSTEM.test(name)) return "system-ui";
   if (!/\s/.test(name) && (/[a-z][A-Z]/.test(name) || /^[a-z]+(?:-[a-z]+)+$/.test(name))) {
     name = name.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/-/g, " ").replace(/\b([a-z])/g, (c) => c.toUpperCase()).replace(/\bDm\b/, "DM");
   }
-  if (/^(?:system-ui|-apple-system|BlinkMacSystemFont|ui-sans-serif|ui-serif|ui-monospace|sans-serif|serif|monospace)$/i.test(name)) return "system-ui";
   return name;
 }
 var KNOWN = {
@@ -2000,6 +2002,7 @@ function auditSnapshot(snapshot, options = {}) {
 // src/fingerprint/index.ts
 var FINGERPRINT_VERSION = 1;
 var CHROMATIC = 0.03;
+var MIN_ACCENT_AREA = 2e4;
 var oklch = (value) => {
   const parsed = parseColour(value);
   return parsed && parsed.alpha > 0.5 ? parsed.oklch : null;
@@ -2012,7 +2015,7 @@ function accentOf(s) {
   }
   const topButton = [...buttons].sort((a, b) => b[1] - a[1])[0];
   if (topButton) return oklch(topButton[0]);
-  const bg = s.colours.backgrounds.map((b) => ({ o: oklch(b.value), w: b.area })).filter((x) => x.o && x.o.c >= CHROMATIC).sort((a, b) => b.w - a.w)[0];
+  const bg = s.colours.backgrounds.map((b) => ({ o: oklch(b.value), w: b.area })).filter((x) => x.o && x.o.c >= CHROMATIC && x.w >= MIN_ACCENT_AREA).sort((a, b) => b.w - a.w)[0];
   if (bg) return bg.o;
   const text = s.colours.text.map((t) => ({ o: oklch(t.value), w: t.chars })).filter((x) => x.o && x.o.c >= CHROMATIC).sort((a, b) => b.w - a.w)[0];
   return text ? text.o : null;
@@ -2207,13 +2210,18 @@ function collectInPage() {
   pushBlocks(root, 0);
   const header = document.querySelector("body > header, header");
   const h1 = document.querySelector("h1");
+  const waiting = (c) => {
+    const cs = style(c);
+    const op = parseFloat(cs.opacity);
+    return op < 0.1 || op < 1 && cs.transform !== "none" || c.hasAttribute("data-aos") || /\breveal\b|\bfade-?(?:in|up)\b|\banimate-on-scroll\b/i.test(typeof c.className === "string" ? c.className : "");
+  };
   const hiddenAtLoad = (el) => {
-    const check = [el, ...Array.from(el.children).slice(0, 6)];
-    return check.some((c) => {
-      const cs = style(c);
-      const op = parseFloat(cs.opacity);
-      return op < 0.1 || op < 1 && cs.transform !== "none" || c.hasAttribute("data-aos") || /\breveal\b|\bfade-?(?:in|up)\b|\banimate-on-scroll\b/i.test(typeof c.className === "string" ? c.className : "");
-    });
+    if ([el, ...Array.from(el.children).slice(0, 6)].some(waiting)) return true;
+    const blocks2 = Array.from(el.querySelectorAll("div, article, li, figure, p, h2, h3")).slice(0, 200).filter((d) => {
+      const b = box(d);
+      return b.width > 100 && b.height > 40 && (d.textContent ?? "").trim().length > 12 && style(d).position !== "fixed";
+    }).slice(0, 12);
+    return blocks2.filter(waiting).length >= Math.min(2, blocks2.length) && blocks2.some(waiting);
   };
   const cardsIn = (section) => {
     let best = { cards: 0, iconCards: 0 };
@@ -2412,19 +2420,38 @@ async function snapshotPage(page, url, options = {}) {
     motion: { ...data.motion, introOverlay: early && !late }
   };
 }
-async function snapshotUrl(url, options = {}) {
-  const pw = await loadPlaywright();
+async function launch(pw, url, options) {
   const env = globalThis.process?.env ?? {};
   const executablePath = options.executablePath ?? env.CRAFT_CHROMIUM ?? void 0;
   const host = new URL(url).hostname;
   const noProxy = [`localhost`, `127.0.0.1`, `::1`, ...(env.NO_PROXY ?? env.no_proxy ?? "").split(",")].map((h) => h.trim().replace(/^\*?\./, "")).filter(Boolean);
   const direct = /^(?:localhost|127\.|\[?::1\]?$)/.test(host) || noProxy.some((h) => host === h || host.endsWith(`.${h}`));
   const proxy = direct ? void 0 : env.HTTPS_PROXY ?? env.https_proxy;
-  const browser = await pw.chromium.launch({ headless: true, ...executablePath ? { executablePath } : {}, ...proxy ? { proxy: { server: proxy } } : {} });
+  return pw.chromium.launch({ headless: true, ...executablePath ? { executablePath } : {}, ...proxy ? { proxy: { server: proxy } } : {} });
+}
+async function snapshotUrl(url, options = {}) {
+  const [result] = await snapshotUrls([url], options);
+  if (!result.snapshot) throw new Error(result.error);
+  return result.snapshot;
+}
+async function snapshotUrls(urls, options = {}) {
+  if (urls.length === 0) return [];
+  const pw = await loadPlaywright();
+  const browser = await launch(pw, urls[0], options);
+  const out = [];
   try {
-    const page = await browser.newPage({ viewport: options.viewport ?? { width: 1440, height: 900 } });
-    await page.goto(url, { waitUntil: "domcontentloaded", timeout: options.timeoutMs ?? 45e3 });
-    return await snapshotPage(page, url, options);
+    for (const url of urls) {
+      const page = await browser.newPage({ viewport: options.viewport ?? { width: 1440, height: 900 } });
+      try {
+        await page.goto(url, { waitUntil: "domcontentloaded", timeout: options.timeoutMs ?? 45e3 });
+        out.push({ url, snapshot: await snapshotPage(page, url, options) });
+      } catch (error) {
+        out.push({ url, error: error.message });
+      } finally {
+        await page.close?.();
+      }
+    }
+    return out;
   } finally {
     await browser.close();
   }
@@ -2440,5 +2467,6 @@ async function audit(url, options = {}) {
   loadPlaywright,
   overlayInPage,
   snapshotPage,
-  snapshotUrl
+  snapshotUrl,
+  snapshotUrls
 });

package/dist/audit.d.cts

@@ -329,6 +329,7 @@ interface SnapshotOptions {
     timeoutMs?: number;
 }
 interface MinimalPage {
+    close?(): Promise<void>;
     goto(url: string, options?: {
         waitUntil?: string;
         timeout?: number;
@@ -365,6 +366,18 @@ declare function loadPlaywright(): Promise<Launcher>;
 declare function snapshotPage(page: MinimalPage, url: string, options?: SnapshotOptions): Promise<Snapshot>;
 /** Launch a browser, open `url`, and capture a snapshot. */
 declare function snapshotUrl(url: string, options?: SnapshotOptions): Promise<Snapshot>;
+interface SnapshotResult {
+    url: string;
+    snapshot?: Snapshot;
+    /** Why this page has no snapshot. The others are still taken. */
+    error?: string;
+}
+/**
+ * Several pages through one browser, in order. A null model is twenty pages;
+ * launching Chromium twenty times is most of the wait. One page that will not
+ * load costs that page, not the batch.
+ */
+declare function snapshotUrls(urls: string[], options?: SnapshotOptions): Promise<SnapshotResult[]>;
 interface AuditResult {
     snapshot: Snapshot;
     report: CheckReport;
@@ -373,4 +386,4 @@ interface AuditResult {
 /** Snapshot a URL, judge it against the rendered tells, and fingerprint it. */
 declare function audit(url: string, options?: SnapshotOptions & CheckOptions): Promise<AuditResult>;
 
-export { type AuditResult, type SnapshotOptions, audit, collectInPage, loadPlaywright, overlayInPage, snapshotPage, snapshotUrl };
+export { type AuditResult, type SnapshotOptions, type SnapshotResult, audit, collectInPage, loadPlaywright, overlayInPage, snapshotPage, snapshotUrl, snapshotUrls };

package/dist/audit.d.ts

@@ -329,6 +329,7 @@ interface SnapshotOptions {
     timeoutMs?: number;
 }
 interface MinimalPage {
+    close?(): Promise<void>;
     goto(url: string, options?: {
         waitUntil?: string;
         timeout?: number;
@@ -365,6 +366,18 @@ declare function loadPlaywright(): Promise<Launcher>;
 declare function snapshotPage(page: MinimalPage, url: string, options?: SnapshotOptions): Promise<Snapshot>;
 /** Launch a browser, open `url`, and capture a snapshot. */
 declare function snapshotUrl(url: string, options?: SnapshotOptions): Promise<Snapshot>;
+interface SnapshotResult {
+    url: string;
+    snapshot?: Snapshot;
+    /** Why this page has no snapshot. The others are still taken. */
+    error?: string;
+}
+/**
+ * Several pages through one browser, in order. A null model is twenty pages;
+ * launching Chromium twenty times is most of the wait. One page that will not
+ * load costs that page, not the batch.
+ */
+declare function snapshotUrls(urls: string[], options?: SnapshotOptions): Promise<SnapshotResult[]>;
 interface AuditResult {
     snapshot: Snapshot;
     report: CheckReport;
@@ -373,4 +386,4 @@ interface AuditResult {
 /** Snapshot a URL, judge it against the rendered tells, and fingerprint it. */
 declare function audit(url: string, options?: SnapshotOptions & CheckOptions): Promise<AuditResult>;
 
-export { type AuditResult, type SnapshotOptions, audit, collectInPage, loadPlaywright, overlayInPage, snapshotPage, snapshotUrl };
+export { type AuditResult, type SnapshotOptions, type SnapshotResult, audit, collectInPage, loadPlaywright, overlayInPage, snapshotPage, snapshotUrl, snapshotUrls };