@domandigital/craft 0.6.0 → 0.7.0

package/dist/chunk-IQTZWNEK.js

@@ -0,0 +1,112 @@
+import {
+  snapshotUrl
+} from "./chunk-OA7SGPN4.js";
+import {
+  describeTypicality,
+  loadNull,
+  typicality
+} from "./chunk-GV3QOTQU.js";
+import {
+  SOURCE_FILE,
+  finish,
+  loadExceptions,
+  parseFlags,
+  readPaths
+} from "./chunk-YYC4EGER.js";
+import {
+  fingerprint
+} from "./chunk-Q54JSNC5.js";
+import {
+  SNAPSHOT_VERSION,
+  auditSnapshot,
+  scanSource
+} from "./chunk-3AP4PJMX.js";
+
+// src/audit/cli.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+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);
+    const nulls = flags.null ? flags.null.split(",").map((p) => loadNull(p.trim(), io.cwd)) : [];
+    const typical = nulls.length ? typicality(fp, nulls.flatMap((m, i) => m.runs.map((r) => nulls.length > 1 ? { ...r, id: `${i + 1}/${r.id}` } : r))) : null;
+    if (flags.json) {
+      io.out(JSON.stringify({ report, fingerprint: fp, typicality: typical, 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));
+    if (typical) {
+      io.out("");
+      io.out(describeTypicality(typical, nulls.reduce((s, m) => s + m.runs.length, 0), nulls.length));
+    }
+    return code;
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
+
+export {
+  describeFingerprint,
+  merge,
+  runAudit
+};

package/dist/chunk-J2BOAIHJ.js

@@ -0,0 +1,175 @@
+import {
+  REFLEX_FONTS_1,
+  REFLEX_FONTS_2,
+  deltaEOk,
+  isAiViolet,
+  isCream,
+  normaliseFamily,
+  parseColour
+} from "./chunk-3AP4PJMX.js";
+
+// src/direction/types.ts
+var DIRECTION_VERSION = 1;
+var SOURCE_KINDS = [
+  "livery",
+  "shopfront",
+  "signage",
+  "packaging",
+  "product",
+  "uniform",
+  "interior",
+  "place",
+  "material",
+  "trade",
+  "print",
+  "photo",
+  "founder"
+];
+var CHOICE_KEYS = ["accent", "ground", "display", "body", "shape", "motif", "signature"];
+
+// src/direction/validate.ts
+var PREFERENCE = /\b(?:client (?:likes|liked|wants|wanted|asked|chose|prefers?)|(?:we|they|i) (?:like|liked|love|loved|prefer)|on[- ]trend|trendy|popular|what (?:everyone|competitors) (?:uses?|does)|brand (?:colou?r|font|guidelines?) (?:is|are|says?))\b/i;
+var MOOD = /\b(?:modern|clean|fresh|professional|trustworthy|premium|elegant|sleek|timeless|minimal(?:ist)?|bold|vibrant|friendly|approachable|luxur(?:y|ious)|sophisticated|contemporary|stylish|warm|inviting|high[- ]end)\b/gi;
+var VALUE_WORDS = /* @__PURE__ */ new Set(["green", "blue", "navy", "black", "white", "cream", "grey", "gray", "gold", "yellow", "orange", "purple", "violet", "pink", "brown", "teal", "bottle", "dark", "light", "deep", "pale", "bright", "colour", "color", "font", "face", "serif", "sans", "type", "lettering"]);
+var STOP = /* @__PURE__ */ new Set(["with", "that", "this", "from", "their", "they", "have", "been", "were", "which", "what", "when", "where", "there", "about", "into", "onto", "over", "same", "each", "every"]);
+function words(text) {
+  return new Set((text.toLowerCase().match(/[a-z][a-z'-]{3,}/g) ?? []).map((w) => w.replace(/'s$/, "")).filter((w) => !STOP.has(w) && !VALUE_WORDS.has(w)));
+}
+function tellFor(key, value) {
+  if (key === "accent") {
+    const c = parseColour(value);
+    return c && isAiViolet(c.oklch) ? "ai-violet" : null;
+  }
+  if (key === "ground") {
+    const c = parseColour(value);
+    return c && isCream(c.oklch) ? "cream-palette" : null;
+  }
+  if (key === "display" || key === "body") {
+    const name = normaliseFamily(value).toLowerCase();
+    if (REFLEX_FONTS_1.some((f) => f.toLowerCase() === name)) return "reflex-font";
+    if (REFLEX_FONTS_2.some((f) => f.toLowerCase() === name)) return "reflex-font-2";
+  }
+  return null;
+}
+function validateDirection(input, ctx = {}) {
+  const problems = [];
+  const err = (at, message) => problems.push({ severity: "error", at, message });
+  const warn = (at, message) => problems.push({ severity: "warn", at, message });
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    err("", "art-direction.json must be a JSON object");
+    return { valid: false, problems, decided: 0 };
+  }
+  const d = input;
+  const legacy = d.version === void 0 && d.choices === void 0 && Array.isArray(d.exceptions);
+  if (legacy) {
+    warn("", "exceptions only: run craft direction init to record the choices and their reasons");
+    return { valid: true, problems, decided: 0 };
+  }
+  if (d.version !== DIRECTION_VERSION) err("version", `version must be ${DIRECTION_VERSION}`);
+  if (typeof d.client !== "string" || !d.client.trim()) err("client", "name the client");
+  if (typeof d.brief !== "string" || d.brief.trim().split(/\s+/).length < 8) err("brief", "the brief needs a sentence: who, where, and what they do");
+  const sources = Array.isArray(d.sources) ? d.sources : [];
+  if (!Array.isArray(d.sources)) err("sources", "sources must be a list");
+  if (sources.length === 0) err("sources", "no sources: a reason needs something in the client's world to point at");
+  const ids = /* @__PURE__ */ new Set();
+  sources.forEach((s, i) => {
+    const at = `sources[${i}]`;
+    if (!s || typeof s !== "object") return err(at, "a source must be an object");
+    if (typeof s.id !== "string" || !/^[a-z0-9][a-z0-9-]*$/.test(s.id)) err(`${at}.id`, "id must be short kebab-case");
+    else if (ids.has(s.id)) err(`${at}.id`, `"${s.id}" is used twice`);
+    else ids.add(s.id);
+    if (!SOURCE_KINDS.includes(s.kind)) err(`${at}.kind`, `kind must be one of: ${SOURCE_KINDS.join(", ")}`);
+    if (typeof s.note !== "string" || s.note.trim().split(/\s+/).length < 3) err(`${at}.note`, "say what it is and where");
+    if (s.path && ctx.pathExists && !/^https?:/.test(s.path) && !ctx.pathExists(s.path)) err(`${at}.path`, `${s.path} does not exist`);
+    for (const [j, c] of (s.colours ?? []).entries()) if (!parseColour(c)) err(`${at}.colours[${j}]`, `"${c}" is not a colour`);
+  });
+  const choices = d.choices && typeof d.choices === "object" ? d.choices : {};
+  if (!d.choices || typeof d.choices !== "object") err("choices", "choices must be an object");
+  const exceptions = Array.isArray(d.exceptions) ? d.exceptions : [];
+  let decided = 0;
+  for (const key of Object.keys(choices)) {
+    if (!CHOICE_KEYS.includes(key)) err(`choices.${key}`, `not a choice craft knows. Choices are: ${CHOICE_KEYS.join(", ")}. Layout and navigation stay conventional.`);
+  }
+  for (const key of CHOICE_KEYS) {
+    const c = choices[key];
+    const at = `choices.${key}`;
+    if (!c) {
+      warn(at, "not decided yet");
+      continue;
+    }
+    let ok = true;
+    if (typeof c.value !== "string" || !c.value.trim()) {
+      err(`${at}.value`, "no value");
+      ok = false;
+    } else if ((key === "accent" || key === "ground") && !parseColour(c.value)) {
+      err(`${at}.value`, `"${c.value}" is not a colour`);
+      ok = false;
+    }
+    const because = typeof c.because === "string" ? c.because.trim() : "";
+    const evidence = Array.isArray(c.evidence) ? c.evidence : [];
+    if (because.split(/\s+/).filter(Boolean).length < 8) {
+      err(`${at}.because`, "a reason is at least a sentence. Without one this is a default, however good it looks.");
+      ok = false;
+    } else if (because.startsWith("PROPOSED:")) {
+      err(`${at}.because`, "a proposal, not yet a decision. Check it against the source, then rewrite the reason in your own words.");
+      ok = false;
+    } else {
+      if (PREFERENCE.test(because)) {
+        err(`${at}.because`, "that is a preference, not a reason. Say what in the client's world this comes from.");
+        ok = false;
+      }
+      const moods = because.match(MOOD) ?? [];
+      if (moods.length >= 2) {
+        err(`${at}.because`, `"${moods.join(", ")}" describes a mood, not a source. Name the thing it comes from.`);
+        ok = false;
+      }
+    }
+    if (evidence.length === 0) {
+      err(`${at}.evidence`, "cite at least one source");
+      ok = false;
+    }
+    for (const id of evidence) {
+      if (!ids.has(id)) {
+        err(`${at}.evidence`, `no source called "${id}"`);
+        ok = false;
+      }
+    }
+    if (ok) {
+      const cited = sources.filter((s) => evidence.includes(s.id));
+      const reasonWords = words(because);
+      const tied = cited.some((s) => reasonWords.has(s.id) || [...words(`${s.note} ${s.lettering ?? ""}`)].some((w) => reasonWords.has(w)));
+      if (!tied) {
+        err(`${at}.because`, `the reason does not mention what its evidence shows (${evidence.join(", ")}). Say what on it this comes from.`);
+        ok = false;
+      }
+    }
+    if (typeof c.value === "string") {
+      const tell = tellFor(key, c.value);
+      if (tell && !exceptions.some((e) => e.tell === tell)) {
+        err(`${at}.value`, `${c.value} is on the tell catalogue (${tell}). Keep it only with an exception for ${tell}, carrying the same reason.`);
+        ok = false;
+      }
+    }
+    const fp = ctx.fingerprint;
+    if (fp && typeof c.value === "string") {
+      if ((key === "accent" || key === "ground") && parseColour(c.value)) {
+        const declared = parseColour(c.value).oklch;
+        const measured = key === "accent" ? fp.accent : fp.ground;
+        if (measured && deltaEOk(declared, measured) > 0.08) {
+          warn(`${at}.value`, `the page does not show it: its ${key} measures oklch(${measured.l.toFixed(2)} ${measured.c.toFixed(3)} ${measured.h.toFixed(0)})`);
+        }
+      }
+      if (key === "display" || key === "body") {
+        const measured = key === "display" ? fp.display.family : fp.body.family;
+        if (normaliseFamily(c.value).toLowerCase() !== measured.toLowerCase()) warn(`${at}.value`, `the page sets ${measured}, not ${c.value}`);
+      }
+    }
+    if (ok) decided += 1;
+  }
+  return { valid: problems.every((p) => p.severity !== "error"), problems, decided };
+}
+
+export {
+  DIRECTION_VERSION,
+  validateDirection
+};

package/dist/{cli-7ME4VIRG.js → chunk-OA7SGPN4.js}

@@ -1,20 +1,10 @@
 import {
   fingerprint
-} from "./chunk-HYGFP3LB.js";
+} from "./chunk-Q54JSNC5.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";
+  auditSnapshot
+} from "./chunk-3AP4PJMX.js";
 
 // src/audit/collect.ts
 function collectInPage() {
@@ -167,13 +157,18 @@ function collectInPage() {
   pushBlocks(root, 0);
   const header = document.querySelector("body > header, header");
   const h1 = document.querySelector("h1");
+  const waiting = (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 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 : "");
-    });
+    if ([el, ...Array.from(el.children).slice(0, 6)].some(waiting)) return true;
+    const blocks2 = Array.from(el.querySelectorAll("div, article, li, figure, p, h2, h3")).slice(0, 200).filter((d) => {
+      const b = box(d);
+      return b.width > 100 && b.height > 40 && (d.textContent ?? "").trim().length > 12 && style(d).position !== "fixed";
+    }).slice(0, 12);
+    return blocks2.filter(waiting).length >= Math.min(2, blocks2.length) && blocks2.some(waiting);
   };
   const cardsIn = (section) => {
     let best = { cards: 0, iconCards: 0 };
@@ -372,99 +367,53 @@ async function snapshotPage(page, url, options = {}) {
     motion: { ...data.motion, introOverlay: early && !late }
   };
 }
