@domandigital/craft 0.10.0 → 0.12.0

package/dist/chunk-PU5G5DUC.js

@@ -0,0 +1,206 @@
+import {
+  snapshotUrl,
+  snapshotUrls
+} from "./chunk-ULPI335S.js";
+import {
+  describeTypicality,
+  loadNull,
+  typicality
+} from "./chunk-LHGY43LL.js";
+import {
+  readSnapshot
+} from "./chunk-ZKVJ7K6X.js";
+import {
+  SOURCE_FILE,
+  finish,
+  loadConfig,
+  loadExceptions,
+  parseFlags,
+  prepareReport,
+  readPaths,
+  toJson
+} from "./chunk-J3QUROJ5.js";
+import {
+  fingerprint
+} from "./chunk-PZ4MF2VV.js";
+import {
+  auditSnapshot,
+  scanSource
+} from "./chunk-AL6MRG6V.js";
+
+// src/audit/cli.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+
+// src/audit/pages.ts
+var decode = (s) => s.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'");
+function parseSitemap(xml) {
+  const locs = [...xml.matchAll(/<loc>\s*([^<]+?)\s*<\/loc>/gi)].map((m) => decode(m[1]));
+  return /<sitemapindex[\s>]/i.test(xml) ? { urls: [], sitemaps: locs } : { urls: locs, sitemaps: [] };
+}
+function parseUrlList(text) {
+  return text.split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
+}
+function parseViewports(value) {
+  const widths = value.split(",").map((w) => w.trim());
+  return widths.map((w) => {
+    const width = Number(w);
+    if (!Number.isInteger(width) || width < 240 || width > 3840) throw new Error(`--viewport: "${w}" is not a width in px between 240 and 3840`);
+    return { width, height: width < 600 ? 844 : width < 1024 ? 1024 : 900 };
+  });
+}
+
+// src/audit/cli.ts
+var fmt = (o) => o ? `oklch(${o.l.toFixed(3)} ${o.c.toFixed(3)} ${o.h.toFixed(1)})` : "none";
+function describeFingerprint(fp) {
+  return [
+    "Fingerprint",
+    `  accent     ${fmt(fp.accent)}`,
+    `  ground     ${fmt(fp.ground)}`,
+    `  display    ${fp.display.family} (${fp.display.class})`,
+    `  body       ${fp.body.family} (${fp.body.class})`,
+    `  roundness  ${fp.roundness === null ? "no buttons" : fp.roundness.toFixed(2)}`,
+    `  motion     ${Math.round(fp.motion * 100)}% of sections below the fold reveal on scroll`,
+    `  effects    ${fp.effects.join(", ") || "none"}`,
+    `  layout     ${fp.layout.join(" > ") || "none"}`
+  ].join("\n");
+}
+function merge(a, b) {
+  const byTell = { ...a.summary.byTell };
+  for (const [k, v] of Object.entries(b.summary.byTell)) byTell[k] = (byTell[k] ?? 0) + v;
+  return {
+    catalogueVersion: a.catalogueVersion,
+    findings: [...a.findings, ...b.findings],
+    rejectedExceptions: a.rejectedExceptions,
+    excepted: [...a.excepted, ...b.excepted],
+    suppressed: [...a.suppressed, ...b.suppressed],
+    summary: {
+      files: a.summary.files + b.summary.files,
+      findings: a.summary.findings + b.summary.findings,
+      byGeneration: { 1: a.summary.byGeneration[1] + b.summary.byGeneration[1], 2: a.summary.byGeneration[2] + b.summary.byGeneration[2], 3: a.summary.byGeneration[3] + b.summary.byGeneration[3] },
+      byTell,
+      blocking: a.summary.blocking + b.summary.blocking
+    }
+  };
+}
+function readSnapshotFile(path) {
+  return readSnapshot(JSON.parse(readFileSync(path, "utf8")), path);
+}
+async function readText(source, cwd) {
+  if (/^https?:\/\//i.test(source)) {
+    const res = await fetch(source);
+    if (!res.ok) throw new Error(`${source}: HTTP ${res.status}`);
+    return res.text();
+  }
+  const path = resolve(cwd, source);
+  if (!existsSync(path)) throw new Error(`no such file: ${source}`);
+  return readFileSync(path, "utf8");
+}
+async function resolvePages(source, cwd) {
+  const text = await readText(source, cwd);
+  if (!/^\s*<(?:\?xml|urlset|sitemapindex)/i.test(text)) return parseUrlList(text);
+  const { urls, sitemaps } = parseSitemap(text);
+  const nested = await Promise.all(sitemaps.map(async (s) => parseSitemap(await readText(s, cwd)).urls));
+  const all = [...urls, ...nested.flat()];
+  if (all.length === 0) throw new Error(`${source}: no <loc> entries`);
+  return [...new Set(all)];
+}
+function viewportsOf(flags) {
+  if (flags.viewport) return parseViewports(flags.viewport);
+  if (flags.width || flags.height) return [{ width: Number(flags.width ?? 1440), height: Number(flags.height ?? 900) }];
+  return [void 0];
+}
+async function runAudit(command, args, io) {
+  try {
+    const flags = parseFlags(args);
+    if (typeof flags === "string") throw new Error(flags);
+    const target = flags.positional[0];
+    if (command === "snapshot" && (flags.pages || flags.viewport)) throw new Error("craft snapshot takes one page; use --width and --height");
+    if (flags.pages && target) throw new Error("give a page or --pages, not both");
+    if (!target && !flags.pages) throw new Error(`usage: craft ${command} <url${command === "audit" ? " | snapshot.json> | --pages <sitemap.xml | urls.txt>" : ">"}`);
+    const viewports = viewportsOf(flags);
+    const audited = [];
+    const failed = [];
+    const local = target ? resolve(io.cwd, target) : "";
+    if (target && command === "audit" && /\.json$/i.test(target) && existsSync(local)) {
+      audited.push({ url: target, viewport: null, snapshot: readSnapshotFile(local) });
+    } else if (target && viewports.length === 1) {
+      const snapshot = await snapshotUrl(target, { viewport: viewports[0] });
+      audited.push({ url: target, viewport: viewports[0] ?? null, snapshot });
+    } else {
+      const urls = flags.pages ? await resolvePages(flags.pages, io.cwd) : [target];
+      for (const viewport of viewports) {
+        for (const r of await snapshotUrls(urls, { viewport })) {
+          if (r.snapshot) audited.push({ url: r.url, viewport: viewport ?? null, snapshot: r.snapshot });
+          else failed.push({ url: r.url, viewport: viewport ?? null, error: r.error ?? "no snapshot" });
+        }
+      }
+    }
+    if (audited.length === 0) throw new Error(`no page could be measured:
+${failed.map((f) => `  ${f.url}: ${f.error}`).join("\n")}`);
+    const single = audited.length === 1 && failed.length === 0;
+    if (flags.out) {
+      if (!single) throw new Error("--out saves one snapshot; drop --pages and --viewport, or snapshot each page");
+      writeFileSync(resolve(io.cwd, flags.out), `${JSON.stringify(audited[0].snapshot, null, 2)}
+`);
+    }
+    if (command === "snapshot") {
+      const { snapshot } = audited[0];
+      if (!flags.out) io.out(JSON.stringify(snapshot, null, 2));
+      else io.out(`craft snapshot: ${snapshot.url} saved to ${flags.out}`);
+      return 0;
+    }
+    const root = flags.repo ? resolve(io.cwd, flags.repo) : io.cwd;
+    const exceptions = loadExceptions(flags, root);
+    const config = loadConfig(flags, root);
+    const label = (a) => viewports.length > 1 && a.viewport ? `${a.snapshot.url} @ ${a.viewport.width}px` : a.snapshot.url;
+    let report = audited.map((a) => {
+      const r = auditSnapshot(a.snapshot, { exceptions });
+      return { ...r, findings: r.findings.map((f) => ({ ...f, path: label(a) })) };
+    }).reduce((acc, r) => merge(acc, r));
+    if (flags.repo) {
+      report = merge(scanSource(readPaths(["."], root, SOURCE_FILE, void 0, config.ignore), { exceptions }), report);
+    }
+    const prepared = prepareReport(report, flags, io, config);
+    if (!prepared) return 0;
+    const nulls = flags.null ? flags.null.split(",").map((p) => loadNull(p.trim(), io.cwd)) : [];
+    const pooled = nulls.flatMap((m, i) => m.runs.map((r) => nulls.length > 1 ? { ...r, id: `${i + 1}/${r.id}` } : r));
+    const pages = audited.map((a) => {
+      const fp = fingerprint(a.snapshot);
+      return { url: a.snapshot.url, viewport: a.viewport, fingerprint: fp, typicality: nulls.length ? typicality(fp, pooled) : null };
+    });
+    const unmeasured = failed.length > 0 && flags.strict ? 1 : 0;
+    if (flags.json) {
+      const extra = single ? { fingerprint: pages[0].fingerprint, typicality: pages[0].typicality, snapshot: flags.out ?? null } : {};
+      io.out(toJson({ report: prepared, ...extra, pages, failed }));
+      return Math.max(prepared.summary.blocking > 0 || flags.strict && prepared.summary.findings > 0 ? 1 : 0, unmeasured);
+    }
+    const title = single ? `craft audit ${audited[0].snapshot.url}` : `craft audit: ${audited.length} page${audited.length === 1 ? "" : "s"}`;
+    const code = finish(prepared, { ...flags, json: false }, title, io);
+    for (const page of pages) {
+      io.out("");
+      if (!single) io.out(`${page.url}${page.viewport ? ` @ ${page.viewport.width}px` : ""}`);
+      io.out(describeFingerprint(page.fingerprint));
+      if (page.typicality) {
+        io.out("");
+        io.out(describeTypicality(page.typicality, pooled.length, nulls.length));
+      }
+    }
+    if (failed.length) {
+      io.out("");
+      io.out("Not measured (never counts as a pass):");
+      for (const f of failed) io.out(`  ${f.url}${f.viewport ? ` @ ${f.viewport.width}px` : ""}: ${f.error}`);
+    }
+    return Math.max(code, unmeasured);
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
+
+export {
+  describeFingerprint,
+  merge,
+  resolvePages,
+  runAudit
+};

package/dist/{chunk-QMYERCBB.js → chunk-PZ4MF2VV.js}

@@ -3,10 +3,10 @@ import {
   fontClass,
   normaliseFamily,
   parseColour
-} from "./chunk-3NGWXZZE.js";
+} from "./chunk-AL6MRG6V.js";
 
 // src/fingerprint/index.ts
-var FINGERPRINT_VERSION = 1;
+var FINGERPRINT_VERSION = 2;
 var CHROMATIC = 0.03;
 var MIN_ACCENT_AREA = 2e4;
 var oklch = (value) => {
@@ -61,23 +61,36 @@ 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 })) } : {}
   };
 }
 var DISTANCE_WEIGHTS = { accent: 0.25, type: 0.25, ground: 0.1, shape: 0.1, motion: 0.1, effects: 0.1, layout: 0.1 };
