@domandigital/craft 0.6.0 → 0.7.0

package/dist/index.cjs

@@ -3,9 +3,9 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
+var __export = (target2, all) => {
   for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+    __defProp(target2, name, { get: all[name], enumerable: true });
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
@@ -35,12 +35,16 @@ __export(index_exports, {
   DURATION_S: () => DURATION_S,
   EASE: () => EASE,
   EASE_TUPLE: () => EASE_TUPLE,
+  ESTATE_VERSION: () => ESTATE_VERSION,
   EXIT_RATIO: () => EXIT_RATIO,
   FINGERPRINT_VERSION: () => FINGERPRINT_VERSION,
   HOUSE_BUDGET: () => HOUSE_BUDGET,
   HOUSE_TYPE: () => HOUSE_TYPE,
   LIGHTNESS_CURVE: () => LIGHTNESS_CURVE,
+  MIN_DECIDED: () => MIN_DECIDED,
+  MIN_RUNS: () => MIN_RUNS,
   NEGATIVE_REASSURANCE: () => NEGATIVE_REASSURANCE,
+  NULL_VERSION: () => NULL_VERSION,
   PILL_LIMIT: () => PILL_LIMIT,
   PLAINER_WORDS: () => PLAINER_WORDS,
   PROPOSED: () => PROPOSED,
@@ -53,27 +57,37 @@ __export(index_exports, {
   SCALE: () => SCALE,
   SHADCN_LIMIT: () => SHADCN_LIMIT,
   SHADCN_PRIMITIVES: () => SHADCN_PRIMITIVES,
+  SIBLING_AT: () => SIBLING_AT,
   SNAPSHOT_VERSION: () => SNAPSHOT_VERSION,
   SOURCE_KINDS: () => SOURCE_KINDS,
   SPACE_STEPS: () => SPACE_STEPS,
   SPRING: () => SPRING,
   STOCK_PHRASES: () => STOCK_PHRASES,
+  TELL_HEAVY: () => TELL_HEAVY,
   TYPE_STEPS: () => TYPE_STEPS,
+  TYPICAL_AT: () => TYPICAL_AT,
   VAGUE_WORDS: () => VAGUE_WORDS,
   accentFork: () => accentFork,
+  addSite: () => addSite,
   apcaContrast: () => apcaContrast,
   auditSnapshot: () => auditSnapshot,
   catalogueTable: () => catalogueTable,
+  characterReport: () => characterReport,
   checkCopy: () => checkCopy,
   checkPair: () => checkPair,
   checkRestraint: () => checkRestraint,
+  choicesOf: () => choicesOf,
+  compareToEstate: () => compareToEstate,
   craftTokens: () => craftTokens,
   deltaEOk: () => deltaEOk,
   deltaEOkHex: () => deltaEOkHex,
   densityCss: () => densityCss,
   densityTokens: () => densityTokens,
   emitCss: () => emitCss,
+  emptyEstate: () => emptyEstate,
+  estatePairs: () => estatePairs,
   exitDuration: () => exitDuration,
+  extractHtml: () => extractHtml,
   findColours: () => findColours,
   fingerprint: () => fingerprint,
   fingerprintDistance: () => fingerprintDistance,
@@ -83,7 +97,11 @@ __export(index_exports, {
   fontClass: () => fontClass,
   formatHex: () => formatHex,
   formatReport: () => formatReport,
+  groundName: () => groundName,
+  harvest: () => harvest,
   hexToOklch: () => hexToOklch,
+  hueName: () => hueName,
+  hueSwatch: () => hueSwatch,
   inP3Gamut: () => inP3Gamut,
   inSrgbGamut: () => inSrgbGamut,
   initDirection: () => initDirection,
@@ -93,6 +111,7 @@ __export(index_exports, {
   motionTokens: () => motionTokens,
   nearest: () => nearest,
   normaliseFamily: () => normaliseFamily,
+  nullPrompt: () => nullPrompt,
   oklchToHex: () => oklchToHex,
   oklchToRgb: () => oklchToRgb,
   paletteFromPixels: () => paletteFromPixels,
@@ -101,18 +120,24 @@ __export(index_exports, {
   propose: () => propose,
   ramp: () => ramp,
   rampFromAnchors: () => rampFromAnchors,
+  retrofitPlan: () => retrofitPlan,
   runTell: () => runTell,
   scanSource: () => scanSource,
   sectionRhythm: () => sectionRhythm,
   semantic: () => semantic,
+  shapeName: () => shapeName,
+  sharedParts: () => sharedParts,
   shouldAnimate: () => shouldAnimate,
+  siblingLine: () => siblingLine,
   tailwindV3Preset: () => tailwindV3Preset,
   tailwindV4Theme: () => tailwindV4Theme,
   tellById: () => tellById,
   toGamut: () => toGamut,
   typeFeatureTokens: () => typeFeatureTokens,
+  typicality: () => typicality,
   validateDirection: () => validateDirection,
-  wcagContrast: () => wcagContrast
+  wcagContrast: () => wcagContrast,
+  wordListsJson: () => wordListsJson
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -945,9 +970,9 @@ function resolveValue(value, props, depth = 0) {
   if (depth > 8) return null;
   const match = SINGLE_VAR.exec(value.trim());
   if (match === null) return value.trim();
-  const target = props.get(match[1].toLowerCase());
-  if (target !== void 0 && target !== "initial")
-    return resolveValue(target, props, depth + 1);
+  const target2 = props.get(match[1].toLowerCase());
+  if (target2 !== void 0 && target2 !== "initial")
+    return resolveValue(target2, props, depth + 1);
   const fallback = match[2]?.trim();
   return fallback === void 0 || fallback === "" ? null : resolveValue(fallback, props, depth + 1);
 }
@@ -2502,7 +2527,7 @@ const inter = Inter({ subsets: ["latin"] });`),
     severity: "warn",
     surface: "source",
     why: "Ban Inter and a model reaches for Inter Tight, DM Sans, Manrope, Space Grotesk or an Instrument/Fraunces serif. A swap inside the reflex list is not a decision.",
-    fix: "Same as reflex-font. If this face really is the right one, declare an exception with the reason and the evidence.",
+    fix: "Pick the display face from the client's world (signage, packaging, the trade's lettering) and record why in art-direction.json. If this face really is the right one, declare an exception with the reason and the evidence.",
     detect: fontTell(REFLEX_FONTS_2),
     fixtures: {
       flag: [f2("src/styles.css", `@theme {
@@ -3250,15 +3275,16 @@ function makeSnapshot(patch = {}) {
 }
 
 // src/snapshot/fonts.ts
+var SYSTEM = /^(?:system-ui|-apple-system|BlinkMacSystemFont|ui-sans-serif|ui-serif|ui-monospace|ui-rounded|sans-serif|serif|monospace|cursive)$/i;
 function normaliseFamily(raw) {
   let name = raw.replace(/["']/g, "").trim();
   const next = name.match(/^__(.+?)(?:_Fallback)?_[0-9a-f]{5,8}$/i);
   if (next) name = next[1].replace(/_/g, " ");
   name = name.replace(/\s+Fallback$/i, "").replace(/\s+Variable$/i, "");
+  if (SYSTEM.test(name)) return "system-ui";
   if (!/\s/.test(name) && (/[a-z][A-Z]/.test(name) || /^[a-z]+(?:-[a-z]+)+$/.test(name))) {
     name = name.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/-/g, " ").replace(/\b([a-z])/g, (c) => c.toUpperCase()).replace(/\bDm\b/, "DM");
   }
-  if (/^(?:system-ui|-apple-system|BlinkMacSystemFont|ui-sans-serif|ui-serif|ui-monospace|sans-serif|serif|monospace)$/i.test(name)) return "system-ui";
   return name;
 }
 var KNOWN = {
@@ -3635,6 +3661,25 @@ function catalogueTable() {
     ...rows
   ].join("\n");
 }
+function wordListsJson() {
+  return JSON.stringify(
+    {
+      catalogueVersion: CATALOGUE_VERSION,
+      lists: {
+        aiWords: AI_WORDS,
+        stockPhrases: STOCK_PHRASES,
+        aiPhrases: AI_PHRASES,
+        plainerWords: PLAINER_WORDS,
+        buzzwords: BUZZWORDS,
+        negativeReassurance: NEGATIVE_REASSURANCE,
+        vagueWords: VAGUE_WORDS,
+        reviewPhrases: REVIEW_PHRASES
+      }
+    },
+    null,
+    2
+  ) + "\n";
+}
 
 // src/character/format.ts
 function formatReport(report2, title) {
@@ -3674,6 +3719,7 @@ function formatReport(report2, title) {
 // 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;
@@ -3686,7 +3732,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;
@@ -3763,8 +3809,8 @@ function fingerprintDistance(a, b) {
   const total = Object.keys(DISTANCE_WEIGHTS).reduce((sum, k) => sum + DISTANCE_WEIGHTS[k] * parts2[k], 0);
   return { total: Math.round(total * 1e3) / 1e3, parts: parts2 };
 }
-function nearest(target, set, k = set.length) {
-  return set.map((item) => ({ id: item.id, distance: fingerprintDistance(target, item.fingerprint) })).sort((x, y) => x.distance.total - y.distance.total).slice(0, k);
+function nearest(target2, set, k = set.length) {
+  return set.map((item) => ({ id: item.id, distance: fingerprintDistance(target2, item.fingerprint) })).sort((x, y) => x.distance.total - y.distance.total).slice(0, k);
 }
 
 // src/direction/types.ts
@@ -4071,6 +4117,495 @@ function propose(input) {
     direction: { version: DIRECTION_VERSION, client: input.client, brief: input.brief, sources: input.sources, choices }
   };
 }
+
+// src/null/index.ts
+var NULL_VERSION = 1;
+function nullPrompt(brief) {
+  return [
+    `Build the home page for this business: ${brief.trim()}`,
+    "",
+    "Write it as one complete, self-contained HTML file. You may load fonts and libraries from a CDN. Use real copy, not placeholder text. Reply with the HTML only."
+  ].join("\n");
+}
+function extractHtml(reply) {
+  const start = reply.search(/<!doctype html|<html[\s>]/i);
+  if (start < 0) return null;
+  const end = reply.toLowerCase().lastIndexOf("</html>");
+  const html = end > start ? reply.slice(start, end + "</html>".length) : reply.slice(start).replace(/\s*```\s*$/, "");
+  return html.length > 200 ? html : null;
+}
+var MIN_RUNS = 5;
+var TYPICAL_AT = 0.1;
+function meanNearest(distances, k) {
+  const sorted = [...distances].sort((a, b) => a - b).slice(0, k);
+  return sorted.reduce((s, d) => s + d, 0) / sorted.length;
+}
+function median2(values) {
+  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 typicality(target2, runs, k = 3) {
+  if (runs.length < MIN_RUNS) throw new Error(`a null model needs at least ${MIN_RUNS} runs; this one has ${runs.length}`);
+  const kk = Math.min(k, runs.length - 1);
+  const toTarget = runs.map((r) => ({ id: r.id, distance: fingerprintDistance(target2, r.fingerprint).total }));
+  const distance = meanNearest(
+    toTarget.map((t) => t.distance),
+    kk
+  );
+  const loo = runs.map(
+    (r, i) => meanNearest(
+      runs.filter((_, j) => j !== i).map((o) => fingerprintDistance(r.fingerprint, o.fingerprint).total),
+      kk
+    )
+  );
+  const score = loo.filter((d) => d >= distance).length / loo.length;
+  return {
+    score: Math.round(score * 100) / 100,
+    typical: score >= TYPICAL_AT,
+    distance: Math.round(distance * 1e3) / 1e3,
+    baseline: Math.round(median2(loo) * 1e3) / 1e3,
+    nearest: toTarget.sort((a, b) => a.distance - b.distance).slice(0, kk),
+    shared: sharedChoices(target2, runs)
+  };
+}
+var HUES = [
+  ["red", 0, 45],
+  ["orange", 45, 75],
+  ["yellow", 75, 110],
+  ["green", 110, 165],
+  ["teal", 165, 215],
+  ["blue", 215, 265],
+  ["violet", 265, 315],
+  ["pink", 315, 360]
+];
+function hueName(o) {
+  if (!o) return "none";
+  if (o.c < 0.03) return "neutral";
+  return HUES.find(([, lo, hi]) => o.h >= lo && o.h < hi)?.[0] ?? "red";
+}
+function groundName(o) {
+  if (o.l < 0.3) return "dark";
+  if (isCream(o)) return "cream";
+  if (o.l >= 0.97 && o.c < 0.012) return "white";
+  return o.c < 0.02 ? "grey" : "tinted";
+}
+function shapeName(roundness) {
+  if (roundness === null) return "no buttons";
+  if (roundness >= 0.45) return "pill";
+  return roundness >= 0.15 ? "soft" : "square";
+}
+function choicesOf(fp) {
+  return {
+    display: [fp.display.family],
+    body: [fp.body.family],
+    accent: [hueName(fp.accent)],
+    ground: [groundName(fp.ground)],
+    shape: [shapeName(fp.roundness)],
+    motion: [fp.motion >= 0.6 ? "reveals most sections" : fp.motion > 0 ? "reveals some sections" : "no scroll reveals"],
+    effects: fp.effects,
+    opening: [fp.layout.slice(0, 3).join(" > ") || "none"]
+  };
+}
+function sharedChoices(target2, runs) {
+  const mine = choicesOf(target2);
+  const all = runs.map((r) => choicesOf(r.fingerprint));
+  const out = [];
+  for (const [part, values] of Object.entries(mine)) {
+    for (const value of values) {
+      const count2 = all.filter((c) => c[part].includes(value)).length;
+      if (count2 / runs.length >= 0.25) out.push({ part, value, runs: count2, of: runs.length });
+    }
+  }
+  return out.sort((a, b) => b.runs - a.runs);
+}
+var REFLEX_1 = new Set(REFLEX_FONTS_1.map((f3) => f3.toLowerCase()));
+var REFLEX_2 = new Set(REFLEX_FONTS_2.map((f3) => f3.toLowerCase()));
+function knownFor(kind, value, sample) {
+  if (kind === "face") return REFLEX_1.has(value.toLowerCase()) ? "reflex-font" : REFLEX_2.has(value.toLowerCase()) ? "reflex-font-2" : null;
+  if (kind === "accent" && value === "violet") return sample.some((f3) => f3.accent && isAiViolet(f3.accent)) ? "ai-violet" : null;
+  if (kind === "ground" && value === "cream") return "cream-palette";
+  if (kind === "shape" && value === "pill") return "pill-everything";
+  if (kind === "motion" && value === "reveals most sections") return "reveal-everywhere";
+  if (kind === "tell") return value;
+  if (kind === "opening" && /^hero > (?:logos|stats)/.test(value)) return "hero-then-proof";
+  return null;
+}
+var STOP2 = new Set(
+  "a an the and or but of to in on for with at by from as is are be we our you your us it its this that these those will can all more get has have not no any".split(" ")
+);
+function grams(text) {
+  const out = /* @__PURE__ */ new Set();
+  for (const clause of text.toLowerCase().replace(/[’']/g, "'").split(/[.!?;:|()\u2013\u2014\u00b7•]+|,\s/)) {
+    const words2 = clause.match(/[a-z][a-z'-]*/g) ?? [];
+    for (let n = 2; n <= 4; n += 1) {
+      for (let i = 0; i + n <= words2.length; i += 1) {
+        const g = words2.slice(i, i + n);
+        if (STOP2.has(g[0]) || STOP2.has(g[n - 1])) continue;
+        if (g.filter((w) => !STOP2.has(w)).length < 2) continue;
+        out.add(g.join(" "));
+      }
+    }
+  }
+  return out;
+}
+var GRAMMAR = /* @__PURE__ */ new Set([
+  "privacy policy",
+  "cookie policy",
+  "rights reserved",
+  "all rights reserved",
+  "terms of service",
+  "terms and conditions",
+  "terms conditions",
+  "how it works",
+  "what we do",
+  "about us",
+  "contact us",
+  "get in touch",
+  "opening hours",
+  "read more",
+  "learn more",
+  "book now",
+  "free quote",
+  "our services",
+  "quick links",
+  "email address",
+  "phone number",
+  "full name",
+  "first name",
+  "last name",
+  "your name",
+  "your email",
+  "send message"
+]);
+var LEGAL = /©|&copy;|\bregistered (?:in|office|number)\b|\bcompany (?:no|number|reg)|\bvat (?:no|number|reg)/i;
+var NOISE = /\S+@\S+|https?:\/\/\S+|\b[\w-]+(?:\.[\w-]+)*\.(?:co\.uk|com|org|net|uk|io)\b|\b\d{1,2}(?:[:.]\d{2})?\s*(?:am|pm)\b|\d+/gi;
+function textGrams(text) {
+  if (LEGAL.test(text)) return /* @__PURE__ */ new Set();
+  const out = grams(text.replace(NOISE, " | "));
+  for (const g of out) if (GRAMMAR.has(g)) out.delete(g);
+  return out;
+}
+function properNouns(brief) {
+  return new Set((brief.match(/\b[A-Z][a-z]+/g) ?? []).map((w) => w.toLowerCase()).filter((w) => !STOP2.has(w)));
+}
+function harvest(models, options = {}) {
+  const minShare = options.minShare ?? 0.25;
+  const runs = models.flatMap((m, b) => m.runs.map((r) => ({ ...r, brief: b })));
+  const of = runs.length;
+  if (of === 0) return [];
+  const multiBrief = models.length > 1;
+  const sample = runs.map((r) => r.fingerprint);
+  const tally = /* @__PURE__ */ new Map();
+  const add = (kind, value, run, brief, example) => {
+    const key = `${kind}\0${value}`;
+    const t = tally.get(key) ?? { kind, value, runs: /* @__PURE__ */ new Set(), briefs: /* @__PURE__ */ new Set(), example };
+    t.runs.add(run);
+    t.briefs.add(brief);
+    tally.set(key, t);
+  };
+  runs.forEach((r, i) => {
+    const c = choicesOf(r.fingerprint);
+    for (const f3 of /* @__PURE__ */ new Set([...c.display, ...c.body])) add("face", f3, i, r.brief);
+    add("accent", c.accent[0], i, r.brief);
+    add("ground", c.ground[0], i, r.brief);
+    add("shape", c.shape[0], i, r.brief);
+    add("motion", c.motion[0], i, r.brief);
+    add("opening", c.opening[0], i, r.brief);
+    for (const t of r.tells) add("tell", t, i, r.brief);
+  });
+  const out = [];
+  for (const t of tally.values()) {
+    if (t.runs.size / of < minShare) continue;
+    if (t.kind === "accent" && (t.value === "none" || t.value === "neutral")) continue;
+    if (t.kind === "shape" && t.value === "no buttons") continue;
+    if (t.kind === "ground" && (t.value === "white" || t.value === "grey")) continue;
+    if (t.kind === "motion" && t.value === "no scroll reveals") continue;
+    out.push({ kind: t.kind, value: t.value, runs: t.runs.size, of, briefs: t.briefs.size, known: knownFor(t.kind, t.value, sample) });
+  }
+  const phraseMin = Math.max(3, Math.ceil(of * minShare * 0.4));
+  const names = models.map((m) => properNouns(m.brief));
+  const phrases2 = /* @__PURE__ */ new Map();
+  runs.forEach((r, i) => {
+    for (const text of r.copy) {
+      for (const g of textGrams(text)) {
+        if (g.split(" ").some((w) => names[r.brief].has(w))) continue;
+        const p = phrases2.get(g) ?? { runs: /* @__PURE__ */ new Set(), briefs: /* @__PURE__ */ new Set(), example: text.trim().slice(0, 140) };
+        p.runs.add(i);
+        p.briefs.add(r.brief);
+        phrases2.set(g, p);
+      }
+    }
+  });
+  const kept = [...phrases2].filter(([, p]) => p.runs.size >= phraseMin && (!multiBrief || p.briefs.size >= 2)).sort((a, b) => b[1].runs.size - a[1].runs.size || b[0].length - a[0].length);
+  const maximal = kept.filter(([g, p]) => !kept.some(([h, q]) => h !== g && h.includes(g) && q.runs.size >= 0.8 * p.runs.size));
+  for (const [g, p] of maximal.slice(0, 40)) {
+    out.push({ kind: "phrase", value: g, runs: p.runs.size, of, briefs: p.briefs.size, known: options.copyTell?.(g) ?? null, example: p.example });
+  }
+  const order = ["face", "accent", "ground", "shape", "motion", "opening", "tell", "phrase"];
+  return out.sort((a, b) => order.indexOf(a.kind) - order.indexOf(b.kind) || b.runs - a.runs);
+}
+function hueSwatch(runs, hue) {
+  const hits = runs.map((r) => r.fingerprint.accent).filter((o) => !!o && hueName(o) === hue);
+  if (hits.length === 0) return null;
+  const centre = hits.reduce((best, o) => hits.reduce((s, p) => s + deltaEOk(o, p), 0) < hits.reduce((s, p) => s + deltaEOk(best, p), 0) ? o : best);
+  return formatHex(oklchToRgb(centre));
+}
+
+// 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(target2, register, options = {}) {
+  const at = options.siblingAt ?? SIBLING_AT;
+  return register.sites.filter((s) => s.id !== options.exclude).map((s) => {
+    const d = fingerprintDistance(target2, s.fingerprint);
+    return { id: s.id, distance: d.total, sibling: d.total < at, shared: sharedParts(target2, 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/report/index.ts
+var TELL_HEAVY = 3;
+var MIN_DECIDED = 5;
+var TELL_AREA = {
+  "reflex-font": { area: "type", choice: "display" },
+  "reflex-font-2": { area: "type", choice: "display" },
+  "italic-serif-display": { area: "type", choice: "display" },
+  "ai-violet": { area: "colour", choice: "accent" },
+  "blue-purple-gradient": { area: "colour", choice: "accent" },
+  "gradient-text": { area: "colour", choice: "accent" },
+  "cream-palette": { area: "colour", choice: "ground" },
+  "pill-everything": { area: "shape", choice: "shape" },
+  "shadcn-dump": { area: "shape", choice: "shape" },
+  "glass-panel": { area: "effects", choice: "motif" },
+  "radial-spotlight-glow": { area: "effects", choice: "motif" },
+  "grid-background": { area: "effects", choice: "motif" },
+  "thin-border-wide-shadow": { area: "effects", choice: "shape" },
+  "icon-tile-stack": { area: "effects", choice: "motif" },
+  "reveal-everywhere": { area: "motion", choice: "signature" },
+  "intro-cinematic": { area: "motion", choice: "signature" },
+  marquee: { area: "motion", choice: "signature" },
+  "hero-then-proof": { area: "layout" },
+  "icon-tile-grid": { area: "layout" },
+  "hero-eyebrow-chip": { area: "layout" },
+  "bento-grid": { area: "layout" }
+};
+var PART_AREA = {
+  display: { area: "type", choice: "display" },
+  body: { area: "type", choice: "body" },
+  accent: { area: "colour", choice: "accent" },
+  ground: { area: "colour", choice: "ground" },
+  shape: { area: "shape", choice: "shape" },
+  effects: { area: "effects", choice: "motif" },
+  motion: { area: "motion", choice: "signature" }
+};
+var DEFAULTS = /^(?:ground )?(?:white|grey)(?: ground)?$|no scroll reveals|no reveals|accent (?:none|neutral)|^no buttons|shape no buttons/;
+function designFindings(findings, copyTells) {
+  return (findings?.findings ?? []).filter((f3) => !copyTells.has(f3.tell));
+}
+function characterReport(input, copyTells = /* @__PURE__ */ new Set()) {
+  const actions = [];
+  const signals = [];
+  if (input.findings) {
+    const design = designFindings(input.findings, copyTells);
+    const distinct = [...new Set(design.map((f3) => f3.tell))];
+    signals.push({
+      id: "tells",
+      raised: distinct.length >= TELL_HEAVY,
+      detail: `${distinct.length} distinct design tell${distinct.length === 1 ? "" : "s"}${distinct.length ? `: ${distinct.join(", ")}` : ""}`
+    });
+    const seen = /* @__PURE__ */ new Set();
+    for (const f3 of design) {
+      if (seen.has(f3.tell)) continue;
+      seen.add(f3.tell);
+      const map = TELL_AREA[f3.tell] ?? { area: "effects" };
+      const both = design.some((g) => g.tell === f3.tell && g.line === 0) && design.some((g) => g.tell === f3.tell && g.line > 0);
+      actions.push({ area: map.area, what: f3.fix, why: `${f3.name} (${f3.tell}, gen ${f3.generation})${both ? ", in source and on the page" : ""}`, priority: both ? 1 : 2, choice: map.choice });
+    }
+    const copy = (input.findings.findings ?? []).filter((f3) => copyTells.has(f3.tell));
+    const byTell = /* @__PURE__ */ new Map();
+    for (const f3 of copy) byTell.set(f3.tell, [...byTell.get(f3.tell) ?? [], f3]);
+    for (const [tell, list] of byTell) {
+      actions.push({ area: "copy", what: list[0].fix, why: `${list[0].name} (${tell}), ${list.length} place${list.length === 1 ? "" : "s"}, first at ${list[0].path}${list[0].line ? `:${list[0].line}` : ""}`, priority: 3 });
+    }
+  } else {
+    signals.push({ id: "tells", raised: null, detail: "not measured" });
+  }
+  if (input.typicality) {
+    const t = input.typicality;
+    signals.push({ id: "typicality", raised: t.typical, detail: `score ${t.score.toFixed(2)}, ${t.typical ? "typical" : "not typical"} of what Claude builds for this brief` });
+    if (t.typical) {
+      for (const s of t.shared) {
+        const map = PART_AREA[s.part];
+        if (!map || DEFAULTS.test(`${s.part} ${s.value}`)) continue;
+        actions.push({ area: map.area, what: `Move off the model's pick for this brief: ${s.part} ${s.value}.`, why: `${s.runs} of ${s.of} null pages chose it`, priority: 1, choice: map.choice });
+      }
+    }
+  } else {
+    signals.push({ id: "typicality", raised: null, detail: "not measured: no null model for this brief" });
+  }
+  if (input.estate) {
+    const siblings = input.estate.filter((m) => m.sibling);
+    const nearest2 = input.estate[0];
+    signals.push({
+      id: "estate",
+      raised: siblings.length > 0,
+      detail: siblings.length ? `sibling of ${siblings.map((s) => `${s.id} (${s.distance.toFixed(2)})`).join(", ")}` : nearest2 ? `nearest ${nearest2.id} at ${nearest2.distance.toFixed(2)}, no sibling` : "the register is empty"
+    });
+    for (const s of siblings) {
+      for (const part of s.shared) {
+        if (DEFAULTS.test(part)) continue;
+        actions.push({ area: areaOfShared(part), what: `Differ from ${s.id}: both have ${part}.`, why: `sibling at ${s.distance.toFixed(2)}`, priority: 1, choice: choiceOfShared(part) });
+      }
+    }
+  } else {
+    signals.push({ id: "estate", raised: null, detail: "not measured: no estate register" });
+  }
+  if (input.direction) {
+    const d = input.direction;
+    const raised2 = !d.valid || d.decided < MIN_DECIDED;
+    signals.push({ id: "reasons", raised: raised2, detail: `${d.decided} of 7 choices decided with a reason${d.valid ? "" : ", art-direction.json has errors"}` });
+    for (const p of d.problems) {
+      const key = p.at.match(/^choices\.(\w+)/)?.[1];
+      if (p.severity === "error" || p.message === "not decided yet") {
+        actions.push({ area: "direction", what: key && p.message === "not decided yet" ? `Decide ${key}, with a source from the client's world.` : `${p.at || "art-direction.json"}: ${p.message}`, why: "the reason rule", priority: 1, choice: key });
+      }
+    }
+  } else {
+    signals.push({ id: "reasons", raised: null, detail: "not measured: no art-direction.json" });
+    actions.push({ area: "direction", what: "Write art-direction.json: run craft direction init, then give every choice a reason from the client's world.", why: "the reason rule", priority: 1 });
+  }
+  const raised = signals.filter((s) => s.raised === true).length;
+  const unmeasured = signals.filter((s) => s.raised === null).map((s) => s.id);
+  const verdict = raised >= 2 ? "default" : raised === 1 ? "mixed" : unmeasured.length ? "unproven" : "decided";
+  const summary = verdict === "default" ? `${raised} of 4 signals raised: nobody chose how this looks.` : verdict === "mixed" ? `1 of 4 signals raised: ${signals.find((s) => s.raised).id}.` : verdict === "decided" ? "No signal raised, and every choice carries a reason." : `No signal raised, but ${unmeasured.join(", ")} not measured. Unverified is not a pass.`;
+  const order = ["direction", "type", "colour", "shape", "effects", "motion", "layout", "copy"];
+  const merged = [];
+  for (const a of actions) {
+    const same = a.choice && a.area !== "direction" && a.area !== "copy" ? merged.find((m) => m.choice === a.choice && m.area === a.area) : void 0;
+    if (same) {
+      const fromTell = /\(\S+, gen \d\)/.test(a.why);
+      same.why = `${same.why}; ${fromTell ? a.why : `${a.what.replace(/\.$/, "")} (${a.why})`}`;
+      same.priority = Math.min(same.priority, a.priority);
+    } else merged.push({ ...a });
+  }
+  const unique = merged.filter((a, i) => merged.findIndex((b) => b.area === a.area && b.what === a.what) === i);
+  unique.sort((a, b) => a.priority - b.priority || order.indexOf(a.area) - order.indexOf(b.area));
+  return { site: input.site, verdict, summary, signals, actions: unique };
+}
+function areaOfShared(part) {
+  if (/headline|body$/.test(part)) return "type";
+  if (/accent|ground/.test(part)) return "colour";
+  if (/buttons/.test(part)) return "shape";
+  if (/reveal/.test(part)) return "motion";
+  if (/running order/.test(part)) return "layout";
+  return "effects";
+}
+function choiceOfShared(part) {
+  if (/headline/.test(part)) return "display";
+  if (/body$/.test(part)) return "body";
+  if (/accent/.test(part)) return "accent";
+  if (/ground/.test(part)) return "ground";
+  if (/buttons/.test(part)) return "shape";
+  if (/reveal/.test(part)) return "signature";
+  return /running order/.test(part) ? void 0 : "motif";
+}
+
+// src/report/retrofit.ts
+var HEADINGS = {
+  direction: "Decide first",
+  type: "Type",
+  colour: "Colour",
+  shape: "Shape",
+  effects: "Effects",
+  motion: "Motion",
+  layout: "How sections look (not where they sit)",
+  copy: "Copy"
+};
+var ORDER2 = ["direction", "type", "colour", "shape", "effects", "motion", "layout", "copy"];
+function target(a, direction) {
+  if (!a.choice || a.area === "direction") return "";
+  const c = direction?.choices?.[a.choice];
+  if (c && c.because && !c.because.startsWith("PROPOSED:")) return `
+  - Use: **${c.value}** for ${a.choice}. ${c.because}`;
+  return `
+  - Waits on: deciding **${a.choice}** in art-direction.json.`;
+}
+function retrofitPlan(report2, direction) {
+  const lines = [
+    `# Retrofit: ${report2.site}`,
+    "",
+    `**Now:** ${report2.verdict}. ${report2.summary}`,
+    "",
+    "| Signal | Raised | Reading |",
+    "|---|---|---|",
+    ...report2.signals.map((s) => `| ${s.id} | ${s.raised === null ? "not measured" : s.raised ? "yes" : "no"} | ${s.detail} |`),
+    "",
+    "**Done when** `craft report` says *decided*: fewer than three design tells, typicality under 0.10 against this brief's null, no sibling in the estate, and at least five of the seven choices decided with a reason.",
+    ""
+  ];
+  let n = 0;
+  for (const area of ORDER2) {
+    const list = report2.actions.filter((a) => a.area === area);
+    if (list.length === 0) continue;
+    n += 1;
+    lines.push(`## ${n}. ${HEADINGS[area]}`, "");
+    for (const a of list) lines.push(`- [ ] ${a.what} *(${a.why})*${target(a, direction)}`);
+    lines.push("");
+  }
+  if (n === 0) lines.push("Nothing to change.", "");
+  lines.push(
+    "## Leave alone",
+    "",
+    "Navigation, the order of the sections, where the call to action sits, reading order and legibility. Change the look, never the page grammar. A layout tell above is about how a section looks: the icon tiles, the chip, the strip. The section stays where it is.",
+    ""
+  );
+  return lines.join("\n");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AI_PHRASES,
@@ -4088,12 +4623,16 @@ function propose(input) {
   DURATION_S,
   EASE,
   EASE_TUPLE,
+  ESTATE_VERSION,
   EXIT_RATIO,
   FINGERPRINT_VERSION,
   HOUSE_BUDGET,
   HOUSE_TYPE,
   LIGHTNESS_CURVE,
+  MIN_DECIDED,
+  MIN_RUNS,
   NEGATIVE_REASSURANCE,
+  NULL_VERSION,
   PILL_LIMIT,
   PLAINER_WORDS,
   PROPOSED,
@@ -4106,27 +4645,37 @@ function propose(input) {
   SCALE,
   SHADCN_LIMIT,
   SHADCN_PRIMITIVES,
+  SIBLING_AT,
   SNAPSHOT_VERSION,
   SOURCE_KINDS,
   SPACE_STEPS,
   SPRING,
   STOCK_PHRASES,
+  TELL_HEAVY,
   TYPE_STEPS,
+  TYPICAL_AT,
   VAGUE_WORDS,
   accentFork,
+  addSite,
   apcaContrast,
   auditSnapshot,
   catalogueTable,
+  characterReport,
   checkCopy,
   checkPair,
   checkRestraint,
+  choicesOf,
+  compareToEstate,
   craftTokens,
   deltaEOk,
   deltaEOkHex,
   densityCss,
   densityTokens,
   emitCss,
+  emptyEstate,
+  estatePairs,
   exitDuration,
+  extractHtml,
   findColours,
   fingerprint,
   fingerprintDistance,
@@ -4136,7 +4685,11 @@ function propose(input) {
   fontClass,
   formatHex,
   formatReport,
+  groundName,
+  harvest,
   hexToOklch,
+  hueName,
+  hueSwatch,
   inP3Gamut,
   inSrgbGamut,
   initDirection,
@@ -4146,6 +4699,7 @@ function propose(input) {
   motionTokens,
   nearest,
   normaliseFamily,
+  nullPrompt,
   oklchToHex,
   oklchToRgb,
   paletteFromPixels,
@@ -4154,16 +4708,22 @@ function propose(input) {
   propose,
   ramp,
   rampFromAnchors,
+  retrofitPlan,
   runTell,
   scanSource,
   sectionRhythm,
   semantic,
+  shapeName,
+  sharedParts,
   shouldAnimate,
+  siblingLine,
   tailwindV3Preset,
   tailwindV4Theme,
   tellById,
   toGamut,
   typeFeatureTokens,
+  typicality,
   validateDirection,
-  wcagContrast
+  wcagContrast,
+  wordListsJson
 });