-async function snapshotUrl(url, options = {}) {
-  const pw = await loadPlaywright();
+async function launch(pw, url, options) {
   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
-    }
-  };
+  return pw.chromium.launch({ headless: true, ...executablePath ? { executablePath } : {}, ...proxy ? { proxy: { server: proxy } } : {} });
 }
-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 snapshotUrl(url, options = {}) {
+  const [result] = await snapshotUrls([url], options);
+  if (!result.snapshot) throw new Error(result.error);
+  return result.snapshot;
 }
-async function runAudit(command, args, io) {
+async function snapshotUrls(urls, options = {}) {
+  if (urls.length === 0) return [];
+  const pw = await loadPlaywright();
+  const browser = await launch(pw, urls[0], options);
+  const out = [];
   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;
+    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 });
+        out.push({ url, snapshot: await snapshotPage(page, url, options) });
+      } catch (error) {
+        out.push({ url, error: error.message });
+      } finally {
+        await page.close?.();
+      }
     }
-    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;
+    return out;
+  } finally {
+    await browser.close();
   }
 }
+async function audit(url, options = {}) {
+  const snapshot = await snapshotUrl(url, options);
+  return { snapshot, report: auditSnapshot(snapshot, options), fingerprint: fingerprint(snapshot) };
+}
+
 export {
-  describeFingerprint,
-  runAudit
+  collectInPage,
+  overlayInPage,
+  loadPlaywright,
+  snapshotPage,
+  snapshotUrl,
+  snapshotUrls,
+  audit
 };

