@domandigital/craft 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @domandigital/craft
 
+## 0.12.0
+
+### Minor Changes
+
+- 7622bd9: Phase K: snapshot version 2.
+
+  - Every section gains a `role`: `cta-band`, `footer-cta`, `pricing`, `testimonials`, `faq`, `process`, `features`, `team`, `contact`, or its `kind`. `kind` keeps its version 1 meaning, so the rendered tells and the calibrated null models and estate read exactly as before.
+  - Every section gains `geometry`: `centredShare`, `mirrorSymmetry`, `whitespaceRatio`, `contentWidthRatio`, `background` and `controls`. The page gains `rhythmVariance` (how much section heights vary).
+  - `visual`: colourfulness (Hasler and Süsstrunk), edge density and left-right symmetry, from a screenshot of the first 6000px. None of them passes or fails anything. `snapshotUrl(url, { visual: false })` skips the screenshot; a driver without `page.screenshot` gets no `visual`.
+  - `SNAPSHOT_VERSION` is 2. `readSnapshot()` reads version 1 files as version 2 marked `migratedFrom: 1`; every command that loads a saved snapshot uses it, so old snapshots still work.
+  - `FINGERPRINT_VERSION` is 2: fingerprints carry `sections` (role, centring, width), and `layoutDistance` compares by role and geometry when both sides have them. Against a version 1 fingerprint it compares by `kind`, exactly as before.
+  - New exports: `readSnapshot`, `READABLE_SNAPSHOT_VERSIONS`, `visualMeasures`, `EDGE_STEP`, `layoutDistance`, and the types `SectionRole`, `SectionGeometry`, `SnapshotVisual`, `FingerprintSection`, `RgbaImage`.
+
+- 07d1cf5: From the 2026-09-11 AI-look research. A new tell, `shadcn-card-stock`: the registry Card recipe left unchanged (`warn`). Cal Sans joins the second-wave reflex fonts. The icon-tile tells now see Unicons, MUI icons and Material Symbols as well as Lucide, Heroicons, Phosphor and Tabler. `craft direction validate` warns when a display or body face is missing from the new licence register, or is capped, per-site or unverified there. The register ships as `licences.json` and as `LICENCES` and `faceLicence()`. Catalogue `2026.09.9`.
+- c63cded: **Behaviour change:** under `craft copy --gate`, a repo can no longer lower the house blocking tier. A `warn` or `off` in `craft.config.json`, or an `art-direction.json` exception, naming a blocking tell (em dash, contrastive negation, chatbot residue and the rest) is refused and listed as "Exception not applied". Raising a tell still works, runs without `--gate` are unchanged, and a genuine one-off still takes `copy-ok` on its line. `holdHouseBlocks` and `HOUSE_LOCKED` are exported from the house policy.
+
+## 0.11.0
+
+### Minor Changes
+
+- e2ea0e8: Phase I: craft in CI.
+
+  - `craft.config.json`: `ignore` globs, `copyPaths` (where `craft copy` looks when given no path), and `severity` changes per tell. Every severity change needs a `because` of at least a sentence; `off` is applied as an exception, so the report still lists what it silenced. `--config <file>` points elsewhere.
+  - `.claude`, `.agents` and `.cursor` are never walked (a path named on the command line is still read).
+  - `--baseline <file>` reports only findings the baseline does not hold; `--update-baseline` writes it. Findings are keyed on tell, path and excerpt, not line, and counted.
+  - `--sarif <file>` writes SARIF 2.1.0 for GitHub code scanning.
+  - Every `--json` output carries `schemaVersion: 1`. The audit JSON adds `pages` and `failed`.
+  - `craft audit --pages <sitemap.xml | urls.txt>` and `--viewport 390,768,1440`. A page that will not load is listed as not measured and fails `--strict`.
+  - **Behaviour change:** a page that answers with an HTTP error (404, 500) is no longer snapshotted as if it were the page. `snapshotUrls` reports it as an error and `snapshotUrl` throws `HTTP <status>`. Before, a missing page was measured, and reported clean.
+  - New exports: `createBaseline`, `applyBaseline`, `parseBaseline`, `findingKey`, `parseCraftConfig`, `applySeverity`, `severityExceptions`, `globToRegExp`, `ignoreMatcher`, `DEFAULT_IGNORE`, `toSarif`, `toJson`, `JSON_SCHEMA_VERSION`.
+
+- 3eb1560: CommonJS consumers now get the CommonJS type declarations. The `exports` map put a top-level `types` (the ESM `.d.ts`) ahead of `require`, so TypeScript resolving a `require` under `node16` stopped at the ESM file ("Masquerading as ESM" in @arethetypeswrong/cli). `types` now sits inside `import` and `require` separately. Runtime behaviour is unchanged.
+
+  Requires Node 22.12 or later (`engines.node`). Node 20 reached end of life on 2026-04-30. Also declares `sideEffects` so bundlers can tree-shake (craft keeps its CSS).
+
 ## 0.10.0
 
 ### Minor Changes

