@domandigital/craft 0.6.0 → 0.8.0

package/dist/chunk-OVOH7KZY.js

@@ -0,0 +1,163 @@
+import {
+  groundName,
+  hueName,
+  loadNull,
+  shapeName
+} from "./chunk-K253ZXB3.js";
+import {
+  parseFlags
+} from "./chunk-X65RDW65.js";
+import {
+  fingerprint,
+  fingerprintDistance
+} from "./chunk-OGSYVCMU.js";
+import {
+  SNAPSHOT_VERSION,
+  auditSnapshot
+} from "./chunk-CZHRNPDD.js";
+
+// src/estate/cli.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+
+// src/estate/index.ts
+var ESTATE_VERSION = 1;
+var SIBLING_AT = 0.31;
+function emptyEstate() {
+  return { version: ESTATE_VERSION, sites: [] };
+}
+function addSite(register, site) {
+  if (!/^[a-z0-9][a-z0-9-]*$/.test(site.id)) throw new Error(`site id "${site.id}" must be short kebab-case`);
+  const sites = [...register.sites.filter((s) => s.id !== site.id), site].sort((a, b) => a.id.localeCompare(b.id));
+  return { version: ESTATE_VERSION, sites };
+}
+function sharedParts(a, b, d = fingerprintDistance(a, b)) {
+  const out = [];
+  const close = (k) => d.parts[k] <= 0.2;
+  if (close("accent")) out.push(a.accent || b.accent ? `${hueName(a.accent)} accent` : "no accent");
+  if (close("type")) {
+    if (a.display.family === b.display.family) out.push(`${a.display.family} headline`);
+    if (a.body.family === b.body.family) out.push(`${a.body.family} body`);
+  }
+  if (close("ground")) out.push(`${groundName(a.ground)} ground`);
+  if (close("shape")) out.push(`${shapeName(a.roundness)} buttons`);
+  if (close("motion")) out.push(a.motion > 0 || b.motion > 0 ? "scroll reveals" : "no reveals");
+  if (close("effects") && a.effects.length) out.push(a.effects.filter((e) => b.effects.includes(e)).join(", "));
+  if (close("layout")) out.push("running order");
+  return out;
+}
+function compareToEstate(target, register, options = {}) {
+  const at = options.siblingAt ?? SIBLING_AT;
+  return register.sites.filter((s) => s.id !== options.exclude).map((s) => {
+    const d = fingerprintDistance(target, s.fingerprint);
+    return { id: s.id, distance: d.total, sibling: d.total < at, shared: sharedParts(target, s.fingerprint, d) };
+  }).sort((a, b) => a.distance - b.distance);
+}
+function estatePairs(register, siblingAt = SIBLING_AT) {
+  const out = [];
+  const s = register.sites;
+  for (let i = 0; i < s.length; i += 1) {
+    for (let j = i + 1; j < s.length; j += 1) {
+      const d = fingerprintDistance(s[i].fingerprint, s[j].fingerprint);
+      out.push({ a: s[i].id, b: s[j].id, distance: d.total, sibling: d.total < siblingAt, shared: sharedParts(s[i].fingerprint, s[j].fingerprint, d) });
+    }
+  }
+  return out.sort((x, y) => x.distance - y.distance);
+}
+function siblingLine(briefs) {
+  const d = [];
+  for (const runs of briefs) {
+    for (let i = 0; i < runs.length; i += 1) for (let j = i + 1; j < runs.length; j += 1) d.push(fingerprintDistance(runs[i], runs[j]).total);
+  }
+  if (d.length === 0) throw new Error("no null pages to measure the sibling line from");
+  d.sort((a, b) => a - b);
+  const mid = Math.floor(d.length / 2);
+  const m = d.length % 2 ? d[mid] : (d[mid - 1] + d[mid]) / 2;
+  return Math.round(m * 1e3) / 1e3;
+}
+
+// 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]";
+function loadEstate(path) {
+  if (!existsSync(path)) return emptyEstate();
+  const data = JSON.parse(readFileSync(path, "utf8"));
+  if (data.version !== ESTATE_VERSION || !Array.isArray(data.sites)) throw new Error(`${path} is not an estate register (version ${ESTATE_VERSION})`);
+  return data;
+}
+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`);
+    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-W57YDZ2K.js");
+  return snapshotUrl(target);
+}
+var line = (distance, sibling, shared) => `${distance.toFixed(2)}${sibling ? "  SIBLING" : ""}${shared.length ? `  shares ${shared.join(", ")}` : ""}`;
+function formatMatches(label, matches, at) {
+  const lines = [`${label}: nearest sites in the estate (siblings below ${at.toFixed(2)})`];
+  for (const m of matches) lines.push(`  ${m.id.padEnd(20)} ${line(m.distance, m.sibling, m.shared)}`);
+  if (matches.length === 0) lines.push("  the register is empty");
+  return lines.join("\n");
+}
+function formatPairs(pairs, at, sites) {
+  const siblings = pairs.filter((p) => p.sibling).length;
+  const lines = [`craft estate: ${sites} sites, ${pairs.length} pair${pairs.length === 1 ? "" : "s"}, ${siblings} sibling pair${siblings === 1 ? "" : "s"} (below ${at.toFixed(2)})`];
+  for (const p of pairs) lines.push(`  ${`${p.a} + ${p.b}`.padEnd(34)} ${line(p.distance, p.sibling, p.shared)}`);
+  return lines.join("\n");
+}
+async function runEstate(args, io) {
+  try {
+    const flags = parseFlags(args);
+    if (typeof flags === "string") throw new Error(flags);
+    const [sub, target] = flags.positional;
+    const file = resolve(io.cwd, flags.estate ?? "estate.json");
+    const register = loadEstate(file);
+    const at = flags.null ? siblingLine(flags.null.split(",").map((p) => loadNull(p.trim(), io.cwd).runs.map((r) => r.fingerprint))) : SIBLING_AT;
+    if (sub === "add") {
+      if (!target || !flags.id) throw new Error(USAGE);
+      const snap = await snapshotOf(target, io.cwd);
+      const fp = fingerprint(snap);
+      const next = addSite(register, {
+        id: flags.id,
+        client: flags.client ?? flags.id,
+        url: snap.url,
+        fingerprint: fp,
+        tells: [...new Set(auditSnapshot(snap).findings.map((f) => f.tell))].sort(),
+        addedAt: snap.capturedAt
+      });
+      writeFileSync(file, `${JSON.stringify(next, null, 2)}
+`);
+      io.out(`craft estate: ${flags.id} ${register.sites.some((s) => s.id === flags.id) ? "updated" : "added"}, ${next.sites.length} sites in ${flags.estate ?? "estate.json"}`);
+      io.out(formatMatches(flags.id, compareToEstate(fp, next, { exclude: flags.id, siblingAt: at }).slice(0, 3), at));
+      return 0;
+    }
+    if (sub === "compare") {
+      if (!target) {
+        const pairs = estatePairs(register, at);
+        io.out(flags.json ? JSON.stringify({ siblingAt: at, pairs }, null, 2) : formatPairs(pairs, at, register.sites.length));
+        return flags.strict && pairs.some((p) => p.sibling) ? 1 : 0;
+      }
+      const known = register.sites.find((s) => s.id === target);
+      const fp = known ? known.fingerprint : fingerprint(await snapshotOf(target, io.cwd));
+      const matches = compareToEstate(fp, register, { exclude: known?.id, siblingAt: at });
+      io.out(flags.json ? JSON.stringify({ siblingAt: at, matches }, null, 2) : formatMatches(known?.id ?? target, matches, at));
+      return flags.strict && matches.some((m) => m.sibling) ? 1 : 0;
+    }
+    throw new Error(USAGE);
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
+
+export {
+  SIBLING_AT,
+  compareToEstate,
+  loadEstate,
+  formatMatches,
+  formatPairs,
+  runEstate
+};

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

@@ -1,20 +1,10 @@
 import {
   fingerprint
-} from "./chunk-HYGFP3LB.js";
+} from "./chunk-OGSYVCMU.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-CZHRNPDD.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-ULYKASLA.js

@@ -0,0 +1,175 @@
+import {
+  REFLEX_FONTS_1,
+  REFLEX_FONTS_2,
+  deltaEOk,
+  isAiViolet,
+  isCream,
+  normaliseFamily,
+  parseColour
+} from "./chunk-CZHRNPDD.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
+};