package/dist/{chunk-HYGFP3LB.js → chunk-Q54JSNC5.js}

@@ -1,12 +1,14 @@
 import {
+  deltaEOk,
   fontClass,
   normaliseFamily,
   parseColour
-} from "./chunk-GWMSSRIQ.js";
+} from "./chunk-3AP4PJMX.js";
 
 // src/fingerprint/index.ts
 var FINGERPRINT_VERSION = 1;
 var CHROMATIC = 0.03;
+var MIN_ACCENT_AREA = 2e4;
 var oklch = (value) => {
   const parsed = parseColour(value);
   return parsed && parsed.alpha > 0.5 ? parsed.oklch : null;
@@ -19,7 +21,7 @@ function accentOf(s) {
   }
   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];
+  const bg = s.colours.backgrounds.map((b) => ({ o: oklch(b.value), w: b.area })).filter((x) => x.o && x.o.c >= CHROMATIC && x.w >= MIN_ACCENT_AREA).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;
@@ -62,7 +64,42 @@ function fingerprint(s) {
     layout: s.sections.map((x) => x.kind)
   };
 }
+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) {
+  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));
+      prev = cur;
+    }
+  }
+  return row[b.length];
+}
+var clamp = (n) => Math.max(0, Math.min(1, n));
+function faceDistance(a, b) {
+  if (a.family.toLowerCase() === b.family.toLowerCase()) return 0;
+  return a.class === b.class ? 0.5 : 1;
+}
+function fingerprintDistance(a, b) {
+  const accent = a.accent && b.accent ? clamp(deltaEOk(a.accent, b.accent) / 0.3) : a.accent || b.accent ? 1 : 0;
+  const ground = clamp(deltaEOk(a.ground, b.ground) / 0.15);
+  const type = 0.6 * faceDistance(a.display, b.display) + 0.4 * faceDistance(a.body, b.body);
+  const shape = a.roundness === null || b.roundness === null ? a.roundness === b.roundness ? 0 : 0.5 : clamp(Math.abs(a.roundness - b.roundness) / 0.5);
+  const motion = clamp(Math.abs(a.motion - b.motion));
+  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 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 };
+}
 
 export {
-  fingerprint
+  fingerprint,
+  fingerprintDistance
 };