package/CHARACTER.md

@@ -88,6 +88,13 @@ clean, premium, elegant and the rest), and a value on the tell catalogue
 without an exception carrying the same reason. Given a snapshot, it warns
 where the page does not show what the file declares.
 
+It also reads the display and body faces against the licence register
+(`src/direction/licences.ts`, exported as `licences.json`) and warns on a face
+the register does not know, or knows only as capped, per-site or unverified. A
+licence warning does not undecide the choice: the reason can be sound and the
+face still unlicensed for this client. The register records facts, checked on
+the licensor's own page. It is not a shortlist, and nothing proposes from it.
+
 `craft direction init` writes what the site does today with every reason
 empty, so the first thing it produces is the list of things nobody decided.
 Run on RMP's live home page (2026-09-23) it records Fraunces, Manrope, a cream
@@ -534,7 +541,7 @@ Generated from the package. Run `pnpm --filter @domandigital/craft run docs`
 after changing an entry; a test fails until you do.
 
 <!-- craft:catalogue:start -->
-Catalogue version `2026.09.8`, 55 tells.
+Catalogue version `2026.09.9`, 56 tells.
 
 | Id | Gen | Surface | Severity | Tell | Why it is a default |
 | --- | --- | --- | --- | --- | --- |
@@ -549,6 +556,7 @@ Catalogue version `2026.09.8`, 55 tells.
 | `reveal-everywhere` | 1 | source + rendered | warn | Reveal on every section | When every block fades up on scroll, the motion stops meaning anything and the page feels slow. MMM had 70, DD 40, sen-sphere 27. |
 | `pill-everything` | 1 | source + rendered | warn | Pills everywhere | rounded-full on every button, badge and tag is the framework's friendliest default. MMM had 162, DD 125. A shape used everywhere is not a shape language. |
 | `shadcn-dump` | 1 | source | warn | Stock component dump | A generator exports the whole shadcn/ui kit whether the site uses it or not. Rise & Bloom ships a full set under its own book, vine and petal assets. |
+| `shadcn-card-stock` | 1 | source | warn | Stock shadcn Card | The registry Card (bg-card, a plain border, rounded-lg or rounded-xl, shadow-sm) is the container every generated page is built from. Left as shipped, every card on the site looks like every other shadcn site's. |
 | `cream-palette` | 2 | source + rendered | warn | Cream ground | Once white-and-violet was named, models moved to a warm off-white: parchment, linen, oat. It reads as 'tasteful' in the same way everywhere. |
 | `italic-serif-display` | 2 | source + rendered | warn | Italic serif display | A serif heading with one italic word ('Beauty, reimagined') is the second wave's signature move. |
 | `hero-eyebrow-chip` | 2 | source + rendered | warn | Eyebrow chip above the hero | A small bordered pill ('New · Now booking') above the headline is in almost every generated hero. |

package/COPY.md

@@ -256,8 +256,12 @@ For genuine exceptions only, and the reason matters more than the mechanism:
 - `.copyauditignore` at the repo root: globs, matched on the repo-relative
   path and the bare filename.
 - `.nocopycheck` at the repo root: skips the repo.
