@domandigital/craft 0.11.0 → 0.13.0

package/dist/{chunk-MSQ57PJU.js → chunk-IMB4V34S.js}

@@ -1,12 +1,14 @@
 import {
   snapshotUrl,
   snapshotUrls
-} from "./chunk-JP75P2DU.js";
+} from "./chunk-ZLDA2SYB.js";
 import {
   describeTypicality,
-  loadNull,
-  typicality
-} from "./chunk-3OZQ4C5R.js";
+  loadNull
+} from "./chunk-ESCVTKPN.js";
+import {
+  readSnapshot
+} from "./chunk-CZDOMIVS.js";
 import {
   SOURCE_FILE,
   finish,
@@ -16,15 +18,14 @@ import {
   prepareReport,
   readPaths,
   toJson
-} from "./chunk-2AJB27BJ.js";
-import {
-  fingerprint
-} from "./chunk-QMYERCBB.js";
+} from "./chunk-3VTPI7BU.js";
 import {
-  SNAPSHOT_VERSION,
   auditSnapshot,
-  scanSource
-} from "./chunk-3NGWXZZE.js";
+  componentTypicalities,
+  fingerprint,
+  scanSource,
+  typicality
+} from "./chunk-GMVXADJ6.js";
 
 // src/audit/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -49,6 +50,12 @@ function parseViewports(value) {
 }
 
 // src/audit/cli.ts
+function describeComponents(components, pageMeasured, nullMeasured) {
+  if (!pageMeasured) return "  components  not measured: the page's snapshot predates version 2";
+  if (!nullMeasured) return "  components  not measured: the null model predates snapshot version 2; rebuild it to compare components";
+  if (components.length === 0) return "  components  none the null model has enough pages of to compare";
+  return components.map((c, i) => `${i === 0 ? "  components" : "            "}  ${c.role.padEnd(13)} ${c.score.toFixed(2)}: ${c.typical ? "typical" : "not typical"} (${c.runs} null pages have one)`).join("\n");
+}
 var fmt = (o) => o ? `oklch(${o.l.toFixed(3)} ${o.c.toFixed(3)} ${o.h.toFixed(1)})` : "none";
 function describeFingerprint(fp) {
   return [
@@ -81,10 +88,8 @@ function merge(a, b) {
     }
   };
 }
-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;
+function readSnapshotFile(path) {
+  return readSnapshot(JSON.parse(readFileSync(path, "utf8")), path);
 }
 async function readText(source, cwd) {
   if (/^https?:\/\//i.test(source)) {
@@ -123,7 +128,7 @@ async function runAudit(command, args, io) {
     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: readSnapshot(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 });
@@ -167,11 +172,17 @@ ${failed.map((f) => `  ${f.url}: ${f.error}`).join("\n")}`);
     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 };
+      return {
+        url: a.snapshot.url,
+        viewport: a.viewport,
+        fingerprint: fp,
+        typicality: nulls.length ? typicality(fp, pooled) : null,
+        components: nulls.length ? componentTypicalities(fp, pooled) : []
+      };
     });
     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 } : {};
+      const extra = single ? { fingerprint: pages[0].fingerprint, typicality: pages[0].typicality, components: pages[0].components, 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);
     }
@@ -184,6 +195,7 @@ ${failed.map((f) => `  ${f.url}: ${f.error}`).join("\n")}`);
       if (page.typicality) {
         io.out("");
         io.out(describeTypicality(page.typicality, pooled.length, nulls.length));
+        io.out(describeComponents(page.components, page.fingerprint.sections !== void 0, pooled.some((r) => r.fingerprint.sections !== void 0)));
       }
     }
     if (failed.length) {
@@ -199,6 +211,7 @@ ${failed.map((f) => `  ${f.url}: ${f.error}`).join("\n")}`);
 }
 
 export {
+  describeComponents,
   describeFingerprint,
   merge,
   resolvePages,

package/dist/chunk-JYNXGCYZ.js

@@ -0,0 +1,75 @@
+// 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 };
+}
+
+export {
+  decodePng
+};

package/dist/{chunk-HOHHQB4N.js → chunk-K2BZN4GA.js}

@@ -1,21 +1,24 @@
 import {
-  groundName,
-  hueName,
-  loadNull,
-  shapeName
-} from "./chunk-3OZQ4C5R.js";
+  loadNull
+} from "./chunk-ESCVTKPN.js";
+import {
+  readSnapshot
+} from "./chunk-CZDOMIVS.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-2AJB27BJ.js";
+} from "./chunk-3VTPI7BU.js";
 import {
+  COMPONENT_ROLES,
+  auditSnapshot,
+  closestComponents,
+  estateComponentPairs,
   fingerprint,
-  fingerprintDistance
-} from "./chunk-QMYERCBB.js";
-import {
-  SNAPSHOT_VERSION,
-  auditSnapshot
-} from "./chunk-3NGWXZZE.js";
+  fingerprintDistance,
+  groundName,
+  hueName,
+  shapeName
+} from "./chunk-GMVXADJ6.js";
 
 // src/estate/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -78,7 +81,7 @@ function siblingLine(briefs) {
 }
 
 // src/estate/cli.ts
-var USAGE = "usage: craft estate add <url | snapshot.json> --id <id> [--client <name>] | craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--json] [--strict]";
+var USAGE = "usage: craft estate add <url | snapshot.json> --id <id> [--client <name>] | craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--component <role>] [--json] [--strict]";
 function loadEstate(path) {
   if (!existsSync(path)) return emptyEstate();
   const data = JSON.parse(readFileSync(path, "utf8"));
@@ -88,12 +91,11 @@ function loadEstate(path) {
 async function snapshotOf(target, cwd) {
   const local = resolve(cwd, target);
   if (/\.json$/i.test(target) && existsSync(local)) {
-    const snap = JSON.parse(readFileSync(local, "utf8"));
-    if (snap.version !== SNAPSHOT_VERSION) throw new Error(`${target} is not a snapshot`);
+    const snap = readSnapshot(JSON.parse(readFileSync(local, "utf8")), target);
     return snap;
   }
   if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL, a snapshot file, nor a site in the register`);
