@domandigital/craft 0.11.0 → 0.12.0

package/dist/{chunk-JP75P2DU.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) {
@@ -413,6 +578,7 @@ async function audit(url, options = {}) {
 export {
   collectInPage,
   overlayInPage,
+  VISUAL_MAX_HEIGHT,
   loadPlaywright,
   snapshotPage,
   snapshotUrl,

package/dist/chunk-ZKVJ7K6X.js

@@ -0,0 +1,19 @@
+import {
+  SNAPSHOT_VERSION
+} from "./chunk-AL6MRG6V.js";
+
+// src/snapshot/migrate.ts
+var READABLE_SNAPSHOT_VERSIONS = [1, 2];
+function readSnapshot(data, source = "snapshot") {
+  const v = data?.version;
+  if (typeof data !== "object" || data === null || !READABLE_SNAPSHOT_VERSIONS.includes(v)) {
+    throw new Error(`${source} is not a snapshot this craft reads (version ${String(v)}; reads ${READABLE_SNAPSHOT_VERSIONS.join(" and ")})`);
+  }
+  const snap = data;
+  if (snap.version === 1) return { ...snap, version: SNAPSHOT_VERSION, migratedFrom: 1 };
+  return snap;
+}
+
+export {
+  readSnapshot
+};

package/dist/cli-2DY3V3SF.js

@@ -0,0 +1,17 @@
+import {
+  formatMatches,
+  formatPairs,
+  loadEstate,
+  runEstate
+} from "./chunk-CDAJUS5U.js";
+import "./chunk-LHGY43LL.js";
+import "./chunk-ZKVJ7K6X.js";
+import "./chunk-J3QUROJ5.js";
+import "./chunk-PZ4MF2VV.js";
+import "./chunk-AL6MRG6V.js";
+export {
+  formatMatches,
+  formatPairs,
+  loadEstate,
+  runEstate
+};

package/dist/{cli-4ESXOLKV.js → cli-C3JLFXMG.js}

@@ -6,10 +6,11 @@ import {
   nullPath,
   runHarvest,
   runNull
-} from "./chunk-3OZQ4C5R.js";
-import "./chunk-2AJB27BJ.js";
-import "./chunk-QMYERCBB.js";
-import "./chunk-3NGWXZZE.js";
+} from "./chunk-LHGY43LL.js";
+import "./chunk-ZKVJ7K6X.js";
+import "./chunk-J3QUROJ5.js";
+import "./chunk-PZ4MF2VV.js";
+import "./chunk-AL6MRG6V.js";
 export {
   describeTypicality,
   formatHarvest,

package/dist/cli-QM2AQQMF.js

@@ -0,0 +1,19 @@
+import {
+  describeFingerprint,
+  merge,
+  resolvePages,
+  runAudit
+} from "./chunk-PU5G5DUC.js";
+import "./chunk-ULPI335S.js";
+import "./chunk-JYNXGCYZ.js";
+import "./chunk-LHGY43LL.js";
+import "./chunk-ZKVJ7K6X.js";
+import "./chunk-J3QUROJ5.js";
+import "./chunk-PZ4MF2VV.js";
+import "./chunk-AL6MRG6V.js";
+export {
+  describeFingerprint,
+  merge,
+  resolvePages,
+  runAudit
+};

package/dist/{cli-DBZMVYYV.js → cli-ZB2VJ7CY.js}

@@ -1,19 +1,23 @@
 import {
   validateDirection
-} from "./chunk-JWHC67ZS.js";
+} from "./chunk-S3NZAVU6.js";
 import {
   merge
-} from "./chunk-MSQ57PJU.js";
-import "./chunk-JP75P2DU.js";
+} from "./chunk-PU5G5DUC.js";
+import "./chunk-ULPI335S.js";
+import "./chunk-JYNXGCYZ.js";
 import {
   SIBLING_AT,
   compareToEstate,
   loadEstate
-} from "./chunk-HOHHQB4N.js";
+} from "./chunk-CDAJUS5U.js";
 import {
   loadNull,
   typicality
-} from "./chunk-3OZQ4C5R.js";
+} from "./chunk-LHGY43LL.js";
+import {
+  readSnapshot
+} from "./chunk-ZKVJ7K6X.js";
 import {
   COPY_FILE,
   NOT_COPY_DIR,
@@ -24,17 +28,16 @@ import {
   parseFlags,
   readPaths,
   toJson
-} from "./chunk-2AJB27BJ.js";
+} from "./chunk-J3QUROJ5.js";
 import {
   fingerprint
-} from "./chunk-QMYERCBB.js";
+} from "./chunk-PZ4MF2VV.js";
 import {
   CATALOGUE,
-  SNAPSHOT_VERSION,
   auditSnapshot,
   checkCopy,
   scanSource
-} from "./chunk-3NGWXZZE.js";
+} from "./chunk-AL6MRG6V.js";
 
 // src/report/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -259,10 +262,9 @@ async function runReport(command, args, io) {
     const local = resolve(io.cwd, target2);
     let snap;
     if (/\.json$/i.test(target2) && existsSync(local)) {
-      snap = JSON.parse(readFileSync(local, "utf8"));
-      if (snap.version !== SNAPSHOT_VERSION) throw new Error(`${target2} is not a snapshot`);
+      snap = readSnapshot(JSON.parse(readFileSync(local, "utf8")), target2);
     } else {
-      const { snapshotUrl } = await import("./audit-QIPXL7E4.js");
+      const { snapshotUrl } = await import("./audit-5QWFLZ6L.js");
       snap = await snapshotUrl(target2);
     }
     const fp = fingerprint(snap);

