@domandigital/craft 0.5.0 → 0.6.0

package/dist/chunk-HYGFP3LB.js

@@ -0,0 +1,68 @@
+import {
+  fontClass,
+  normaliseFamily,
+  parseColour
+} from "./chunk-GWMSSRIQ.js";
+
+// src/fingerprint/index.ts
+var FINGERPRINT_VERSION = 1;
+var CHROMATIC = 0.03;
+var oklch = (value) => {
+  const parsed = parseColour(value);
+  return parsed && parsed.alpha > 0.5 ? parsed.oklch : null;
+};
+function accentOf(s) {
+  const buttons = /* @__PURE__ */ new Map();
+  for (const c of s.controls) {
+    const o = oklch(c.background);
+    if (o && o.c >= CHROMATIC) buttons.set(c.background, (buttons.get(c.background) ?? 0) + 1);
+  }
+  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];
+  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;
+}
+function faces(s) {
+  const byChars = [...s.fonts].sort((a, b) => b.chars - a.chars);
+  const byDisplay = [...s.fonts].sort((a, b) => b.displayChars - a.displayChars);
+  const bodyName = normaliseFamily(byChars[0]?.family ?? "system-ui");
+  const displayName = normaliseFamily((byDisplay[0]?.displayChars ? byDisplay[0].family : byChars[0]?.family) ?? "system-ui");
+  return {
+    display: { family: displayName, class: fontClass(displayName) },
+    body: { family: bodyName, class: fontClass(bodyName) }
+  };
+}
+function median(values) {
+  if (values.length === 0) return null;
+  const sorted = [...values].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  return sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
+}
+function fingerprint(s) {
+  const effects = [];
+  if (s.effects.glass > 0) effects.push("glass-panel");
+  if (s.effects.gradientText > 0) effects.push("gradient-text");
+  if (s.effects.glows > 0 || s.effects.gradients.some((g) => g.radial)) effects.push("radial-spotlight-glow");
+  if (s.effects.gridBackgrounds > 0) effects.push("grid-background");
+  if (s.effects.marquees > 0) effects.push("marquee");
+  if (s.effects.hairlineShadowCards >= 3) effects.push("thin-border-wide-shadow");
+  if (s.effects.eyebrowChip) effects.push("hero-eyebrow-chip");
+  if (s.motion.introOverlay) effects.push("intro-cinematic");
+  const below = s.sections.filter((x) => x.top > s.viewport.height).length;
+  return {
+    version: FINGERPRINT_VERSION,
+    accent: accentOf(s),
+    ground: oklch(s.ground) ?? { l: 1, c: 0, h: 0 },
+    ...faces(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)
+  };
+}
+
+export {
+  fingerprint
+};

package/dist/cli-7ME4VIRG.js