-- An `exceptions` entry in `art-direction.json`, with a `because` of at least
-  a sentence.
+- An `exceptions` entry in `art-direction.json`, or a `severity` entry in
+  `craft.config.json`, with a `because` of at least a sentence. **Never for
+  the blocking tier.** Under `craft copy --gate` a repo can raise a rule but
+  not lower one that blocks: the gate refuses the entry and says so. A
+  genuine one-off in the blocking tier takes `copy-ok` on its line, where a
+  reviewer sees it.
 
 Reaching for these more than occasionally means a rule is miscalibrated. Fix
 it here and in craft, not in forty repos.

package/README.md

@@ -94,6 +94,46 @@ reason, in `art-direction.json`:
 { "exceptions": [{ "tell": "ai-violet", "because": "Violet is on the van, the cards and the fascia." }] }
 ```
 
+### In CI
+
+```bash
+npx craft scan --baseline craft-baseline.json --update-baseline   # once: adopt today's findings
+npx craft scan --baseline craft-baseline.json --strict --sarif craft.sarif
+npx craft audit --pages https://example.com/sitemap.xml --viewport 390,1440
+```
+
+- `--baseline` reports only findings the baseline does not already hold. A
+  finding is keyed on its tell, path and excerpt, never its line, so an edit
+  above a known finding does not make it new. The output says how many known
+  findings it left out.
+- `--sarif <file>` writes SARIF 2.1.0 for GitHub code scanning. Findings on a
+  rendered page carry the URL, not a file, so code scanning does not show them.
+- `--json` output always carries `schemaVersion` (currently 1).
+- `--pages` audits every URL in a sitemap (or a sitemap index, one level deep)
+  or a file of URLs; `--viewport` audits each at those widths. A page that
+  will not load is listed as not measured, and fails `--strict`.
+
+`craft.config.json` in the repo root holds what craft should know about the
+repo. `.claude`, `.agents` and `.cursor` are never walked, config or not.
+
+```json
+{
+  "ignore": ["docs/archive/**", "*.stories.tsx"],
+  "copyPaths": ["content", "src/app"],
+  "severity": {
+    "em-dash": { "level": "block", "because": "This client's style guide bans them outright." }
+  }
+}
+```
+
+A severity change needs a `because`, like an exception. `off` is applied as an
+exception, so the report lists what it silenced.
+
+Under `craft copy --gate`, a repo can raise a copy tell but never lower one in
+the house blocking tier. A `warn` or `off` for a blocking tell, here or as an
+exception in `art-direction.json`, is refused and listed in the report. A
+genuine one-off takes `copy-ok` on its line.
+
 ### Copy
 
 [COPY.md](./COPY.md) is the house copy standard: the blocking tier, the review

package/dist/{audit-EGDNWSQB.js → audit-5QWFLZ6L.js}

@@ -1,4 +1,5 @@
 import {
+  VISUAL_MAX_HEIGHT,
   audit,
   collectInPage,
   loadPlaywright,
@@ -6,10 +7,12 @@ import {
   snapshotPage,
   snapshotUrl,
   snapshotUrls
-} from "./chunk-TSKRBIOC.js";
-import "./chunk-QMYERCBB.js";
-import "./chunk-3NGWXZZE.js";
+} from "./chunk-ULPI335S.js";
+import "./chunk-JYNXGCYZ.js";
+import "./chunk-PZ4MF2VV.js";
+import "./chunk-AL6MRG6V.js";
 export {
+  VISUAL_MAX_HEIGHT,
   audit,
   collectInPage,
   loadPlaywright,

package/dist/audit.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/audit/index.ts
 var audit_exports = {};
 __export(audit_exports, {
+  VISUAL_MAX_HEIGHT: () => VISUAL_MAX_HEIGHT,
   audit: () => audit,
   collectInPage: () => collectInPage,
   loadPlaywright: () => loadPlaywright,
@@ -1567,6 +1568,7 @@ var REFLEX_FONTS_2 = [
   "Plus Jakarta Sans",
   "Outfit",
   "Geist",
+  "Cal Sans",
   "Sora",
   "Instrument Sans",
   "Instrument Serif",
@@ -1788,7 +1790,7 @@ function iconTiles(file) {
     return sized && has(unit, /^rounded-(?:md|lg|xl|2xl|full)$/) && has(unit, /^(?:items-center|place-items-center|place-content-center)$/) && has(unit, /^bg-/);
   });
 }
-var ICON_LIBRARY = /from\s+["'](?:lucide-react|@heroicons\/react[^"']*|react-icons[^"']*|@phosphor-icons\/react|@tabler\/icons-react|@radix-ui\/react-icons)["']/;
+var ICON_LIBRARY = /from\s+["'](?:lucide-react|@heroicons\/react[^"']*|react-icons[^"']*|@phosphor-icons\/react|@tabler\/icons-react|@radix-ui\/react-icons|@iconscout\/react-unicons[^"']*|@mui\/icons-material[^"']*|react-material-symbols[^"']*)["']/;
 function iconTileStackHits(ctx) {
   const hits = [];
   for (const file of ctx.files) {
@@ -1935,6 +1937,12 @@ function shadcnHits(ctx) {
   const detail = unused.length > 0 ? `; ${unused.length} imported nowhere` : "";
   return [{ path: ui[0].path, offset: 0, message: `${ui.length} stock shadcn primitives${detail}` }];
 }
+function shadcnCardHits(ctx) {
+  return eachUnit(
+    ctx,
+    (unit) => has(unit, /^bg-card$/) && has(unit, /^text-card-foreground$/) && has(unit, /^border$/) && has(unit, /^rounded-(?:lg|xl)$/) && has(unit, /^shadow(?:-sm)?$/) ? "the registry Card recipe, unchanged" : null
+  );
+}
 function marqueeHits(ctx) {
   const hits = [];
   const pattern = /@keyframes\s+[\w-]*marquee|animate-(?:marquee|scroll-x|infinite-scroll)\b|<Marquee\b|["']react-fast-marquee["']|ui\/marquee["']|animation(?:-name)?\s*:\s*[^;]*marquee/i;
@@ -2152,6 +2160,23 @@ const inter = Inter({ subsets: ["latin"] });`),
       pass: [f3("src/components/ui/button.tsx", `export function Button() { return null; }`)]
     }
   },