-function levenshtein(a, b) {
+function levenshtein(a, b, cost = (x, y) => x === y ? 0 : 1) {
   const row = Array.from({ length: b.length + 1 }, (_, i) => i);
   for (let i = 1; i <= a.length; i += 1) {
     let prev = row[0];
     row[0] = i;
     for (let j = 1; j <= b.length; j += 1) {
       const cur = row[j];
-      row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+      row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + cost(a[i - 1], b[j - 1]));
       prev = cur;
     }
   }
   return row[b.length];
 }
+function sectionCost(x, y) {
+  if (x.role !== y.role) return 1;
+  return Math.min(0.5, (Math.abs(x.centred - y.centred) + Math.abs(x.width - y.width)) / 2);
+}
+function layoutDistance(a, b) {
+  if (a.sections && b.sections) {
+    const longest2 = Math.max(a.sections.length, b.sections.length);
+    return longest2 === 0 ? 0 : levenshtein(a.sections, b.sections, sectionCost) / longest2;
+  }
+  const longest = Math.max(a.layout.length, b.layout.length);
+  return longest === 0 ? 0 : levenshtein(a.layout, b.layout) / longest;
+}
 var clamp = (n) => Math.max(0, Math.min(1, n));
 function faceDistance(a, b) {
   if (a.family.toLowerCase() === b.family.toLowerCase()) return 0;
@@ -92,8 +105,7 @@ function fingerprintDistance(a, b) {
   const union = /* @__PURE__ */ new Set([...a.effects, ...b.effects]);
   const shared = a.effects.filter((e) => b.effects.includes(e)).length;
   const effects = union.size === 0 ? 0 : 1 - shared / union.size;
-  const longest = Math.max(a.layout.length, b.layout.length);
-  const layout = longest === 0 ? 0 : levenshtein(a.layout, b.layout) / longest;
+  const layout = layoutDistance(a, b);
   const parts = { accent, ground, type, shape, motion, effects, layout };
   const total = Object.keys(DISTANCE_WEIGHTS).reduce((sum, k) => sum + DISTANCE_WEIGHTS[k] * parts[k], 0);
   return { total: Math.round(total * 1e3) / 1e3, parts };

package/dist/{chunk-JWHC67ZS.js → chunk-S3NZAVU6.js}

@@ -6,7 +6,115 @@ import {
   isCream,
   normaliseFamily,
   parseColour
-} from "./chunk-3NGWXZZE.js";
+} from "./chunk-AL6MRG6V.js";
+
+// src/direction/licences.ts
+var LICENCES = [
+  {
+    name: "Basteleur",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://velvetyne.fr/fonts/basteleur/",
+    note: "Velvetyne, designed by Keussel. Keep the OFL notice with the font files."
+  },
+  {
+    name: "Gulax",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://velvetyne.fr/fonts/gulax/",
+    note: "Velvetyne. Keep the OFL notice with the font files."
+  },
+  {
+    name: "Le Murmure",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://velvetyne.fr/fonts/le-murmure/",
+    note: "Velvetyne. Keep the OFL notice with the font files."
+  },
+  {
+    name: "Blaze Type",
+    subject: "foundry",
+    licence: "commercial",
+    multiClient: "per-site",
+    cap: 10,
+    checked: "2026-09-24",
+    source: "https://blazetype.eu/eula",
+    note: "The EULA sells a professional licence for 1 to 10 websites, and lets an agency buy in a client's name at the listed price. Its /license page says one licence covers every domain; the EULA is the contract, so buy per client."
+  },
+  {
+    name: "Power Type",
+    subject: "foundry",
+    licence: "commercial",
+    multiClient: "unverified",
+    checked: "2026-09-24",
+    source: "https://power-type.com/eula",
+    note: "Research on 2026-09-11 reported a Super License capped at 10 self-hosted domains. The EULA page did not load when checked; read it before relying on the cap."
+  },
+  {
+    name: "Grilli Type",
+    subject: "foundry",
+    licence: "commercial",
+    multiClient: "per-site",
+    checked: "2026-09-24",
+    source: "https://www.grillitype.com/information",
+    note: "Web licences cover any number of domains controlled by the licensee, priced by monthly visitors, so a client site needs the client's own licence. Unlimited tiers start at $10,000 per style."
+  },
+  {
+    name: "Phosphor",
+    subject: "icons",
+    licence: "MIT",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://github.com/phosphor-icons/core/blob/main/LICENSE",
+    note: "Six weights. The icon-tile tells treat it exactly as they treat Lucide: the library is not the tell, the tinted tile is."
+  },
+  {
+    name: "Tabler Icons",
+    subject: "icons",
+    licence: "MIT",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://github.com/tabler/tabler-icons/blob/main/LICENSE",
+    note: "One stroke grid across the set."
+  },
+  {
+    name: "Iconoir",
+    subject: "icons",
+    licence: "MIT",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://github.com/iconoir-icons/iconoir/blob/main/LICENSE",
+    note: "Smaller set, no paid tier."
+  },
+  {
+    name: "Unicons",
+    subject: "icons",
+    licence: "IconScout Simple License",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://github.com/Iconscout/unicons/blob/master/LICENSE",
+    note: "IconScout's free set, personal and commercial use, attribution optional."
+  },
+  {
+    name: "IconScout premium",
+    subject: "icons",
+    licence: "commercial",
+    multiClient: "per-site",
+    checked: "2026-09-24",
+    source: "https://iconscout.com/licenses",
+    note: "Each licence covers a single end product. Never in a tool, template or shared kit (create-site, craft, a house component library), even modified. Record the assets each site uses. Assets come from different contributors, so take one site's set from one contributor."
+  }
+];
+function faceLicence(family) {
+  const name = family.trim().toLowerCase();
+  return LICENCES.find((l) => l.subject === "face" && l.name.toLowerCase() === name);
+}
 
 // src/direction/types.ts
 var DIRECTION_VERSION = 1;
@@ -150,6 +258,18 @@ function validateDirection(input, ctx = {}) {
         ok = false;
       }
     }