-  const { snapshotUrl } = await import("./audit-QIPXL7E4.js");
+  const { snapshotUrl } = await import("./audit-5TYDYRXV.js");
   return snapshotUrl(target);
 }
 var line = (distance, sibling, shared) => `${distance.toFixed(2)}${sibling ? "  SIBLING" : ""}${shared.length ? `  shares ${shared.join(", ")}` : ""}`;
@@ -109,6 +111,21 @@ function formatPairs(pairs, at, sites) {
   for (const p of pairs) lines.push(`  ${`${p.a} + ${p.b}`.padEnd(34)} ${line(p.distance, p.sibling, p.shared)}`);
   return lines.join("\n");
 }
+function componentRole(name) {
+  if (!COMPONENT_ROLES.includes(name)) throw new Error(`--component takes one of ${COMPONENT_ROLES.join(", ")}`);
+  return name;
+}
+var withRole = (register, role) => register.sites.filter((s) => (s.fingerprint.sections ?? []).some((x) => x.role === role)).length;
+function formatComponentPairs(role, pairs, measured, sites) {
+  const lines = [`craft estate: ${role} components, ${measured} of ${sites} sites have one, closest pairs first (no sibling line yet: ranked, not judged)`];
+  for (const p of pairs) lines.push(`  ${`${p.a} + ${p.b}`.padEnd(34)} ${p.distance.toFixed(2)}${p.shared.length ? `  shares ${p.shared.join(", ")}` : ""}`);
+  if (pairs.length === 0) {
+    lines.push(
+      measured < 2 ? `  fewer than two sites have a ${role} section measured. Roles come from snapshot version 2: re-add the sites from a fresh snapshot.` : "  no pairs"
+    );
+  }
+  return lines.join("\n");
+}
 async function runEstate(args, io) {
   try {
     const flags = parseFlags(args);
@@ -135,6 +152,24 @@ async function runEstate(args, io) {
       io.out(formatMatches(flags.id, compareToEstate(fp, next, { exclude: flags.id, siblingAt: at }).slice(0, 3), at));
       return 0;
     }
+    if (sub === "compare" && flags.component) {
+      const role = componentRole(flags.component);
+      if (!target) {
+        const pairs2 = estateComponentPairs(register, role);
+        const measured = withRole(register, role);
+        io.out(flags.json ? toJson({ role, measured, sites: register.sites.length, pairs: pairs2 }) : formatComponentPairs(role, pairs2, measured, register.sites.length));
+        return 0;
+      }
+      const known = register.sites.find((s) => s.id === target);
+      const fp = known ? known.fingerprint : fingerprint(await snapshotOf(target, io.cwd));
+      if (!(fp.sections ?? []).some((x) => x.role === role)) throw new Error(`${known?.id ?? target} has no ${role} section measured (roles need snapshot version 2)`);
+      const pairs = register.sites.filter((s) => s.id !== known?.id).flatMap((s) => {
+        const c = closestComponents(fp, s.fingerprint, role);
+        return c ? [{ a: known?.id ?? target, b: s.id, ...c }] : [];
+      }).sort((x, y) => x.distance - y.distance);
+      io.out(flags.json ? toJson({ role, measured: withRole(register, role), sites: register.sites.length, pairs }) : formatComponentPairs(role, pairs, withRole(register, role), register.sites.length));
+      return 0;
+    }
     if (sub === "compare") {
       if (!target) {
         const pairs = estatePairs(register, at);
@@ -160,5 +195,6 @@ export {
   loadEstate,
   formatMatches,
   formatPairs,
+  formatComponentPairs,
   runEstate
 };