+  {
+    id: "shadcn-card-stock",
+    name: "Stock shadcn Card",
+    generation: 1,
+    severity: "warn",
+    surface: "source",
+    why: "The registry Card (bg-card, a plain border, rounded-lg or rounded-xl, shadow-sm) is the container every generated page is built from. Left as shipped, every card on the site looks like every other shadcn site's.",
+    fix: "Give the card this site's radius and shadow from the restraint budget, or drop the shadow and let a visible border carry it.",
+    detect: shadcnCardHits,
+    fixtures: {
+      flag: [
+        f3("components/ui/card.tsx", `className={cn("rounded-lg border bg-card text-card-foreground shadow-sm", className)}`),
+        f3("components/ui/card.tsx", `className={cn("bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm", className)}`)
+      ],
+      pass: [f3("components/ui/card.tsx", `className={cn("rounded-sm border-2 border-ink bg-card text-card-foreground", className)}`)]
+    }
+  },
   {
     id: "cream-palette",
     name: "Cream ground",
@@ -2395,7 +2420,7 @@ function excerptAt(text, offset, max = 140) {
 }
 
 // src/snapshot/types.ts
-var SNAPSHOT_VERSION = 1;
+var SNAPSHOT_VERSION = 2;
 
 // src/snapshot/fixture.ts
 function makeSnapshot(patch = {}) {
@@ -2729,7 +2754,7 @@ var RENDERED_PATHS = {
 };
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.09.8";
+var CATALOGUE_VERSION = "2026.09.9";
 var CATALOGUE = [...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map(
   (t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t
 );
@@ -2827,7 +2852,7 @@ function auditSnapshot(snapshot, options = {}) {
 }
 
 // src/fingerprint/index.ts
-var FINGERPRINT_VERSION = 1;
+var FINGERPRINT_VERSION = 2;
 var CHROMATIC = 0.03;
 var MIN_ACCENT_AREA = 2e4;
 var oklch = (value) => {
@@ -2882,7 +2907,8 @@ function fingerprint(s) {
     roundness: median(s.controls.map((c) => Math.min(0.5, c.radiusPx / Math.max(1, c.heightPx)))),
     motion: below ? Math.min(1, s.motion.hiddenSections / below) : 0,
     effects: effects.sort(),
-    layout: s.sections.map((x) => x.kind)
+    layout: s.sections.map((x) => x.kind),
+    ...s.sections.length > 0 && s.sections.every((x) => x.role && x.geometry) ? { sections: s.sections.map((x) => ({ role: x.role, centred: x.geometry.centredShare, width: x.geometry.contentWidthRatio })) } : {}
   };
 }
 
@@ -2983,18 +3009,26 @@ function collectInPage() {
       top: Math.round(box(h).top)
     };
   });
+  const isButtonEl = (el) => el.tagName === "BUTTON" || el.tagName === "INPUT" && /^(submit|button)$/i.test(el.type);
+  const isControl = (el) => {
+    const isButton = isButtonEl(el);
+    if (!isButton && el.tagName !== "A") return false;
+    if (!shown(el)) return false;
+    const cs = style(el);
+    const b = box(el);
+    const label = (el.textContent ?? el.value ?? "").replace(/\s+/g, " ").trim();
+    if (!label || b.height < 24 || b.height > 90) return false;
+    if (!isButton && !(painted(cs.backgroundColor) || px(cs.borderTopWidth) >= 1)) return false;
+    if (!isButton && px(cs.paddingLeft) < 8) return false;
+    return true;
+  };
   const controls = [];
   for (const el of all) {
-    const tag = el.tagName;
-    const isButton = tag === "BUTTON" || tag === "INPUT" && /^(submit|button)$/i.test(el.type);
-    if (!isButton && tag !== "A") continue;
-    if (!shown(el)) continue;
+    if (!isControl(el)) continue;
+    const isButton = isButtonEl(el);
     const cs = style(el);
     const b = box(el);
     const label = (el.textContent ?? el.value ?? "").replace(/\s+/g, " ").trim();
-    if (!label || b.height < 24 || b.height > 90) continue;
-    if (!isButton && !(painted(cs.backgroundColor) || px(cs.borderTopWidth) >= 1)) continue;
-    if (!isButton && px(cs.paddingLeft) < 8) continue;
     const r = cs.borderTopLeftRadius;
     const radius = r.endsWith("%") ? parseFloat(r) / 100 * b.height : px(r);
     controls.push({
@@ -3074,7 +3108,80 @@ function collectInPage() {
     }
     return best;
   };
-  const sections = blocks.slice(0, 40).map((el, index) => {
+  const backgroundOf = (el) => {
+    for (let n = el; n && n !== document.documentElement; n = n.parentElement) {
+      const c = style(n).backgroundColor;
+      if (painted(c)) return c;
+    }
+    return ground;
+  };
+  const geometryOf = (el, b) => {
+    const leaves = Array.from(el.querySelectorAll("*")).slice(0, 1500).filter((n) => (ownText(n).length > 1 || /^(IMG|SVG|VIDEO|PICTURE|BUTTON|INPUT|TEXTAREA|SELECT)$/i.test(n.tagName)) && shown(n)).slice(0, 400);
+    const centreX = b.left + b.width / 2;
+    let left = 0;
+    let right = 0;
+    let covered = 0;
+    let minX = Infinity;
+    let maxX = -Infinity;
+    let textBlocks = 0;
+    let centred = 0;
+    for (const n of leaves) {
+      const r = box(n);
+      const area = r.width * r.height;
+      covered += area;
+      minX = Math.min(minX, r.left);
+      maxX = Math.max(maxX, r.left + r.width);
+      const split = Math.max(0, Math.min(r.width, centreX - r.left));
+      left += split * r.height;
+      right += (r.width - split) * r.height;
+      if (ownText(n).length > 1) {
+        textBlocks += 1;
+        const mid = r.left + r.width / 2;
+        if (style(n).textAlign === "center" || Math.abs(mid - centreX) < vw * 0.03 && r.width < b.width * 0.8) centred += 1;
+      }
+    }
+    const round = (v) => Math.round(v * 1e3) / 1e3;
+    return {
+      centredShare: textBlocks ? round(centred / textBlocks) : 0,
+      mirrorSymmetry: left + right > 0 ? round(1 - Math.abs(left - right) / (left + right)) : 1,
+      whitespaceRatio: round(Math.max(0, 1 - Math.min(1, covered / Math.max(1, b.width * b.height)))),
+      contentWidthRatio: leaves.length ? round(Math.min(1, (maxX - minX) / vw)) : 0,
+      background: backgroundOf(el),
+      controls: Array.from(el.querySelectorAll("a, button, input")).slice(0, 200).filter(isControl).length
+    };
+  };
+  const CURRENCY = /[£$€]\s?\d/;
+  const roleOf = (el, kind, geo, b, cards, iconCards, last) => {
+    if (kind === "marquee" || kind === "hero") return kind;
+    const heading = (el.querySelector("h1, h2, h3")?.textContent ?? "").toLowerCase();
+    const leaves = Array.from(el.querySelectorAll("*")).slice(0, 1500);
+    const own = leaves.map(ownText);
+    const questions = own.filter((t) => /\?$/.test(t) && t.length > 8).length;
+    if (el.querySelectorAll("details").length >= 3 || el.querySelectorAll("[aria-expanded]").length >= 3 || /\bfaq|frequently asked|questions\b/.test(heading) && questions >= 3) return "faq";
+    const prices = own.filter((t) => CURRENCY.test(t) && t.length < 40).length;
+    if (prices >= 2 && (cards >= 2 || /pric|plan|package/.test(heading))) return "pricing";
+    const quotes = el.querySelectorAll("blockquote, q").length;
+    if (quotes >= 2 || /testimonial|review|what (?:our )?(?:clients|customers|people) say/.test(heading)) return "testimonials";
+    const steps = Math.max(0, ...Array.from(el.querySelectorAll("ol")).map((ol) => ol.children.length));
+    const numbered = own.filter((t) => /^(?:step\s*)?0?[1-9][.:]?$/i.test(t)).length;
+    if (steps >= 3 || numbered >= 3 || /how it works|our process|\bsteps?\b/.test(heading)) return "process";
+    const form = el.querySelector("form");
+    const fields = form ? form.querySelectorAll("input:not([type=hidden]):not([type=submit]), textarea, select").length : 0;
+    if (fields >= 2 || /contact|get in touch/.test(heading)) return "contact";
+    const portraits = Array.from(el.querySelectorAll("img")).filter((i) => {
+      const r = box(i);
+      return r.width >= 80 && r.width <= 420 && Math.abs(r.width - r.height) < r.width * 0.25;
+    }).length;
+    if (portraits >= 3 && /team|people|meet|who we are/.test(heading)) return "team";
+    if (kind === "stats" || kind === "logos") return kind;
+    const words = (el.textContent ?? "").replace(/\s+/g, " ").trim().length;
+    const setApart = geo.background !== ground || geo.centredShare >= 0.6;
+    if (setApart && heading && b.height <= vh * 0.9 && geo.controls >= 1 && geo.controls <= 2 && words < 400 && cards < 3) return last ? "footer-cta" : "cta-band";
+    if (cards >= 3 && iconCards >= 2) return "features";
+    return kind;
+  };
+  const kept = blocks.slice(0, 40);
+  const sections = kept.map((el, index) => {
     const b = box(el);
     const heading = el.querySelector("h1, h2, h3");
     const label = (heading?.textContent ?? el.textContent ?? "").replace(/\s+/g, " ").trim().slice(0, 60);
@@ -3088,6 +3195,7 @@ function collectInPage() {
     else if (images.length >= 4 && textChars < 300) kind = "logos";
     else if (numbers >= 3 && textChars < 600) kind = "stats";
     else if (cards >= 3) kind = "cards";
+    const geometry = geometryOf(el, b);
     return {
       top: Math.round(b.top),
       height: Math.round(b.height),
@@ -3095,7 +3203,9 @@ function collectInPage() {
       label,
       cards,
       iconCards,
-      hiddenAtLoad: b.top > vh && hiddenAtLoad(el)
+      hiddenAtLoad: b.top > vh && hiddenAtLoad(el),
+      role: roleOf(el, kind, geometry, b, cards, iconCards, index === kept.length - 1),
+      geometry
     };
   });
   if (header && sections.length === 0) {
@@ -3188,6 +3298,13 @@ function collectInPage() {
     headings: headings2,
     controls,
     sections,
+    rhythmVariance: (() => {
+      const hs = sections.map((x) => x.height);
+      if (hs.length < 2) return null;
+      const mean = hs.reduce((t, v) => t + v, 0) / hs.length;
+      const sd = Math.sqrt(hs.reduce((t, v) => t + (v - mean) ** 2, 0) / hs.length);
+      return mean > 0 ? Math.round(sd / mean * 1e3) / 1e3 : null;
+    })(),
     effects,
     motion: {
       hiddenSections: sections.filter((s) => s.hiddenAtLoad).length,
@@ -3221,7 +3338,139 @@ function overlayInPage() {
   return false;
 }
 
+// src/direction/png.ts
+var import_node_zlib = require("zlib");
+function decodePng(buf) {
+  const sig = [137, 80, 78, 71, 13, 10, 26, 10];
+  if (!sig.every((b, i) => buf[i] === b)) throw new Error("not a PNG");
+  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+  let pos = 8;
+  let width = 0;
+  let height = 0;
+  let depth = 0;
+  let colour = 0;
+  let interlace = 0;
+  const idat = [];
+  while (pos < buf.length) {
+    const len = view.getUint32(pos);
+    const type = String.fromCharCode(...buf.subarray(pos + 4, pos + 8));
+    const data = buf.subarray(pos + 8, pos + 8 + len);
+    if (type === "IHDR") {
+      width = view.getUint32(pos + 8);
+      height = view.getUint32(pos + 12);
+      depth = data[8];
+      colour = data[9];
+      interlace = data[12];
+    } else if (type === "IDAT") idat.push(data);
+    else if (type === "IEND") break;
+    pos += 12 + len;
+  }
+  const channels = { 0: 1, 2: 3, 4: 2, 6: 4 }[colour];
+  if (depth !== 8 || !channels || interlace !== 0) throw new Error(`unsupported PNG (depth ${depth}, colour type ${colour}${interlace ? ", interlaced" : ""}); export it as 8-bit RGB`);
+  const raw = (0, import_node_zlib.inflateSync)(Buffer.concat(idat.map((d) => Buffer.from(d))));
+  const stride = width * channels;
+  const out = new Uint8Array(width * height * 4);
+  const prev = new Uint8Array(stride);
+  const line = new Uint8Array(stride);
+  for (let y = 0; y < height; y += 1) {
+    const filter = raw[y * (stride + 1)];
+    const src = raw.subarray(y * (stride + 1) + 1, (y + 1) * (stride + 1));
+    for (let x = 0; x < stride; x += 1) {
+      const a = x >= channels ? line[x - channels] : 0;
+      const b = prev[x];
+      const c = x >= channels ? prev[x - channels] : 0;
+      let v = src[x];
+      if (filter === 1) v += a;
+      else if (filter === 2) v += b;
+      else if (filter === 3) v += a + b >> 1;
+      else if (filter === 4) {
+        const p = a + b - c;
+        const pa = Math.abs(p - a);
+        const pb = Math.abs(p - b);
+        const pc = Math.abs(p - c);
+        v += pa <= pb && pa <= pc ? a : pb <= pc ? b : c;
+      }
+      line[x] = v & 255;
+    }
+    for (let x = 0; x < width; x += 1) {
+      const i = x * channels;
+      const o = (y * width + x) * 4;
+      if (channels >= 3) {
+        out[o] = line[i];
+        out[o + 1] = line[i + 1];
+        out[o + 2] = line[i + 2];
+        out[o + 3] = channels === 4 ? line[i + 3] : 255;
+      } else {
+        out[o] = out[o + 1] = out[o + 2] = line[i];
+        out[o + 3] = channels === 2 ? line[i + 1] : 255;
+      }
+    }
+    prev.set(line);
+  }
+  return { width, height, rgba: out };
+}
+
+// src/snapshot/visual.ts
+var EDGE_STEP = 32;
+function visualMeasures(img, maxSamples = 1e6) {
+  const { width: w, height: h, rgba } = img;
+  if (w < 2 || h < 2 || rgba.length < w * h * 4) throw new Error(`visualMeasures: ${w}x${h} image with ${rgba.length} bytes`);
+  const step = Math.max(1, Math.ceil(Math.sqrt(w * h / maxSamples)));
+  const lum = (x, y) => {
+    const i = (y * w + x) * 4;
+    return 0.2126 * rgba[i] + 0.7152 * rgba[i + 1] + 0.0722 * rgba[i + 2];
+  };
+  let n = 0;
+  let sumRg = 0;
+  let sumYb = 0;
+  let sumRg2 = 0;
+  let sumYb2 = 0;
+  let edges = 0;
+  let edgeN = 0;
+  let asym = 0;
+  let asymN = 0;
+  for (let y = 0; y < h; y += step) {
+    for (let x = 0; x < w; x += step) {
+      const i = (y * w + x) * 4;
+      const r = rgba[i];
+      const g = rgba[i + 1];
+      const b = rgba[i + 2];
+      const rg = r - g;
+      const yb = 0.5 * (r + g) - b;
+      sumRg += rg;
+      sumYb += yb;
+      sumRg2 += rg * rg;
+      sumYb2 += yb * yb;
+      n += 1;
+      const l = lum(x, y);
+      if (x + step < w && y + step < h) {
+        if (Math.abs(lum(x + step, y) - l) + Math.abs(lum(x, y + step) - l) > EDGE_STEP) edges += 1;
+        edgeN += 1;
+      }
+      if (x < w / 2) {
+        asym += Math.abs(l - lum(w - 1 - x, y));
+        asymN += 1;
+      }
+    }
+  }
+  const meanRg = sumRg / n;
+  const meanYb = sumYb / n;
+  const sdRg = Math.sqrt(Math.max(0, sumRg2 / n - meanRg * meanRg));
+  const sdYb = Math.sqrt(Math.max(0, sumYb2 / n - meanYb * meanYb));
+  const colourfulness = Math.sqrt(sdRg ** 2 + sdYb ** 2) + 0.3 * Math.sqrt(meanRg ** 2 + meanYb ** 2);
+  const round = (v, d = 3) => Math.round(v * 10 ** d) / 10 ** d;
+  return {
+    colourfulness: round(colourfulness, 1),
+    edgeDensity: round(edgeN ? edges / edgeN : 0),
+    symmetry: round(asymN ? 1 - asym / asymN / 255 : 1),
+    width: w,
+    height: h,
+    sampled: n
+  };
+}
+
 // src/audit/index.ts
+var VISUAL_MAX_HEIGHT = 6e3;
 async function loadPlaywright() {
   for (const name of ["playwright", "playwright-core"]) {
     try {
@@ -3239,12 +3488,23 @@ async function snapshotPage(page, url, options = {}) {
   await page.waitForTimeout(options.introWindowMs ?? 5e3);
   const late = await page.evaluate(overlayInPage).catch(() => false);
   const data = await page.evaluate(collectInPage);
+  let visual;
+  if (page.screenshot && options.visual !== false) {
+    try {
+      const height = Math.min(data.pageHeight, VISUAL_MAX_HEIGHT);
+      const png = await page.screenshot({ fullPage: true, type: "png", clip: { x: 0, y: 0, width: data.viewport.width, height } });
+      visual = visualMeasures(decodePng(png));
+    } catch {
+      visual = void 0;
+    }
+  }
   return {
     version: SNAPSHOT_VERSION,
     url,
     capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
     ...data,
-    motion: { ...data.motion, introOverlay: early && !late }
+    motion: { ...data.motion, introOverlay: early && !late },
+    ...visual ? { visual } : {}
   };
 }
 async function launch(pw, url, options) {
@@ -3270,7 +3530,9 @@ async function snapshotUrls(urls, 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 });
+        const response = await page.goto(url, { waitUntil: "domcontentloaded", timeout: options.timeoutMs ?? 45e3 });
+        const status = typeof response?.status === "function" ? response.status() : 200;
+        if (status >= 400) throw new Error(`HTTP ${status}`);
         out.push({ url, snapshot: await snapshotPage(page, url, options) });
       } catch (error) {
         out.push({ url, error: error.message });
@@ -3289,6 +3551,7 @@ async function audit(url, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  VISUAL_MAX_HEIGHT,
   audit,
   collectInPage,
   loadPlaywright,