+    if ((key === "display" || key === "body") && typeof c.value === "string" && c.value.trim()) {
+      const family = normaliseFamily(c.value);
+      const entry = faceLicence(family);
+      if (!entry) {
+        warn(`${at}.value`, `${family}: licence not in craft's register. Read the licensor's own terms for use on this client's site, then add it to src/direction/licences.ts.`);
+      } else if (entry.multiClient === "unverified") {
+        warn(`${at}.value`, `${family}: licence unverified (${entry.note})`);
+      } else if (entry.multiClient === "capped" || entry.multiClient === "per-site") {
+        const scope = entry.multiClient === "capped" ? `covers up to ${entry.cap} sites` : "needs a licence for this site, in the client's name";
+        warn(`${at}.value`, `${family}: ${entry.licence} licence ${scope}. Record the purchase before launch.`);
+      }
+    }
     const fp = ctx.fingerprint;
     if (fp && typeof c.value === "string") {
       if ((key === "accent" || key === "ground") && parseColour(c.value)) {

package/dist/{chunk-TSKRBIOC.js → chunk-ULPI335S.js}

@@ -1,10 +1,13 @@
+import {
+  decodePng
+} from "./chunk-JYNXGCYZ.js";
 import {
   fingerprint
-} from "./chunk-QMYERCBB.js";
+} from "./chunk-PZ4MF2VV.js";
 import {
   SNAPSHOT_VERSION,
   auditSnapshot
-} from "./chunk-3NGWXZZE.js";
+} from "./chunk-AL6MRG6V.js";
 
 // src/audit/collect.ts
 function collectInPage() {
@@ -103,18 +106,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({
@@ -194,7 +205,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);
@@ -208,6 +292,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),
@@ -215,7 +300,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) {
@@ -308,6 +395,13 @@ function collectInPage() {
     headings,
     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,
@@ -341,7 +435,67 @@ function overlayInPage() {
   return false;
 }
 
+// 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 {
@@ -359,12 +513,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) {
@@ -390,7 +555,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 });
@@ -411,6 +578,7 @@ async function audit(url, options = {}) {
 export {
   collectInPage,
   overlayInPage,
+  VISUAL_MAX_HEIGHT,
   loadPlaywright,
   snapshotPage,
   snapshotUrl,