@@ -0,0 +1,470 @@
+import {
+  fingerprint
+} from "./chunk-HYGFP3LB.js";
+import {
+  SNAPSHOT_VERSION,
+  SOURCE_FILE,
+  auditSnapshot,
+  finish,
+  loadExceptions,
+  parseFlags,
+  readPaths,
+  scanSource
+} from "./chunk-GWMSSRIQ.js";
+
+// src/audit/cli.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+
+// src/audit/collect.ts
+function collectInPage() {
+  const vw = window.innerWidth;
+  const vh = window.innerHeight;
+  const scrollY = window.scrollY;
+  const LIMIT = 8e3;
+  const all = Array.from(document.body.querySelectorAll("*")).slice(0, LIMIT);
+  const styles = /* @__PURE__ */ new Map();
+  const style = (el) => {
+    let cs = styles.get(el);
+    if (!cs) styles.set(el, cs = getComputedStyle(el));
+    return cs;
+  };
+  const box = (el) => {
+    const r = el.getBoundingClientRect();
+    return { top: r.top + scrollY, left: r.left, width: r.width, height: r.height };
+  };
+  const shown = (el) => {
+    const cs = style(el);
+    if (cs.display === "none" || cs.visibility === "hidden") return false;
+    const r = el.getBoundingClientRect();
+    return r.width > 0 && r.height > 0;
+  };
+  const alphaOf = (c) => {
+    const m = c.match(/rgba?\(([^)]+)\)/);
+    if (!m) return c === "transparent" ? 0 : 1;
+    const parts = m[1].split(/[\s,/]+/).filter(Boolean);
+    return parts.length >= 4 ? parseFloat(parts[3]) : 1;
+  };
+  const painted = (c) => Boolean(c) && alphaOf(c) > 0.02;
+  const ownText = (el) => Array.from(el.childNodes).filter((n) => n.nodeType === 3).map((n) => n.nodeValue ?? "").join("").replace(/\s+/g, " ").trim();
+  const firstFamily = (stack) => (stack.split(",")[0] ?? "").replace(/["']/g, "").trim();
+  const px = (v) => parseFloat(v) || 0;
+  const bg = /* @__PURE__ */ new Map();
+  const text = /* @__PURE__ */ new Map();
+  const fonts = /* @__PURE__ */ new Map();
+  const sizes = /* @__PURE__ */ new Set();
+  const weights = /* @__PURE__ */ new Set();
+  const radii = /* @__PURE__ */ new Set();
+  const shadows = /* @__PURE__ */ new Set();
+  const spacing = [];
+  const pageArea = Math.max(1, document.documentElement.scrollHeight * vw);
+  for (const el of all) {
+    if (!shown(el)) continue;
+    const cs = style(el);
+    const b = box(el);
+    const area = Math.min(b.width * b.height, pageArea);
+    if (painted(cs.backgroundColor)) {
+      const e = bg.get(cs.backgroundColor) ?? { area: 0, chars: 0 };
+      e.area += area;
+      bg.set(cs.backgroundColor, e);
+    }
+    const own = ownText(el);
+    if (own.length > 1) {
+      const chars = own.length;
+      const t = text.get(cs.color) ?? { area: 0, chars: 0 };
+      t.chars += chars;
+      text.set(cs.color, t);
+      const family = firstFamily(cs.fontFamily);
+      const f = fonts.get(family) ?? { chars: 0, displayChars: 0, italicChars: 0, weights: /* @__PURE__ */ new Set() };
+      const size = px(cs.fontSize);
+      const weight = parseInt(cs.fontWeight, 10) || 400;
+      f.chars += chars;
+      if (/^H[1-3]$/.test(el.tagName) || size >= 28) f.displayChars += chars;
+      if (cs.fontStyle === "italic" || cs.fontStyle.startsWith("oblique")) f.italicChars += chars;
+      f.weights.add(weight);
+      fonts.set(family, f);
+      sizes.add(Math.round(size));
+      weights.add(weight);
+    }
+    if (/^(A|BUTTON|SECTION|ARTICLE|ASIDE)$/.test(el.tagName) || /card|panel|box|tile/i.test(typeof el.className === "string" ? el.className : "")) {
+      if (cs.borderRadius && cs.borderRadius !== "0px") radii.add(cs.borderRadius);
+      if (cs.boxShadow && cs.boxShadow !== "none") shadows.add(cs.boxShadow);
+    }
+    for (const prop of ["marginTop", "marginBottom", "paddingTop", "paddingBottom"]) {
+      const v = Math.round(px(cs[prop]));
+      if (v > 0 && v <= 200) spacing.push(v);
+    }
+  }
+  const htmlBg = getComputedStyle(document.documentElement).backgroundColor;
+  const bodyBg = getComputedStyle(document.body).backgroundColor;
+  const ground = painted(bodyBg) ? bodyBg : painted(htmlBg) ? htmlBg : "rgb(255, 255, 255)";
+  const headings = Array.from(document.querySelectorAll("h1, h2, h3")).filter(shown).slice(0, 60).map((h) => {
+    const cs = style(h);
+    const italic = cs.fontStyle !== "normal";
+    const italicPart = !italic && Array.from(h.querySelectorAll("*")).some((c) => style(c).fontStyle !== "normal" && (c.textContent ?? "").trim().length > 0);
+    return {
+      level: Number(h.tagName[1]),
+      family: firstFamily(cs.fontFamily),
+      sizePx: Math.round(px(cs.fontSize)),
+      weight: parseInt(cs.fontWeight, 10) || 400,
+      italic,
+      italicPart,
+      text: (h.textContent ?? "").replace(/\s+/g, " ").trim().slice(0, 120),
+      top: Math.round(box(h).top)
+    };
+  });
+  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;
+    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({
+      kind: isButton ? "button" : "link",
+      radiusPx: Math.round(radius),
+      heightPx: Math.round(b.height),
+      background: cs.backgroundColor,
+      text: label.slice(0, 60)
+    });
+    if (controls.length >= 200) break;
+  }
+  const anims = [];
+  const docAny = document;
+  for (const a of docAny.getAnimations ? docAny.getAnimations() : []) {
+    const effect = a.effect;
+    if (!effect) continue;
+    let translateX = false;
+    try {
+      translateX = effect.getKeyframes().some((k) => /translate(?:X|3d)?\(\s*-?[\d.]+(?:%|px)/.test(String(k.transform ?? "")) && !/translateY/.test(String(k.transform ?? "")));
+    } catch {
+      translateX = false;
+    }
+    anims.push({ target: effect.target, infinite: effect.getTiming().iterations === Infinity, translateX });
+  }
+  const marqueeTargets = anims.filter((a) => a.infinite && a.translateX && a.target).map((a) => a.target);
+  const root = document.querySelector("main") ?? document.body;
+  const blocks = [];
+  const pushBlocks = (parent, depth) => {
+    for (const child of Array.from(parent.children)) {
+      if (!shown(child) && !(style(child).opacity === "0")) continue;
+      const b = box(child);
+      if (b.height < 80 || b.width < vw * 0.5) continue;
+      const kids = Array.from(child.children).filter((k) => box(k).height >= 80 && box(k).width >= vw * 0.5);
+      const covered = kids.reduce((n, k) => n + box(k).height, 0);
+      const wrapper = depth < 6 && !/^(SECTION|ARTICLE|HEADER|FOOTER|ASIDE|NAV)$/.test(child.tagName) && (kids.length === 1 && box(kids[0]).height >= b.height * 0.8 || kids.length >= 2 && covered >= b.height * 0.6);
+      if (wrapper) pushBlocks(child, depth + 1);
+      else blocks.push(child);
+    }
+  };
+  pushBlocks(root, 0);
+  const header = document.querySelector("body > header, header");
+  const h1 = document.querySelector("h1");
+  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 : "");
+    });
+  };
+  const cardsIn = (section) => {
+    let best = { cards: 0, iconCards: 0 };
+    const containers = [section, ...Array.from(section.querySelectorAll("div, ul, ol"))].slice(0, 300);
+    for (const c of containers) {
+      const kids = Array.from(c.children).filter(shown);
+      if (kids.length < 3) continue;
+      const boxes = kids.map(box);
+      const row = boxes.filter((b) => Math.abs(b.top - boxes[0].top) < 12);
+      if (row.length < 3) continue;
+      const w = row.map((b) => b.width);
+      if (Math.max(...w) > Math.min(...w) * 1.35 || Math.max(...w) > vw * 0.45) continue;
+      const withText = kids.filter((k) => (k.textContent ?? "").trim().length > 12);
+      if (withText.length < 3) continue;
+      const iconCards = withText.filter((k) => {
+        const first = k.querySelector("svg, img");
+        if (!first) return false;
+        const fb = box(first);
+        const kb = box(k);
+        return fb.width <= 72 && fb.height <= 72 && fb.top - kb.top < 120;
+      }).length;
+      if (withText.length > best.cards) best = { cards: withText.length, iconCards };
+    }
+    return best;
+  };
+  const sections = blocks.slice(0, 40).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);
+    const images = Array.from(el.querySelectorAll("img, svg")).filter((i) => shown(i) && box(i).height <= 90);
+    const textChars = (el.textContent ?? "").replace(/\s+/g, "").length;
+    const numbers = Array.from(el.querySelectorAll("*")).filter((n) => /^[£$€]?\d[\d,.]*\s?(?:[%+kKmM★]|\/5|\+)?$/.test(ownText(n)) && px(style(n).fontSize) >= 24).length;
+    const { cards, iconCards } = cardsIn(el);
+    let kind = "text";
+    if (marqueeTargets.some((t) => el.contains(t))) kind = "marquee";
+    else if (h1 && el.contains(h1) || index === 0 && b.top < vh) kind = "hero";
+    else if (images.length >= 4 && textChars < 300) kind = "logos";
+    else if (numbers >= 3 && textChars < 600) kind = "stats";
+    else if (cards >= 3) kind = "cards";
+    return {
+      top: Math.round(b.top),
+      height: Math.round(b.height),
+      kind,
+      label,
+      cards,
+      iconCards,
+      hiddenAtLoad: b.top > vh && hiddenAtLoad(el)
+    };
+  });
+  if (header && sections.length === 0) {
+    const b = box(header);
+    sections.push({ top: Math.round(b.top), height: Math.round(b.height), kind: "hero", label: "", cards: 0, iconCards: 0, hiddenAtLoad: false });
+  }
+  const colourStops = (image) => image.match(/rgba?\([^)]*\)|#[0-9a-f]{3,8}\b/gi) ?? [];
+  const effects = {
+    glass: 0,
+    gradientText: 0,
+    gradients: [],
+    glows: 0,
+    gridBackgrounds: 0,
+    marquees: new Set(marqueeTargets).size,
+    hairlineShadowCards: 0,
+    eyebrowChip: false
+  };
+  for (const el of all) {
+    if (!shown(el)) continue;
+    const cs = style(el);
+    const b = box(el);
+    const area = b.width * b.height;
+    const backdrop = cs.backdropFilter || cs.webkitBackdropFilter || "";
+    if (/blur\(\s*[1-9]/.test(backdrop) && alphaOf(cs.backgroundColor) < 0.95 && b.width >= 200 && b.height >= 120 && cs.position !== "fixed" && cs.position !== "sticky" && !el.closest("header, nav, [role=dialog], dialog")) {
+      effects.glass += 1;
+    }
+    const image = cs.backgroundImage || "";
+    const clip = cs.backgroundClip || cs.webkitBackgroundClip || "";
+    if (clip === "text" && /gradient/.test(image)) effects.gradientText += 1;
+    if (/gradient/.test(image)) {
+      const size = cs.backgroundSize || "";
+      const small = /(?:^|\s)(?:[1-9]|[1-5]\d|6[0-4])px/.test(size);
+      const lines = (image.match(/linear-gradient/g) ?? []).length;
+      if (small && (lines >= 2 || /radial-gradient/.test(image)) || /repeating-linear-gradient/.test(image)) {
+        effects.gridBackgrounds += 1;
+      } else if (area >= vw * vh * 0.05) {
+        effects.gradients.push({ stops: colourStops(image), area: Math.round(area), radial: /radial-gradient/.test(image) });
+      }
+    }
+    const blur = (cs.filter || "").match(/blur\(\s*([\d.]+)px/);
+    if ((blur && parseFloat(blur[1]) >= 40 || /radial-gradient/.test(image) && !/(?:^|\s)\d{1,2}px/.test(cs.backgroundSize || "")) && area >= 4e4 && (el.textContent ?? "").trim().length === 0) {
+      effects.glows += 1;
+    }
+    const shadow = cs.boxShadow || "";
+    const shadowBlur = shadow.match(/(?:-?[\d.]+px\s+){2}([\d.]+)px/);
+    if (shadowBlur && parseFloat(shadowBlur[1]) >= 24 && px(cs.borderTopWidth) >= 1 && alphaOf(cs.borderTopColor) <= 0.2 && area >= 2e4) {
+      effects.hairlineShadowCards += 1;
+    }
+  }
+  if (h1) {
+    let prev = h1.previousElementSibling;
+    if (!prev && h1.parentElement) prev = h1.parentElement.previousElementSibling;
+    if (prev && shown(prev)) {
+      const cs = style(prev);
+      const b = box(prev);
+      const pill = b.height <= 44 && px(cs.borderTopLeftRadius) >= b.height / 2 - 1;
+      const drawn = painted(cs.backgroundColor) || px(cs.borderTopWidth) >= 1;
+      const chip = pill && drawn ? prev : Array.from(prev.querySelectorAll("*")).find((c) => {
+        const ccs = style(c);
+        const cb = box(c);
+        return cb.height <= 44 && px(ccs.borderTopLeftRadius) >= cb.height / 2 - 1 && (painted(ccs.backgroundColor) || px(ccs.borderTopWidth) >= 1);
+      });
+      effects.eyebrowChip = Boolean(chip && (chip.textContent ?? "").trim().length > 0 && (chip.textContent ?? "").trim().length <= 48);
+    }
+  }
+  const onScale = spacing.filter((v) => v % 4 === 0).length;
+  let bodyLineLengthCh = null;
+  let bodyFontSizePx = null;
+  const para = Array.from(document.querySelectorAll("p")).find((p) => shown(p) && (p.innerText || "").trim().split(/\s+/).length > 20);
+  if (para) {
+    const cs = style(para);
+    bodyFontSizePx = Math.round(px(cs.fontSize));
+    const probe = document.createElement("span");
+    probe.style.cssText = `font:${cs.font};visibility:hidden;position:absolute;white-space:pre`;
+    probe.textContent = "abcdefghijklmnopqrstuvwxyz";
+    document.body.appendChild(probe);
+    const avg = probe.getBoundingClientRect().width / 26;
+    probe.remove();
+    const width = para.getBoundingClientRect().width - px(cs.paddingLeft) - px(cs.paddingRight);
+    if (avg > 0 && width > 0) bodyLineLengthCh = Math.round(width / avg);
+  }
+  const toList = (m) => Array.from(m, ([value, v]) => ({ value, area: Math.round(v.area), chars: v.chars })).sort((a, b) => b.area - a.area || b.chars - a.chars);
+  const nums = (s) => Array.from(s).sort((a, b) => a - b);
+  return {
+    viewport: { width: vw, height: vh },
+    pageHeight: document.documentElement.scrollHeight,
+    ground,
+    colours: { backgrounds: toList(bg).slice(0, 60), text: toList(text).sort((a, b) => b.chars - a.chars).slice(0, 40) },
+    fonts: Array.from(fonts, ([family, f]) => ({ family, chars: f.chars, displayChars: f.displayChars, italicChars: f.italicChars, weights: nums(f.weights) })).sort((a, b) => b.chars - a.chars),
+    headings,
+    controls,
+    sections,
+    effects,
+    motion: {
+      hiddenSections: sections.filter((s) => s.hiddenAtLoad).length,
+      sections: sections.length,
+      animations: anims.length
+    },
+    metrics: {
+      fontSizes: nums(sizes),
+      fontWeights: nums(weights),
+      radii: Array.from(radii).sort(),
+      shadows: Array.from(shadows).sort().slice(0, 20),
+      spacingOnScalePct: spacing.length ? Math.round(onScale / spacing.length * 1e3) / 10 : null,
+      bodyLineLengthCh,
+      bodyFontSizePx
+    }
+  };
+}
+function overlayInPage() {
+  const vw = window.innerWidth;
+  const vh = window.innerHeight;
+  for (const el of Array.from(document.body.querySelectorAll("*")).slice(0, 4e3)) {
+    const cs = getComputedStyle(el);
+    if (cs.position !== "fixed" && cs.position !== "absolute") continue;
+    if (cs.display === "none" || cs.visibility === "hidden" || parseFloat(cs.opacity) < 0.5) continue;
+    const r = el.getBoundingClientRect();
+    if (r.width < vw * 0.9 || r.height < vh * 0.9 || r.top > 10) continue;
+    const bg = cs.backgroundColor;
+    const alpha = /rgba?\(([^)]+)\)/.test(bg) ? parseFloat((bg.match(/[\d.]+/g) ?? [])[3] ?? "1") : 0;
+    if (alpha > 0.8 || /gradient|url\(/.test(cs.backgroundImage)) return true;
+  }
+  return false;
+}
+
+// src/audit/index.ts
+async function loadPlaywright() {
+  for (const name of ["playwright", "playwright-core"]) {
+    try {
+      return await import(
+        /* @vite-ignore */
+        name
+      );
+    } catch {
+    }
+  }
+  throw new Error("craft audit needs a browser. Install one: npm i -D playwright && npx playwright install chromium");
+}
+async function snapshotPage(page, url, options = {}) {
+  const early = await page.evaluate(overlayInPage).catch(() => false);
+  await page.waitForTimeout(options.introWindowMs ?? 5e3);
+  const late = await page.evaluate(overlayInPage).catch(() => false);
+  const data = await page.evaluate(collectInPage);
+  return {
+    version: SNAPSHOT_VERSION,
+    url,
+    capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...data,
+    motion: { ...data.motion, introOverlay: early && !late }
+  };
+}
+async function snapshotUrl(url, options = {}) {
+  const pw = await loadPlaywright();
+  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 } } : {} });
+  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);
+  } finally {
+    await browser.close();
+  }
+}
+
+// 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 readSnapshot(path) {
+  const data = JSON.parse(readFileSync(path, "utf8"));
+  if (data.version !== SNAPSHOT_VERSION) throw new Error(`${path} is snapshot version ${String(data.version)}; this craft reads ${SNAPSHOT_VERSION}`);
+  return data;
+}
+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 (!target) throw new Error(`usage: craft ${command} <url${command === "audit" ? " | snapshot.json" : ""}>`);
+    const viewport = flags.width || flags.height ? { width: Number(flags.width ?? 1440), height: Number(flags.height ?? 900) } : void 0;
+    const local = resolve(io.cwd, target);
+    const snapshot = command === "audit" && /\.json$/i.test(target) && existsSync(local) ? readSnapshot(local) : await snapshotUrl(target, { viewport });
+    if (flags.out) writeFileSync(resolve(io.cwd, flags.out), `${JSON.stringify(snapshot, null, 2)}
+`);
+    if (command === "snapshot") {
+      if (!flags.out) io.out(JSON.stringify(snapshot, null, 2));
+      else io.out(`craft snapshot: ${snapshot.url} saved to ${flags.out}`);
+      return 0;
+    }
+    const exceptions = loadExceptions(flags, flags.repo ? resolve(io.cwd, flags.repo) : io.cwd);
+    let report = auditSnapshot(snapshot, { exceptions });
+    if (flags.repo) {
+      const repo = resolve(io.cwd, flags.repo);
+      report = merge(scanSource(readPaths(["."], repo, SOURCE_FILE), { exceptions }), report);
+    }
+    const fp = fingerprint(snapshot);
+    if (flags.json) {
+      io.out(JSON.stringify({ report, fingerprint: fp, snapshot: flags.out ?? null }, null, 2));
+      return report.summary.blocking > 0 || flags.strict && report.summary.findings > 0 ? 1 : 0;
+    }
+    const code = finish(report, { ...flags, json: false }, `craft audit ${snapshot.url}`, io);
+    io.out("");
+    io.out(describeFingerprint(fp));
+    return code;
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
+export {
+  describeFingerprint,
+  runAudit
+};