package/dist/{cli-U3SZVHSK.js → cli-ZPJIWVEP.js}

@@ -1,14 +1,20 @@
 import {
   DIRECTION_VERSION,
   validateDirection
-} from "./chunk-JWHC67ZS.js";
+} from "./chunk-S3NZAVU6.js";
+import {
+  decodePng
+} from "./chunk-JYNXGCYZ.js";
+import {
+  readSnapshot
+} from "./chunk-ZKVJ7K6X.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-2AJB27BJ.js";
+} from "./chunk-J3QUROJ5.js";
 import {
   fingerprint
-} from "./chunk-QMYERCBB.js";
+} from "./chunk-PZ4MF2VV.js";
 import {
   deltaEOk,
   formatHex,
@@ -17,7 +23,7 @@ import {
   isCream,
   oklchToRgb,
   parseColour
-} from "./chunk-3NGWXZZE.js";
+} from "./chunk-AL6MRG6V.js";
 
 // src/direction/cli.ts
 import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
@@ -50,78 +56,6 @@ function initDirection(input) {
   };
 }
 
-// src/direction/png.ts
-import { inflateSync } from "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 = 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/direction/propose.ts
 var PROPOSED = "PROPOSED:";
 function srgbToLinear(c) {
@@ -253,8 +187,8 @@ function estateFrom(dir, cwd) {
   }
   return readdirSync(root).filter((f) => f.endsWith(".json")).flatMap((f) => {
     try {
-      const snap = readJson(join(root, f));
-      return snap.version === 1 && snap.fonts ? [{ id: f.replace(/(\.snapshot)?\.json$/, ""), fingerprint: fingerprint(snap) }] : [];
+      const snap = readSnapshot(readJson(join(root, f)), f);
+      return snap.fonts ? [{ id: f.replace(/(\.snapshot)?\.json$/, ""), fingerprint: fingerprint(snap) }] : [];
     } catch {
       return [];
     }

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-2AJB27BJ.js";
-import "./chunk-3NGWXZZE.js";
+} from "./chunk-J3QUROJ5.js";
+import "./chunk-AL6MRG6V.js";
 
 // src/cli.ts
 process.stdout.on("error", (error) => {