@domandigital/craft 0.11.0 → 0.13.0

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AI_PHRASES: () => AI_PHRASES,
+  AI_SOURCE_TYPES: () => AI_SOURCE_TYPES,
   AI_VIOLET: () => AI_VIOLET,
   AI_WORDS: () => AI_WORDS,
   BASELINE_VERSION: () => BASELINE_VERSION,
@@ -28,6 +29,7 @@ __export(index_exports, {
   CATALOGUE: () => CATALOGUE,
   CATALOGUE_VERSION: () => CATALOGUE_VERSION,
   CHOICE_KEYS: () => CHOICE_KEYS,
+  COMPONENT_ROLES: () => COMPONENT_ROLES,
   DEFAULT_IGNORE: () => DEFAULT_IGNORE,
   DENSITIES: () => DENSITIES,
   DENSITY_NAMES: () => DENSITY_NAMES,
@@ -37,13 +39,17 @@ __export(index_exports, {
   DURATION_S: () => DURATION_S,
   EASE: () => EASE,
   EASE_TUPLE: () => EASE_TUPLE,
+  EDGE_STEP: () => EDGE_STEP,
   ESTATE_VERSION: () => ESTATE_VERSION,
   EXIT_RATIO: () => EXIT_RATIO,
   FINGERPRINT_VERSION: () => FINGERPRINT_VERSION,
   HOUSE: () => HOUSE,
   HOUSE_BUDGET: () => HOUSE_BUDGET,
+  HOUSE_LOCKED: () => HOUSE_LOCKED,
   HOUSE_TYPE: () => HOUSE_TYPE,
+  IMAGERY_TELLS: () => IMAGERY_TELLS,
   JSON_SCHEMA_VERSION: () => JSON_SCHEMA_VERSION,
+  LICENCES: () => LICENCES,
   LIGHTNESS_CURVE: () => LIGHTNESS_CURVE,
   MIN_DECIDED: () => MIN_DECIDED,
   MIN_RUNS: () => MIN_RUNS,
@@ -51,11 +57,15 @@ __export(index_exports, {
   NULL_VERSION: () => NULL_VERSION,
   PILL_LIMIT: () => PILL_LIMIT,
   PLAINER_WORDS: () => PLAINER_WORDS,
+  PROMO_BADGE: () => PROMO_BADGE,
   PROPOSED: () => PROPOSED,
+  PROVENANCE_SCAN_BYTES: () => PROVENANCE_SCAN_BYTES,
   RAMP_STEPS: () => RAMP_STEPS,
+  READABLE_SNAPSHOT_VERSIONS: () => READABLE_SNAPSHOT_VERSIONS,
   REFLEX_FONTS_1: () => REFLEX_FONTS_1,
   REFLEX_FONTS_2: () => REFLEX_FONTS_2,
   RENDERED_PATHS: () => RENDERED_PATHS,
+  RENDERED_TELLS: () => RENDERED_TELLS,
   REVEAL_LIMIT: () => REVEAL_LIMIT,
   REVIEW_PHRASES: () => REVIEW_PHRASES,
   SCALE: () => SCALE,
@@ -66,6 +76,8 @@ __export(index_exports, {
   SOURCE_KINDS: () => SOURCE_KINDS,
   SPACE_STEPS: () => SPACE_STEPS,
   SPRING: () => SPRING,
+  STOCK_AVATAR_HOSTS: () => STOCK_AVATAR_HOSTS,
+  STOCK_PHOTO_HOSTS: () => STOCK_PHOTO_HOSTS,
   STOCK_PHRASES: () => STOCK_PHRASES,
   TELL_HEAVY: () => TELL_HEAVY,
   TYPE_STEPS: () => TYPE_STEPS,
@@ -84,8 +96,14 @@ __export(index_exports, {
   checkPair: () => checkPair,
   checkRestraint: () => checkRestraint,
   choicesOf: () => choicesOf,
+  closestComponents: () => closestComponents,
   compareFacts: () => compareFacts,
   compareToEstate: () => compareToEstate,
+  componentDistance: () => componentDistance,
+  componentShared: () => componentShared,
+  componentTypicalities: () => componentTypicalities,
+  componentTypicality: () => componentTypicality,
+  componentsOf: () => componentsOf,
   craftTokens: () => craftTokens,
   createBaseline: () => createBaseline,
   deltaEOk: () => deltaEOk,
@@ -94,9 +112,11 @@ __export(index_exports, {
   densityTokens: () => densityTokens,
   emitCss: () => emitCss,
   emptyEstate: () => emptyEstate,
+  estateComponentPairs: () => estateComponentPairs,
   estatePairs: () => estatePairs,
   exitDuration: () => exitDuration,
   extractHtml: () => extractHtml,
+  faceLicence: () => faceLicence,
   findClaims: () => findClaims,
   findColours: () => findColours,
   findingKey: () => findingKey,
@@ -114,6 +134,7 @@ __export(index_exports, {
   groundName: () => groundName,
   harvest: () => harvest,
   hexToOklch: () => hexToOklch,
+  holdHouseBlocks: () => holdHouseBlocks,
   houseRule: () => houseRule,
   hueName: () => hueName,
   hueSwatch: () => hueSwatch,
@@ -123,6 +144,8 @@ __export(index_exports, {
   initDirection: () => initDirection,
   isAiViolet: () => isAiViolet,
   isCream: () => isCream,
+  layoutDistance: () => layoutDistance,
+  licencesJson: () => licencesJson,
   makeSnapshot: () => makeSnapshot,
   motionTokens: () => motionTokens,
   namedSources: () => namedSources,
@@ -140,8 +163,10 @@ __export(index_exports, {
   protectedFacts: () => protectedFacts,
   ramp: () => ramp,
   rampFromAnchors: () => rampFromAnchors,
+  readSnapshot: () => readSnapshot,
   retrofitPlan: () => retrofitPlan,
   runTell: () => runTell,
+  scanProvenance: () => scanProvenance,
   scanSource: () => scanSource,
   sectionRhythm: () => sectionRhythm,
   semantic: () => semantic,
@@ -150,6 +175,8 @@ __export(index_exports, {
   sharedParts: () => sharedParts,
   shouldAnimate: () => shouldAnimate,
   siblingLine: () => siblingLine,
+  stockAvatarSource: () => stockAvatarSource,
+  stockSource: () => stockSource,
   tailwindV3Preset: () => tailwindV3Preset,
   tailwindV4Theme: () => tailwindV4Theme,
   tellById: () => tellById,
@@ -160,6 +187,7 @@ __export(index_exports, {
   typicality: () => typicality,
   validateDirection: () => validateDirection,
   visibleText: () => visibleText,
+  visualMeasures: () => visualMeasures,
   wcagContrast: () => wcagContrast,
   wordListsJson: () => wordListsJson
 });
@@ -2417,14 +2445,14 @@ function contractionHits(ctx) {
   for (const doc2 of documents(ctx)) {
     if (doc2.words < 800) continue;
     const text = doc2.blocks.map((b) => withoutHeadings(b.text)).join("\n");
-    const count2 = (text.match(CONTRACTION) ?? []).length;
-    const rate = count2 * 1e3 / doc2.words;
+    const count3 = (text.match(CONTRACTION) ?? []).length;
+    const rate = count3 * 1e3 / doc2.words;
     if (rate < 1) {
       const first = sentences(doc2)[0];
       hits.push({
         path: doc2.path,
         offset: first?.offset ?? 0,
-        message: `${count2} contraction${count2 === 1 ? "" : "s"} in ${thousands(doc2.words)} words. Prose with none reads stiff; formal legal pages are the exception`
+        message: `${count3} contraction${count3 === 1 ? "" : "s"} in ${thousands(doc2.words)} words. Prose with none reads stiff; formal legal pages are the exception`
       });
     }
   }
@@ -2547,16 +2575,16 @@ function filler(words2, seed = 1, options = {}) {
     return state % n;
   };
   const out = [];
-  let count2 = 0;
+  let count3 = 0;
   let i = 0;
-  while (count2 < words2) {
+  while (count3 < words2) {
     const length = uniform ?? shape[i % shape.length];
     const s = [];
     for (let w = 0; w < length; w += 1) s.push(FILLER_WORDS[next(FILLER_WORDS.length)]);
     if (contractions && i % 6 === 2) s.splice(1, 0, "we're");
     s[0] = s[0].charAt(0).toUpperCase() + s[0].slice(1);
     out.push(`${s.join(" ")}.`);
-    count2 += s.length;
+    count3 += s.length;
     i += 1;
   }
   const paragraphs = [];
@@ -2909,6 +2937,7 @@ var REFLEX_FONTS_2 = [
   "Plus Jakarta Sans",
   "Outfit",
   "Geist",
+  "Cal Sans",
   "Sora",
   "Instrument Sans",
   "Instrument Serif",
@@ -3130,7 +3159,7 @@ function iconTiles(file) {
     return sized && has(unit, /^rounded-(?:md|lg|xl|2xl|full)$/) && has(unit, /^(?:items-center|place-items-center|place-content-center)$/) && has(unit, /^bg-/);
   });
 }
-var ICON_LIBRARY = /from\s+["'](?:lucide-react|@heroicons\/react[^"']*|react-icons[^"']*|@phosphor-icons\/react|@tabler\/icons-react|@radix-ui\/react-icons)["']/;
+var ICON_LIBRARY = /from\s+["'](?:lucide-react|@heroicons\/react[^"']*|react-icons[^"']*|@phosphor-icons\/react|@tabler\/icons-react|@radix-ui\/react-icons|@iconscout\/react-unicons[^"']*|@mui\/icons-material[^"']*|react-material-symbols[^"']*)["']/;
 function iconTileStackHits(ctx) {
   const hits = [];
   for (const file of ctx.files) {
@@ -3277,6 +3306,12 @@ function shadcnHits(ctx) {
   const detail = unused.length > 0 ? `; ${unused.length} imported nowhere` : "";
   return [{ path: ui[0].path, offset: 0, message: `${ui.length} stock shadcn primitives${detail}` }];
 }
+function shadcnCardHits(ctx) {
+  return eachUnit(
+    ctx,
+    (unit) => has(unit, /^bg-card$/) && has(unit, /^text-card-foreground$/) && has(unit, /^border$/) && has(unit, /^rounded-(?:lg|xl)$/) && has(unit, /^shadow(?:-sm)?$/) ? "the registry Card recipe, unchanged" : null
+  );
+}
 function marqueeHits(ctx) {
   const hits = [];
   const pattern = /@keyframes\s+[\w-]*marquee|animate-(?:marquee|scroll-x|infinite-scroll)\b|<Marquee\b|["']react-fast-marquee["']|ui\/marquee["']|animation(?:-name)?\s*:\s*[^;]*marquee/i;
@@ -3494,6 +3529,23 @@ const inter = Inter({ subsets: ["latin"] });`),
       pass: [f3("src/components/ui/button.tsx", `export function Button() { return null; }`)]
     }
   },
+  {
+    id: "shadcn-card-stock",
+    name: "Stock shadcn Card",
+    generation: 1,
+    severity: "warn",
+    surface: "source",
+    why: "The registry Card (bg-card, a plain border, rounded-lg or rounded-xl, shadow-sm) is the container every generated page is built from. Left as shipped, every card on the site looks like every other shadcn site's.",
+    fix: "Give the card this site's radius and shadow from the restraint budget, or drop the shadow and let a visible border carry it.",
+    detect: shadcnCardHits,
+    fixtures: {
+      flag: [
+        f3("components/ui/card.tsx", `className={cn("rounded-lg border bg-card text-card-foreground shadow-sm", className)}`),
+        f3("components/ui/card.tsx", `className={cn("bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm", className)}`)
+      ],
+      pass: [f3("components/ui/card.tsx", `className={cn("rounded-sm border-2 border-ink bg-card text-card-foreground", className)}`)]
+    }
+  },
   {
     id: "cream-palette",
     name: "Cream ground",
@@ -3720,6 +3772,17 @@ var HOUSE = {
 function houseRule(id, name = id) {
   return HOUSE[id] ?? { tier: "review", label: name };
 }
+var HOUSE_LOCKED = "the house blocking tier cannot be lowered by a repo. A genuine one-off takes copy-ok on its line; a rule that is wrong is changed in craft's house.ts and COPY.md";
+function holdHouseBlocks(exceptions, severity) {
+  const blocks = (tell) => HOUSE[tell]?.tier === "block";
+  const refusedSeverity = Object.entries(severity).filter(([tell, o]) => blocks(tell) && o.level !== "block").map(([tell]) => tell);
+  return {
+    exceptions: exceptions.filter((e) => !blocks(e.tell)),
+    refused: exceptions.filter((e) => blocks(e.tell)),
+    severity: Object.fromEntries(Object.entries(severity).filter(([tell]) => !refusedSeverity.includes(tell))),
+    refusedSeverity
+  };
+}
 
 // src/character/parse.ts
 var MARKUP = /\.(tsx|jsx|html?|astro|vue|svelte|mdx)$/i;
@@ -4053,7 +4116,7 @@ function extractStrings(file) {
 }
 
 // src/snapshot/types.ts
-var SNAPSHOT_VERSION = 1;
+var SNAPSHOT_VERSION = 2;
 
 // src/snapshot/fixture.ts
 function makeSnapshot(patch = {}) {
@@ -4386,188 +4449,988 @@ var RENDERED_PATHS = {
   }
 };
 
-// src/character/check.ts
-var CATALOGUE_VERSION = "2026.09.8";
-var CATALOGUE = [...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map(
-  (t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t
-);
-function tellById(id) {
-  return CATALOGUE.find((t) => t.id === id);
-}
-function validateExceptions(exceptions) {
-  const applied = [];
-  const rejected = [];
-  for (const exception of exceptions) {
-    if (!tellById(exception.tell)) {
-      rejected.push({ exception, reason: `no tell called "${exception.tell}"` });
-    } else if (typeof exception.because !== "string" || exception.because.trim().length < 12) {
-      rejected.push({ exception, reason: "an exception needs a because of at least a sentence" });
-    } else {
-      applied.push(exception);
-    }
+// src/fingerprint/index.ts
+var FINGERPRINT_VERSION = 2;
+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;
+};
+function accentOf(s) {
+  const buttons = /* @__PURE__ */ new Map();
+  for (const c of s.controls) {
+    const o = oklch(c.background);
+    if (o && o.c >= CHROMATIC) buttons.set(c.background, (buttons.get(c.background) ?? 0) + 1);
   }
-  return { applied, rejected };
-}
-var MARKER = /\b(?:copy|craft)-ok\b/;
-function marked(lines, line) {
-  return MARKER.test(lines[line - 1] ?? "") || MARKER.test(lines[line - 2] ?? "");
+  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 && 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;
 }
-function toFinding(tell, hit2, texts) {
-  const text = texts.get(hit2.path) ?? "";
+function faces(s) {
+  const byChars = [...s.fonts].sort((a, b) => b.chars - a.chars);
+  const byDisplay = [...s.fonts].sort((a, b) => b.displayChars - a.displayChars);
+  const bodyName = normaliseFamily(byChars[0]?.family ?? "system-ui");
+  const displayName = normaliseFamily((byDisplay[0]?.displayChars ? byDisplay[0].family : byChars[0]?.family) ?? "system-ui");
   return {
-    tell: tell.id,
-    name: tell.name,
-    generation: tell.generation,
-    severity: tell.severity,
-    path: hit2.path,
-    line: texts.has(hit2.path) ? lineAt(text, hit2.offset) : 0,
-    excerpt: hit2.excerpt ?? excerptAt(text, hit2.offset),
-    message: hit2.message,
-    fix: tell.fix,
-    ...tell.surface === "copy" ? { house: houseRule(tell.id, tell.name).tier } : {}
+    display: { family: displayName, class: fontClass(displayName) },
+    body: { family: bodyName, class: fontClass(bodyName) }
   };
 }
-function report(tells, files, run, options) {
-  const { applied, rejected } = validateExceptions(options.exceptions ?? []);
-  const texts = new Map(files.map((file) => [file.path, file.text]));
-  const selected = options.only ? tells.filter((t) => options.only.includes(t.id)) : tells;
-  const findings = [];
-  const suppressed = [];
-  const lineCache = /* @__PURE__ */ new Map();
-  const linesOf = (path) => {
-    let lines = lineCache.get(path);
-    if (!lines) lineCache.set(path, lines = (texts.get(path) ?? "").split("\n"));
-    return lines;
-  };
-  const excepted = /* @__PURE__ */ new Map();
-  for (const tell of selected) {
-    for (const hit2 of run(tell)) {
-      const exception = applied.find((e) => e.tell === tell.id && (!e.path || hit2.path.includes(e.path)));
-      if (exception) {
-        excepted.set(exception, (excepted.get(exception) ?? 0) + 1);
-        continue;
-      }
-      const finding = toFinding(tell, hit2, texts);
-      if (marked(linesOf(hit2.path), finding.line)) {
-        suppressed.push({ tell: tell.id, path: finding.path, line: finding.line });
-        continue;
-      }
-      findings.push(finding);
-    }
-  }
-  findings.sort((a, b) => a.path.localeCompare(b.path) || a.line - b.line || a.tell.localeCompare(b.tell));
-  const byGeneration = { 1: 0, 2: 0, 3: 0 };
-  const byTell = {};
-  for (const finding of findings) {
-    byGeneration[finding.generation] += 1;
-    byTell[finding.tell] = (byTell[finding.tell] ?? 0) + 1;
-  }
+function median(values) {
+  if (values.length === 0) return null;
+  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 fingerprint(s) {
+  const effects = [];
+  if (s.effects.glass > 0) effects.push("glass-panel");
+  if (s.effects.gradientText > 0) effects.push("gradient-text");
+  if (s.effects.glows > 0 || s.effects.gradients.some((g) => g.radial)) effects.push("radial-spotlight-glow");
+  if (s.effects.gridBackgrounds > 0) effects.push("grid-background");
+  if (s.effects.marquees > 0) effects.push("marquee");
+  if (s.effects.hairlineShadowCards >= 3) effects.push("thin-border-wide-shadow");
+  if (s.effects.eyebrowChip) effects.push("hero-eyebrow-chip");
+  if (s.motion.introOverlay) effects.push("intro-cinematic");
+  const below = s.sections.filter((x) => x.top > s.viewport.height).length;
   return {
-    catalogueVersion: CATALOGUE_VERSION,
-    findings,
-    rejectedExceptions: rejected,
-    excepted: [...excepted].map(([e, count2]) => ({ tell: e.tell, because: e.because, count: count2 })),
-    suppressed,
-    summary: {
-      files: files.length,
-      findings: findings.length,
-      byGeneration,
-      byTell,
-      blocking: findings.filter((x) => x.severity === "block").length
-    }
+    version: FINGERPRINT_VERSION,
+    accent: accentOf(s),
+    ground: oklch(s.ground) ?? { l: 1, c: 0, h: 0 },
+    ...faces(s),
+    roundness: median(s.controls.map((c) => Math.min(0.5, c.radiusPx / Math.max(1, c.heightPx)))),
+    motion: below ? Math.min(1, s.motion.hiddenSections / below) : 0,
+    effects: effects.sort(),
+    layout: s.sections.map((x) => x.kind),
+    ...s.sections.length > 0 && s.sections.every((x) => x.role && x.geometry) ? {
+      sections: s.sections.map((x) => ({
+        role: x.role,
+        centred: x.geometry.centredShare,
+        width: x.geometry.contentWidthRatio,
+        symmetry: x.geometry.mirrorSymmetry,
+        controls: x.geometry.controls,
+        cards: x.cards,
+        background: x.geometry.background === s.ground ? null : oklch(x.geometry.background),
+        badges: (x.badges ?? []).map((b) => b.toLowerCase()),
+        avatars: x.avatars ?? 0,
+        carousel: x.carousel ?? false,
+        figures: x.figures ?? 0
+      }))
+    } : {}
   };
 }
-function applyHouseGate(result) {
-  const findings = result.findings.map((f4) => f4.house === "block" ? { ...f4, severity: "block" } : f4);
-  return { ...result, findings, summary: { ...result.summary, blocking: findings.filter((f4) => f4.severity === "block").length } };
+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, cost = (x, y) => x === y ? 0 : 1) {
+  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 + cost(a[i - 1], b[j - 1]));
+      prev = cur;
+    }
+  }
+  return row[b.length];
 }
-function scanSource(files, options = {}) {
-  const ctx = { files: files.map(parseFile) };
-  const tells = CATALOGUE.filter((t) => t.surface === "source");
-  return report(tells, files, (tell) => tell.surface === "source" ? tell.detect(ctx) : [], options);
+function sectionCost(x, y) {
+  if (x.role !== y.role) return 1;
+  return Math.min(0.5, (Math.abs(x.centred - y.centred) + Math.abs(x.width - y.width)) / 2);
 }
-function copyContext(files) {
-  return { files, blocks: files.flatMap(extractCopy), strings: files.flatMap(extractStrings) };
+function layoutDistance(a, b) {
+  if (a.sections && b.sections) {
+    const longest2 = Math.max(a.sections.length, b.sections.length);
+    return longest2 === 0 ? 0 : levenshtein(a.sections, b.sections, sectionCost) / longest2;
+  }
+  const longest = Math.max(a.layout.length, b.layout.length);
+  return longest === 0 ? 0 : levenshtein(a.layout, b.layout) / longest;
 }
-function checkCopy(files, options = {}) {
-  const ctx = copyContext(files);
-  const tells = CATALOGUE.filter((t) => t.surface === "copy");
-  return report(tells, files, (tell) => tell.surface === "copy" ? tell.detect(ctx) : [], options);
+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 auditSnapshot(snapshot, options = {}) {
-  const tells = CATALOGUE.filter((t) => t.rendered);
-  const result = report(tells, [], (tell) => tell.rendered.detect(snapshot), options);
-  result.summary.files = 1;
-  return result;
+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 layout = layoutDistance(a, b);
+  const parts2 = { accent, ground, type, shape, motion, effects, layout };
+  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 runTell(tell, files) {
-  if (tell.surface === "source") return tell.detect({ files: files.map(parseFile) });
-  return tell.detect(copyContext(files));
+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);
 }
-function catalogueTable() {
-  const rows = CATALOGUE.map(
-    (t) => `| \`${t.id}\` | ${t.generation} | ${t.surface}${t.rendered ? " + rendered" : ""} | ${t.severity} | ${t.name} | ${t.why.replace(/\|/g, "\\|")} |`
-  );
+
+// src/null/index.ts
+var NULL_VERSION = 1;
+function nullPrompt(brief) {
   return [
-    `Catalogue version \`${CATALOGUE_VERSION}\`, ${CATALOGUE.length} tells.`,
+    `Build the home page for this business: ${brief.trim()}`,
     "",
-    "| Id | Gen | Surface | Severity | Tell | Why it is a default |",
-    "| --- | --- | --- | --- | --- | --- |",
-    ...rows
+    "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 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";
+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;
 }
-
-// src/character/format.ts
-function formatReport(report2, title) {
-  const lines = [];
-  let current = "";
-  for (const f4 of report2.findings) {
-    if (f4.path !== current) {
-      current = f4.path;
-      lines.push("", f4.path);
-    }
-    lines.push(`  ${String(f4.line).padStart(4)}  ${f4.tell} (gen ${f4.generation}, ${f4.severity})  ${f4.message}`);
-    lines.push(`        ${f4.excerpt}`);
-  }
-  const fixes = new Map(report2.findings.map((f4) => [f4.tell, f4.fix]));
-  if (fixes.size > 0) {
-    lines.push("", "What to do instead:");
-    for (const [tell, fix] of fixes) lines.push(`  ${tell}: ${fix}`);
-  }
-  for (const r of report2.rejectedExceptions) {
-    lines.push("", `Exception not applied (${r.exception.tell}): ${r.reason}`);
-  }
-  for (const e of report2.excepted) {
-    lines.push("", `Excepted: ${e.count} \xD7 ${e.tell}, because ${e.because}`);
-  }
-  if (report2.suppressed.length > 0) {
-    lines.push("", `Suppressed: ${report2.suppressed.length} marked copy-ok or craft-ok (${report2.suppressed.map((s) => `${s.path}:${s.line}`).join(", ")})`);
-  }
-  const { summary } = report2;
-  const gens = `gen 1: ${summary.byGeneration[1]}, gen 2: ${summary.byGeneration[2]}, gen 3: ${summary.byGeneration[3]}`;
-  lines.push(
-    "",
-    `${title}: ${summary.findings} finding${summary.findings === 1 ? "" : "s"} in ${summary.files} file${summary.files === 1 ? "" : "s"} (${gens}). Catalogue ${report2.catalogueVersion}.`
-  );
+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 count3 = all.filter((c) => c[part].includes(value)).length;
+      if (count3 / runs.length >= 0.25) out.push({ part, value, runs: count3, of: runs.length });
+    }
+  }
+  return out.sort((a, b) => b.runs - a.runs);
+}
+var REFLEX_1 = new Set(REFLEX_FONTS_1.map((f4) => f4.toLowerCase()));
+var REFLEX_2 = new Set(REFLEX_FONTS_2.map((f4) => f4.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((f4) => f4.accent && isAiViolet(f4.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 STOP = 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 (STOP.has(g[0]) || STOP.has(g[n - 1])) continue;
+        if (g.filter((w) => !STOP.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) => !STOP.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 f4 of /* @__PURE__ */ new Set([...c.display, ...c.body])) add("face", f4, 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/fingerprint/component.ts
+var PROMO_BADGE = /\b(?:most popular|popular|recommended|best value|best seller|bestseller|most chosen)\b/i;
+function componentsOf(fp, role) {
+  return (fp.sections ?? []).filter((s) => s.role === role);
+}
+var clamp2 = (n) => Math.max(0, Math.min(1, n));
+var diff = (a, b, scale) => a === void 0 || b === void 0 ? null : clamp2(Math.abs(a - b) / scale);
+function componentDistance(a, b) {
+  if (a.role !== b.role) return 1;
+  const promo = (s) => (s.badges ?? []).some((t) => PROMO_BADGE.test(t));
+  const parts2 = [
+    diff(a.centred, b.centred, 1),
+    diff(a.width, b.width, 0.5),
+    diff(a.symmetry, b.symmetry, 0.5),
+    diff(a.controls, b.controls, 2),
+    diff(a.cards, b.cards, 3),
+    diff(a.figures, b.figures, 3),
+    diff(a.avatars, b.avatars, 3),
+    a.carousel === void 0 || b.carousel === void 0 ? null : a.carousel === b.carousel ? 0 : 1,
+    a.badges === void 0 || b.badges === void 0 ? null : promo(a) === promo(b) ? 0 : 1,
+    a.background === void 0 || b.background === void 0 ? null : a.background === null || b.background === null ? a.background === b.background ? 0 : 1 : clamp2(deltaEOk(a.background, b.background) / 0.3)
+  ];
+  const known = parts2.filter((p) => p !== null);
+  return known.length === 0 ? 0 : Math.round(known.reduce((s, p) => s + p, 0) / known.length * 1e3) / 1e3;
+}
+function componentShared(a, b) {
+  if (a.role !== b.role) return [];
+  const out = [];
+  const both = (f4) => f4(a) && f4(b);
+  if (both((s) => s.centred >= 0.7)) out.push("centred");
+  else if (both((s) => s.centred < 0.3)) out.push("left-aligned");
+  if (both((s) => s.width <= 0.6)) out.push("narrow column");
+  else if (both((s) => s.width >= 0.8)) out.push("full width");
+  if (a.controls !== void 0 && a.controls === b.controls && a.controls > 0) out.push(`${a.controls} button${a.controls === 1 ? "" : "s"}`);
+  if (a.cards !== void 0 && a.cards === b.cards && a.cards >= 2) out.push(`${a.cards} cards`);
+  if (both((s) => (s.figures ?? 0) >= 3)) out.push("a row of figures");
+  if (both((s) => (s.avatars ?? 0) >= 2)) out.push("avatars");
+  if (both((s) => s.carousel === true)) out.push("carousel");
+  if (both((s) => (s.badges ?? []).some((t) => PROMO_BADGE.test(t)))) out.push("promo badge");
+  if (a.background && b.background && deltaEOk(a.background, b.background) <= 0.06) out.push("same coloured band");
+  else if (a.background === null && b.background === null) out.push("on the page ground");
+  return out;
+}
+function closestComponents(a, b, role) {
+  let best = null;
+  for (const x of componentsOf(a, role)) {
+    for (const y of componentsOf(b, role)) {
+      const distance = componentDistance(x, y);
+      if (!best || distance < best.distance) best = { distance, shared: componentShared(x, y) };
+    }
+  }
+  return best;
+}
+function estateComponentPairs(register, role) {
+  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 c = closestComponents(s[i].fingerprint, s[j].fingerprint, role);
+      if (c) out.push({ a: s[i].id, b: s[j].id, ...c });
+    }
+  }
+  return out.sort((x, y) => x.distance - y.distance);
+}
+var meanNearest2 = (d, k) => {
+  const s = [...d].sort((a, b) => a - b).slice(0, k);
+  return s.reduce((t, v) => t + v, 0) / s.length;
+};
+function componentTypicality(target2, runs, k = 3) {
+  const pool = runs.flatMap((r) => componentsOf(r.fingerprint, target2.role).slice(0, 1));
+  if (pool.length < MIN_RUNS) return null;
+  const kk = Math.min(k, pool.length - 1);
+  const distance = meanNearest2(pool.map((p) => componentDistance(target2, p)), kk);
+  const loo = pool.map((p, i) => meanNearest2(pool.filter((_, j) => j !== i).map((o) => componentDistance(p, o)), kk));
+  const score = loo.filter((d) => d >= distance).length / loo.length;
+  const sorted = [...loo].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  const baseline = sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
+  return {
+    role: target2.role,
+    score: Math.round(score * 100) / 100,
+    typical: score >= TYPICAL_AT,
+    distance: Math.round(distance * 1e3) / 1e3,
+    baseline: Math.round(baseline * 1e3) / 1e3,
+    runs: pool.length
+  };
+}
+var COMPONENT_ROLES = ["cta-band", "footer-cta", "pricing", "testimonials", "faq", "process", "features", "team", "contact", "stats"];
+function componentTypicalities(fp, runs, k = 3) {
+  const out = [];
+  for (const role of COMPONENT_ROLES) {
+    const first = componentsOf(fp, role)[0];
+    const t = first ? componentTypicality(first, runs, k) : null;
+    if (t) out.push(t);
+  }
+  return out;
+}
+
+// src/snapshot/rendered-tells.ts
+var hit2 = (s, message, excerpt) => ({ path: s.url, offset: 0, message, excerpt: excerpt ?? message });
+var GROUND = "rgb(255, 255, 255)";
+var BAND = "rgb(31, 58, 46)";
+var geo = (patch = {}) => ({
+  centredShare: 0.1,
+  mirrorSymmetry: 0.6,
+  whitespaceRatio: 0.7,
+  contentWidthRatio: 0.85,
+  background: GROUND,
+  controls: 0,
+  ...patch
+});
+function withSection(index, patch, roles = []) {
+  const base = makeSnapshot();
+  return {
+    ...base,
+    sections: base.sections.map((s, i) => ({ ...s, role: roles[i] ?? s.kind, geometry: geo(), badges: [], avatars: 0, carousel: false, figures: 0, ...i === index ? patch : {} }))
+  };
+}
+var measured = (s) => s.geometry !== void 0 && s.role !== void 0;
+var RENDERED_TELLS = [
+  {
+    id: "cta-band-stock",
+    name: "Stock call-to-action band",
+    generation: 1,
+    severity: "warn",
+    surface: "rendered",
+    why: "A full-width coloured band with a centred heading, one line and one or two buttons is what a model closes every section run with. It asks for the booking the same way on every site.",
+    fix: "Keep the ask, change the band: put it where the decision is made (next to the prices, after the proof), in the client's own words, laid out like the rest of the page rather than as a centred slab.",
+    rendered: {
+      detect: (s) => s.sections.filter((x) => measured(x) && (x.role === "cta-band" || x.role === "footer-cta")).filter((x) => {
+        const g = x.geometry;
+        return g.centredShare >= 0.8 && g.background !== s.ground && g.controls >= 1 && g.controls <= 2 && g.contentWidthRatio <= 0.7;
+      }).map((x) => hit2(s, `a centred ${x.role === "footer-cta" ? "closing " : ""}band on its own colour with ${x.geometry.controls === 1 ? "one button" : "two buttons"}`, x.label)),
+      fixtures: {
+        flag: [
+          withSection(4, { role: "footer-cta", label: "Boiler out today?", geometry: geo({ centredShare: 1, background: BAND, controls: 1, contentWidthRatio: 0.45 }) }),
+          withSection(3, { role: "cta-band", label: "Ready to book?", geometry: geo({ centredShare: 0.9, background: BAND, controls: 2, contentWidthRatio: 0.5 }) })
+        ],
+        pass: [
+          makeSnapshot(),
+          // The same ask, laid out like the page: left-aligned on the ground.
+          withSection(4, { role: "footer-cta", label: "Book a visit", geometry: geo({ centredShare: 0.1, background: GROUND, controls: 1, contentWidthRatio: 0.85 }) })
+        ]
+      }
+    }
+  },
+  {
+    id: "pricing-trio-popular",
+    name: "Three-tier pricing with a popular badge",
+    generation: 1,
+    severity: "warn",
+    surface: "rendered",
+    why: "Three price cards with the middle one badged 'Most popular' is the SaaS pricing page, applied to a plumber or a salon whether or not anyone chose the middle option.",
+    fix: "Keep the prices. Show them the way the trade quotes (a price list, per job, per visit), and drop the badge unless it is true and the client can say how many people chose it.",
+    rendered: {
+      detect: (s) => s.sections.filter((x) => measured(x) && x.role === "pricing" && x.cards === 3).filter((x) => (x.badges ?? []).some((b) => PROMO_BADGE.test(b))).map((x) => hit2(s, `three price cards, one badged "${(x.badges ?? []).find((b) => PROMO_BADGE.test(b))}"`, x.label)),
+      fixtures: {
+        flag: [withSection(3, { role: "pricing", kind: "cards", cards: 3, badges: ["Most popular"], label: "Plans" })],
+        pass: [
+          makeSnapshot(),
+          withSection(3, { role: "pricing", kind: "cards", cards: 3, badges: [], label: "Prices" }),
+          withSection(3, { role: "pricing", kind: "text", cards: 0, badges: [], label: "Price list" })
+        ]
+      }
+    }
+  },
+  {
+    id: "testimonial-avatar-carousel",
+    name: "Avatar testimonial carousel",
+    generation: 1,
+    severity: "warn",
+    surface: "rendered",
+    why: "Round headshots over quotes in a sliding carousel is the stock testimonial block. Most visitors see the first slide only, and stock or AI faces make every quote read as invented.",
+    fix: "Show the reviews all at once, where they come from (the Google rating, the named job, the town), with real photos of the work rather than of the reviewer.",
+    rendered: {
+      detect: (s) => s.sections.filter((x) => measured(x) && x.role === "testimonials" && x.carousel === true && (x.avatars ?? 0) >= 2).map((x) => hit2(s, `${x.avatars} round portraits in a sliding testimonial carousel`, x.label)),
+      fixtures: {
+        flag: [withSection(2, { role: "testimonials", avatars: 3, carousel: true, label: "What our clients say" })],
+        pass: [
+          makeSnapshot(),
+          withSection(2, { role: "testimonials", avatars: 3, carousel: false, label: "Reviews" }),
+          withSection(2, { role: "testimonials", avatars: 0, carousel: true, label: "Reviews" })
+        ]
+      }
+    }
+  },
+  {
+    id: "faq-accordion-closer",
+    name: "FAQ accordion as the closer",
+    generation: 2,
+    severity: "warn",
+    surface: "rendered",
+    why: "Ending the page on a collapsed FAQ, often followed only by a band, is the model's default page ending. The answers a buyer needs are hidden behind clicks at the point they decide.",
+    fix: "Answer the questions that block a booking where they arise (price next to prices, area next to the map), and end on the call to action or the proof.",
+    rendered: {
+      detect: (s) => {
+        const body = s.sections.filter((x) => x.role !== "footer-cta" && x.role !== "cta-band");
+        const last = body[body.length - 1];
+        return last && measured(last) && last.role === "faq" ? [hit2(s, "the page ends on a question-and-answer list", last.label)] : [];
+      },
+      fixtures: {
+        flag: [
+          withSection(4, { role: "faq", label: "Common questions" }),
+          {
+            ...withSection(3, { role: "faq", label: "FAQ" }),
+            sections: withSection(3, { role: "faq", label: "FAQ" }).sections.map((x, i) => i === 4 ? { ...x, role: "footer-cta" } : x)
+          }
+        ],
+        pass: [makeSnapshot(), withSection(2, { role: "faq", label: "Common questions" })]
+      }
+    }
+  },
+  {
+    id: "stats-row",
+    name: "Row of big numbers",
+    generation: 1,
+    severity: "warn",
+    surface: "rendered",
+    why: "Three or four large figures in a row (500+ clients, 98% satisfaction, 10 years) is the stock proof block, and the numbers are often round, unsourced or invented.",
+    fix: "Keep a figure only if it is true and sourced, and put it in a sentence next to what it proves. One real number in context beats four in a row.",
+    rendered: {
+      detect: (s) => s.sections.filter((x, i) => measured(x) && (x.role === "stats" || x.kind === "stats") && (x.figures ?? 0) >= 3 && (x.figures ?? 0) <= 6 && !(i === 1 && s.sections[0]?.kind === "hero")).map((x) => hit2(s, `${x.figures} large figures in a row`, x.label)),
+      fixtures: {
+        flag: [withSection(3, { role: "stats", kind: "stats", figures: 4, label: "500+" })],
+        pass: [
+          makeSnapshot(),
+          withSection(3, { role: "text", kind: "text", figures: 1, label: "Since 2009" }),
+          withSection(1, { role: "stats", kind: "stats", figures: 4, label: "500+" })
+        ]
+      }
+    }
+  },
+  {
+    id: "centred-everything",
+    name: "Every section centred",
+    generation: 2,
+    severity: "warn",
+    surface: "rendered",
+    why: "When almost every section stacks a centred heading over centred text, the page has no reading line and every block looks like the one before. It is the layout nothing was decided for.",
+    fix: "Pick an alignment and hold it: left-aligned text with a clear edge, keeping centring for the one moment that earns it.",
+    rendered: {
+      detect: (s) => {
+        const m = s.sections.filter(measured);
+        if (m.length < 4) return [];
+        const centred = m.filter((x) => x.geometry.centredShare >= 0.7).length;
+        return centred / m.length >= 0.8 ? [hit2(s, `${centred} of ${m.length} sections centre their text`)] : [];
+      },
+      fixtures: {
+        flag: [{ ...makeSnapshot(), sections: makeSnapshot().sections.map((x) => ({ ...x, role: x.kind, geometry: geo({ centredShare: 0.9 }) })) }],
+        pass: [
+          makeSnapshot(),
+          { ...makeSnapshot(), sections: makeSnapshot().sections.map((x, i) => ({ ...x, role: x.kind, geometry: geo({ centredShare: i < 2 ? 0.9 : 0.1 }) })) }
+        ]
+      }
+    }
+  }
+];
+
+// src/snapshot/imagery-tells.ts
+var hit3 = (s, message, excerpt) => ({ path: s.url, offset: 0, message, excerpt: excerpt ?? message });
+var STOCK_PHOTO_HOSTS = {
+  "unsplash.com": "Unsplash",
+  "pexels.com": "Pexels",
+  "pixabay.com": "Pixabay",
+  "istockphoto.com": "iStock",
+  "gettyimages.com": "Getty Images",
+  "shutterstock.com": "Shutterstock",
+  "ftcdn.net": "Adobe Stock",
+  "dreamstime.com": "Dreamstime",
+  "depositphotos.com": "Depositphotos",
+  "freepik.com": "Freepik",
+  "rawpixel.com": "rawpixel",
+  "stocksnap.io": "StockSnap",
+  "burst.shopifycdn.com": "Burst",
+  "picsum.photos": "Lorem Picsum",
+  "loremflickr.com": "LoremFlickr",
+  "placehold.co": "a placeholder service",
+  "placeholder.com": "a placeholder service",
+  "dummyimage.com": "a placeholder service"
+};
+var STOCK_AVATAR_HOSTS = {
+  "randomuser.me": "randomuser.me",
+  "pravatar.cc": "Pravatar",
+  "dicebear.com": "DiceBear",
+  "xsgames.co": "a random-face service",
+  "thispersondoesnotexist.com": "a generated face",
+  "generated.photos": "a generated face"
+};
+var STOCK_FILENAMES = [
+  [/(?:^|[/_-])shutterstock[_-]?\d{4,}/i, "Shutterstock"],
+  [/(?:^|[/_-])istock(?:photo)?[_-]?\d{4,}/i, "iStock"],
+  [/(?:^|[/_-])adobestock[_-]?\d{4,}/i, "Adobe Stock"],
+  [/(?:^|[/_-])gettyimages[_-]?\d{4,}/i, "Getty Images"],
+  [/(?:^|[/_-])depositphotos[_-]?\d{4,}/i, "Depositphotos"],
+  [/(?:^|[/_-])dreamstime[_-]/i, "Dreamstime"],
+  [/(?:^|[/_-])pexels-[a-z0-9-]*\d{4,}/i, "Pexels"],
+  [/-unsplash\.(?:jpe?g|png|webp|avif)(?:[?#]|$)/i, "Unsplash"],
+  // Unsplash's photo ids: photo-<13-digit timestamp>-<12 hex>.
+  [/photo-1\d{12}-[0-9a-f]{12}/, "Unsplash"]
+];
+var byHost = (host, table) => {
+  if (!host) return null;
+  const h = host.toLowerCase();
+  for (const [domain, name] of Object.entries(table)) if (h === domain || h.endsWith(`.${domain}`)) return name;
+  return null;
+};
+function stockSource(image) {
+  const host = byHost(image.host, STOCK_PHOTO_HOSTS);
+  if (host) return host;
+  let path = image.src.replace(/^[a-z][a-z0-9+.-]*:\/\/[^/?#]*/i, "").replace(/[?#].*$/, "");
+  try {
+    path = decodeURIComponent(path);
+  } catch {
+  }
+  for (const [re, name] of STOCK_FILENAMES) if (re.test(path)) return name;
+  return null;
+}
+function stockAvatarSource(image) {
+  return byHost(image.host, STOCK_AVATAR_HOSTS) ?? stockSource(image);
+}
+var picture = (patch = {}) => ({
+  src: "https://example.test/images/boiler-swap-hinton.jpg",
+  host: "example.test",
+  width: 640,
+  height: 480,
+  top: 1800,
+  role: "photo",
+  alt: "The new combi boiler fitted in a kitchen cupboard in Hinton",
+  decorative: false,
+  section: 2,
+  background: false,
+  ...patch
+});
+var withImages = (images) => ({ ...makeSnapshot(), images });
+var AI_XMP = { digitalSourceType: "trainedAlgorithmicMedia", source: "xmp", c2pa: false, bytes: 48e3 };
+var NOTHING = { digitalSourceType: null, source: null, c2pa: false, bytes: 48e3 };
+var count2 = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+var IMAGERY_TELLS = [
+  {
+    id: "stock-photo",
+    name: "Stock photography",
+    generation: 1,
+    severity: "warn",
+    surface: "rendered",
+    why: "A picture from a stock library is the picture every other site in the trade can use. It shows a job the client did not do, in a kitchen that is not theirs, and a visitor who has seen it before stops believing the rest.",
+    fix: "Use a photo of the client's own work, premises or people, even a plain one taken on a phone. Where there is none yet, use fewer pictures rather than a library one.",
+    rendered: {
+      detect: (s) => {
+        const found = (s.images ?? []).filter((i) => i.role === "photo" || i.role === "illustration").map((i) => ({ image: i, from: stockSource(i) })).filter((x) => x.from);
+        if (found.length === 0) return [];
+        const names = [...new Set(found.map((x) => x.from))].join(", ");
+        return [hit3(s, `${count2(found.length, "picture")} from ${names}`, found[0].image.src)];
+      },
+      fixtures: {
+        flag: [
+          withImages([picture({ src: "https://images.unsplash.com/photo-1581578731548-c64695cc6952?w=1600", host: "images.unsplash.com", alt: "Plumber fixing a sink" })]),
+          // Downloaded and self-hosted, found by the library's own file name.
+          withImages([picture({ src: "https://example.test/img/shutterstock_1234567890.jpg" })])
+        ],
+        pass: [makeSnapshot(), withImages([picture()]), withImages([picture({ role: "icon", width: 48, height: 48, src: "https://images.unsplash.com/photo-1581578731548-c64695cc6952", host: "images.unsplash.com" })])]
+      }
+    }
+  },
+  {
+    id: "stock-avatar",
+    name: "Stock or placeholder faces",
+    generation: 1,
+    severity: "warn",
+    surface: "rendered",
+    why: "Round portraits from a placeholder-face service or a stock library next to reviews make every quote read as invented, and some of those faces are generated people who do not exist.",
+    fix: "Drop the portraits. Name the reviewer, the town and the job, and link the review to where it was left.",
+    rendered: {
+      detect: (s) => {
+        const found = (s.images ?? []).filter((i) => i.role === "avatar").map((i) => ({ image: i, from: stockAvatarSource(i) })).filter((x) => x.from);
+        if (found.length === 0) return [];
+        const names = [...new Set(found.map((x) => x.from))].join(", ");
+        return [hit3(s, `${count2(found.length, "portrait")} from ${names}`, found[0].image.src)];
+      },
+      fixtures: {
+        flag: [
+          withImages([picture(), picture({ role: "avatar", width: 56, height: 56, src: "https://i.pravatar.cc/150?img=12", host: "i.pravatar.cc", alt: "Sarah" })]),
+          withImages([picture({ role: "avatar", width: 64, height: 64, src: "https://images.unsplash.com/photo-1494790108377-be9c29b29330?crop=faces", host: "images.unsplash.com" })])
+        ],
+        pass: [makeSnapshot(), withImages([picture(), picture({ role: "avatar", width: 56, height: 56, src: "https://example.test/team/sam.jpg", alt: "Sam, engineer" })])]
+      }
+    }
+  },
+  {
+    id: "ai-image",
+    name: "Generated image",
+    generation: 2,
+    severity: "warn",
+    surface: "rendered",
+    why: "The file itself says a model made it (its XMP or Content Credentials name a trained-model source). A generated picture stands in for work the client did not photograph, and anyone can read the label.",
+    fix: "Replace it with a photo of the real thing: the work, the premises, the people. Where there is none yet, use fewer pictures.",
+    rendered: {
+      detect: (s) => {
+        const found = (s.images ?? []).filter((i) => i.provenance?.digitalSourceType);
+        if (found.length === 0) return [];
+        const first = found[0].provenance;
+        const where = first.source === "xmp" ? "its XMP metadata" : first.source === "c2pa" ? "its Content Credentials" : "its metadata";
+        return [hit3(s, `${count2(found.length, "image")} labelled as made by a generative model (${first.digitalSourceType} in ${where})`, found[0].src)];
+      },
+      fixtures: {
+        flag: [
+          withImages([picture({ provenance: AI_XMP })]),
+          withImages([picture({ provenance: { digitalSourceType: "compositeWithTrainedAlgorithmicMedia", source: "c2pa", c2pa: true, bytes: 12e4 } })])
+        ],
+        // Credentials that say nothing about a model, and an image never read, are not findings.
+        pass: [makeSnapshot(), withImages([picture({ provenance: NOTHING })]), withImages([picture({ provenance: { ...NOTHING, c2pa: true } })]), withImages([picture()])]
+      }
+    }
+  },
+  {
+    id: "no-real-imagery",
+    name: "No photograph on the page",
+    generation: 1,
+    severity: "warn",
+    surface: "rendered",
+    why: "A page with no photograph at all, only icons and illustrations, is the page a model builds when it has no assets. Icon tiles stand in for the evidence a buyer looks for: the work, the premises, the people.",
+    fix: "Add one real photo of the work where the claim is made: a finished job next to the service, the team next to the booking. One plain photo beats any number of icons.",
+    rendered: {
+      detect: (s) => {
+        if (!s.images || s.sections.length < 4) return [];
+        if (s.images.some((i) => i.role === "photo")) return [];
+        const icons = s.images.filter((i) => i.role === "icon" || i.role === "illustration").length;
+        return [hit3(s, `no photograph on the page${icons ? `: ${count2(icons, "icon or illustration", "icons and illustrations")} instead` : ""}`)];
+      },
+      fixtures: {
+        flag: [
+          withImages([picture({ role: "icon", width: 48, height: 48, src: "https://example.test/icons/wrench.svg" }), picture({ role: "illustration", width: 480, height: 360, src: "https://example.test/hero.svg" })]),
+          withImages([])
+        ],
+        // A snapshot with no image record is never judged; nor is a page too short to be a site.
+        pass: [makeSnapshot(), withImages([picture()]), { ...withImages([]), sections: makeSnapshot().sections.slice(0, 3) }]
+      }
+    }
+  }
+];
+
+// src/character/check.ts
+var CATALOGUE_VERSION = "2026.09.11";
+var CATALOGUE = [
+  ...[...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map((t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t),
+  ...RENDERED_TELLS,
+  ...IMAGERY_TELLS
+];
+function tellById(id) {
+  return CATALOGUE.find((t) => t.id === id);
+}
+function validateExceptions(exceptions) {
+  const applied = [];
+  const rejected = [];
+  for (const exception of exceptions) {
+    if (!tellById(exception.tell)) {
+      rejected.push({ exception, reason: `no tell called "${exception.tell}"` });
+    } else if (typeof exception.because !== "string" || exception.because.trim().length < 12) {
+      rejected.push({ exception, reason: "an exception needs a because of at least a sentence" });
+    } else {
+      applied.push(exception);
+    }
+  }
+  return { applied, rejected };
+}
+var MARKER = /\b(?:copy|craft)-ok\b/;
+function marked(lines, line) {
+  return MARKER.test(lines[line - 1] ?? "") || MARKER.test(lines[line - 2] ?? "");
+}
+function toFinding(tell, hit4, texts) {
+  const text = texts.get(hit4.path) ?? "";
+  return {
+    tell: tell.id,
+    name: tell.name,
+    generation: tell.generation,
+    severity: tell.severity,
+    path: hit4.path,
+    line: texts.has(hit4.path) ? lineAt(text, hit4.offset) : 0,
+    excerpt: hit4.excerpt ?? excerptAt(text, hit4.offset),
+    message: hit4.message,
+    fix: tell.fix,
+    ...tell.surface === "copy" ? { house: houseRule(tell.id, tell.name).tier } : {}
+  };
+}
+function report(tells, files, run, options) {
+  const { applied, rejected } = validateExceptions(options.exceptions ?? []);
+  const texts = new Map(files.map((file) => [file.path, file.text]));
+  const selected = options.only ? tells.filter((t) => options.only.includes(t.id)) : tells;
+  const findings = [];
+  const suppressed = [];
+  const lineCache = /* @__PURE__ */ new Map();
+  const linesOf = (path) => {
+    let lines = lineCache.get(path);
+    if (!lines) lineCache.set(path, lines = (texts.get(path) ?? "").split("\n"));
+    return lines;
+  };
+  const excepted = /* @__PURE__ */ new Map();
+  for (const tell of selected) {
+    for (const hit4 of run(tell)) {
+      const exception = applied.find((e) => e.tell === tell.id && (!e.path || hit4.path.includes(e.path)));
+      if (exception) {
+        excepted.set(exception, (excepted.get(exception) ?? 0) + 1);
+        continue;
+      }
+      const finding = toFinding(tell, hit4, texts);
+      if (marked(linesOf(hit4.path), finding.line)) {
+        suppressed.push({ tell: tell.id, path: finding.path, line: finding.line });
+        continue;
+      }
+      findings.push(finding);
+    }
+  }
+  findings.sort((a, b) => a.path.localeCompare(b.path) || a.line - b.line || a.tell.localeCompare(b.tell));
+  const byGeneration = { 1: 0, 2: 0, 3: 0 };
+  const byTell = {};
+  for (const finding of findings) {
+    byGeneration[finding.generation] += 1;
+    byTell[finding.tell] = (byTell[finding.tell] ?? 0) + 1;
+  }
+  return {
+    catalogueVersion: CATALOGUE_VERSION,
+    findings,
+    rejectedExceptions: rejected,
+    excepted: [...excepted].map(([e, count3]) => ({ tell: e.tell, because: e.because, count: count3 })),
+    suppressed,
+    summary: {
+      files: files.length,
+      findings: findings.length,
+      byGeneration,
+      byTell,
+      blocking: findings.filter((x) => x.severity === "block").length
+    }
+  };
+}
+function applyHouseGate(result) {
+  const findings = result.findings.map((f4) => f4.house === "block" ? { ...f4, severity: "block" } : f4);
+  return { ...result, findings, summary: { ...result.summary, blocking: findings.filter((f4) => f4.severity === "block").length } };
+}
+function scanSource(files, options = {}) {
+  const ctx = { files: files.map(parseFile) };
+  const tells = CATALOGUE.filter((t) => t.surface === "source");
+  return report(tells, files, (tell) => tell.surface === "source" ? tell.detect(ctx) : [], options);
+}
+function copyContext(files) {
+  return { files, blocks: files.flatMap(extractCopy), strings: files.flatMap(extractStrings) };
+}
+function checkCopy(files, options = {}) {
+  const ctx = copyContext(files);
+  const tells = CATALOGUE.filter((t) => t.surface === "copy");
+  return report(tells, files, (tell) => tell.surface === "copy" ? tell.detect(ctx) : [], options);
+}
+function auditSnapshot(snapshot, options = {}) {
+  const tells = CATALOGUE.filter((t) => t.rendered);
+  const result = report(tells, [], (tell) => tell.rendered.detect(snapshot), options);
+  result.summary.files = 1;
+  return result;
+}
+function runTell(tell, files) {
+  if (tell.surface === "source") return tell.detect({ files: files.map(parseFile) });
+  if (tell.surface === "rendered") throw new Error(`${tell.id} is seen on a rendered page only; run tell.rendered.detect(snapshot)`);
+  return tell.detect(copyContext(files));
+}
+function catalogueTable() {
+  const rows = CATALOGUE.map(
+    (t) => `| \`${t.id}\` | ${t.generation} | ${t.surface}${t.rendered ? " + rendered" : ""} | ${t.severity} | ${t.name} | ${t.why.replace(/\|/g, "\\|")} |`
+  );
+  return [
+    `Catalogue version \`${CATALOGUE_VERSION}\`, ${CATALOGUE.length} tells.`,
+    "",
+    "| Id | Gen | Surface | Severity | Tell | Why it is a default |",
+    "| --- | --- | --- | --- | --- | --- |",
+    ...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) {
+  const lines = [];
+  let current = "";
+  for (const f4 of report2.findings) {
+    if (f4.path !== current) {
+      current = f4.path;
+      lines.push("", f4.path);
+    }
+    lines.push(`  ${String(f4.line).padStart(4)}  ${f4.tell} (gen ${f4.generation}, ${f4.severity})  ${f4.message}`);
+    lines.push(`        ${f4.excerpt}`);
+  }
+  const fixes = new Map(report2.findings.map((f4) => [f4.tell, f4.fix]));
+  if (fixes.size > 0) {
+    lines.push("", "What to do instead:");
+    for (const [tell, fix] of fixes) lines.push(`  ${tell}: ${fix}`);
+  }
+  for (const r of report2.rejectedExceptions) {
+    lines.push("", `Exception not applied (${r.exception.tell}): ${r.reason}`);
+  }
+  for (const e of report2.excepted) {
+    lines.push("", `Excepted: ${e.count} \xD7 ${e.tell}, because ${e.because}`);
+  }
+  if (report2.suppressed.length > 0) {
+    lines.push("", `Suppressed: ${report2.suppressed.length} marked copy-ok or craft-ok (${report2.suppressed.map((s) => `${s.path}:${s.line}`).join(", ")})`);
+  }
+  const { summary } = report2;
+  const gens = `gen 1: ${summary.byGeneration[1]}, gen 2: ${summary.byGeneration[2]}, gen 3: ${summary.byGeneration[3]}`;
+  lines.push(
+    "",
+    `${title}: ${summary.findings} finding${summary.findings === 1 ? "" : "s"} in ${summary.files} file${summary.files === 1 ? "" : "s"} (${gens}). Catalogue ${report2.catalogueVersion}.`
+  );
   return lines.join("\n").replace(/^\n/, "");
 }
 
@@ -4954,101 +5817,110 @@ function toJson(data) {
   return JSON.stringify({ schemaVersion: JSON_SCHEMA_VERSION, ...data }, null, 2);
 }
 
-// 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;
-};
-function accentOf(s) {
-  const buttons = /* @__PURE__ */ new Map();
-  for (const c of s.controls) {
-    const o = oklch(c.background);
-    if (o && o.c >= CHROMATIC) buttons.set(c.background, (buttons.get(c.background) ?? 0) + 1);
+// src/snapshot/provenance.ts
+var PROVENANCE_SCAN_BYTES = 256 * 1024;
+var AI_SOURCE_TYPES = ["compositeWithTrainedAlgorithmicMedia", "trainedAlgorithmicMedia"];
+var MARKER2 = new RegExp(`(?:${AI_SOURCE_TYPES.join("|")})`);
+var C2PA_BOX = /jumd[\s\S]{16,24}c2pa/;
+var C2PA_PNG = /caBX/;
+function latin1(bytes) {
+  let out = "";
+  for (let i = 0; i < bytes.length; i += 8192) {
+    out += String.fromCharCode(...bytes.subarray(i, Math.min(bytes.length, i + 8192)));
   }
-  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 && 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;
+  return out;
 }
-function faces(s) {
-  const byChars = [...s.fonts].sort((a, b) => b.chars - a.chars);
-  const byDisplay = [...s.fonts].sort((a, b) => b.displayChars - a.displayChars);
-  const bodyName = normaliseFamily(byChars[0]?.family ?? "system-ui");
-  const displayName = normaliseFamily((byDisplay[0]?.displayChars ? byDisplay[0].family : byChars[0]?.family) ?? "system-ui");
-  return {
-    display: { family: displayName, class: fontClass(displayName) },
-    body: { family: bodyName, class: fontClass(bodyName) }
-  };
+function xmpPackets(text) {
+  const out = [];
+  const open = /<x:xmpmeta\b|<\?xpacket begin/g;
+  let m;
+  while (m = open.exec(text)) {
+    const close = text.indexOf(m[0].startsWith("<x:") ? "</x:xmpmeta>" : "<?xpacket end", m.index);
+    out.push([m.index, close === -1 ? text.length : close]);
+    if (close === -1) break;
+    open.lastIndex = close;
+  }
+  return out;
 }
-function median(values) {
-  if (values.length === 0) return null;
-  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 scanProvenance(bytes) {
+  const head = bytes.subarray(0, PROVENANCE_SCAN_BYTES);
+  const text = latin1(head);
+  const c2pa = C2PA_BOX.test(text) || text.startsWith("\x89PNG") && C2PA_PNG.test(text);
+  const m = MARKER2.exec(text);
+  if (!m) return { digitalSourceType: null, source: null, c2pa, bytes: head.length };
+  const inXmp = xmpPackets(text).some(([a, b]) => m.index >= a && m.index < b);
+  return { digitalSourceType: m[0], source: inXmp ? "xmp" : c2pa ? "c2pa" : "other", c2pa, bytes: head.length };
 }
-function fingerprint(s) {
-  const effects = [];
-  if (s.effects.glass > 0) effects.push("glass-panel");
-  if (s.effects.gradientText > 0) effects.push("gradient-text");
-  if (s.effects.glows > 0 || s.effects.gradients.some((g) => g.radial)) effects.push("radial-spotlight-glow");
-  if (s.effects.gridBackgrounds > 0) effects.push("grid-background");
-  if (s.effects.marquees > 0) effects.push("marquee");
-  if (s.effects.hairlineShadowCards >= 3) effects.push("thin-border-wide-shadow");
-  if (s.effects.eyebrowChip) effects.push("hero-eyebrow-chip");
-  if (s.motion.introOverlay) effects.push("intro-cinematic");
-  const below = s.sections.filter((x) => x.top > s.viewport.height).length;
-  return {
-    version: FINGERPRINT_VERSION,
-    accent: accentOf(s),
-    ground: oklch(s.ground) ?? { l: 1, c: 0, h: 0 },
-    ...faces(s),
-    roundness: median(s.controls.map((c) => Math.min(0.5, c.radiusPx / Math.max(1, c.heightPx)))),
-    motion: below ? Math.min(1, s.motion.hiddenSections / below) : 0,
-    effects: effects.sort(),
-    layout: s.sections.map((x) => x.kind)
-  };
+
+// src/snapshot/migrate.ts
+var READABLE_SNAPSHOT_VERSIONS = [1, 2];
+function readSnapshot(data, source = "snapshot") {
+  const v = data?.version;
+  if (typeof data !== "object" || data === null || !READABLE_SNAPSHOT_VERSIONS.includes(v)) {
+    throw new Error(`${source} is not a snapshot this craft reads (version ${String(v)}; reads ${READABLE_SNAPSHOT_VERSIONS.join(" and ")})`);
+  }
+  const snap = data;
+  if (snap.version === 1) return { ...snap, version: SNAPSHOT_VERSION, migratedFrom: 1 };
+  return snap;
 }
-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;
+
+// src/snapshot/visual.ts
+var EDGE_STEP = 32;
+function visualMeasures(img, maxSamples = 1e6) {
+  const { width: w, height: h, rgba } = img;
+  if (w < 2 || h < 2 || rgba.length < w * h * 4) throw new Error(`visualMeasures: ${w}x${h} image with ${rgba.length} bytes`);
+  const step = Math.max(1, Math.ceil(Math.sqrt(w * h / maxSamples)));
+  const lum = (x, y) => {
+    const i = (y * w + x) * 4;
+    return 0.2126 * rgba[i] + 0.7152 * rgba[i + 1] + 0.0722 * rgba[i + 2];
+  };
+  let n = 0;
+  let sumRg = 0;
+  let sumYb = 0;
+  let sumRg2 = 0;
+  let sumYb2 = 0;
+  let edges = 0;
+  let edgeN = 0;
+  let asym = 0;
+  let asymN = 0;
+  for (let y = 0; y < h; y += step) {
+    for (let x = 0; x < w; x += step) {
+      const i = (y * w + x) * 4;
+      const r = rgba[i];
+      const g = rgba[i + 1];
+      const b = rgba[i + 2];
+      const rg = r - g;
+      const yb = 0.5 * (r + g) - b;
+      sumRg += rg;
+      sumYb += yb;
+      sumRg2 += rg * rg;
+      sumYb2 += yb * yb;
+      n += 1;
+      const l = lum(x, y);
+      if (x + step < w && y + step < h) {
+        if (Math.abs(lum(x + step, y) - l) + Math.abs(lum(x, y + step) - l) > EDGE_STEP) edges += 1;
+        edgeN += 1;
+      }
+      if (x < w / 2) {
+        asym += Math.abs(l - lum(w - 1 - x, y));
+        asymN += 1;
+      }
     }
   }
-  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 parts2 = { accent, ground, type, shape, motion, effects, layout };
-  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(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);
+  const meanRg = sumRg / n;
+  const meanYb = sumYb / n;
+  const sdRg = Math.sqrt(Math.max(0, sumRg2 / n - meanRg * meanRg));
+  const sdYb = Math.sqrt(Math.max(0, sumYb2 / n - meanYb * meanYb));
+  const colourfulness = Math.sqrt(sdRg ** 2 + sdYb ** 2) + 0.3 * Math.sqrt(meanRg ** 2 + meanYb ** 2);
+  const round2 = (v, d = 3) => Math.round(v * 10 ** d) / 10 ** d;
+  return {
+    colourfulness: round2(colourfulness, 1),
+    edgeDensity: round2(edgeN ? edges / edgeN : 0),
+    symmetry: round2(asymN ? 1 - asym / asymN / 255 : 1),
+    width: w,
+    height: h,
+    sampled: n
+  };
 }
 
 // src/direction/types.ts
@@ -5070,13 +5942,124 @@ var SOURCE_KINDS = [
 ];
 var CHOICE_KEYS = ["accent", "ground", "display", "body", "shape", "motif", "signature"];
 
+// src/direction/licences.ts
+var LICENCES = [
+  {
+    name: "Basteleur",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://velvetyne.fr/fonts/basteleur/",
+    note: "Velvetyne, designed by Keussel. Keep the OFL notice with the font files."
+  },
+  {
+    name: "Gulax",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://velvetyne.fr/fonts/gulax/",
+    note: "Velvetyne. Keep the OFL notice with the font files."
+  },
+  {
+    name: "Le Murmure",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://velvetyne.fr/fonts/le-murmure/",
+    note: "Velvetyne. Keep the OFL notice with the font files."
+  },
+  {
+    name: "Blaze Type",
+    subject: "foundry",
+    licence: "commercial",
+    multiClient: "per-site",
+    cap: 10,
+    checked: "2026-09-24",
+    source: "https://blazetype.eu/eula",
+    note: "The EULA sells a professional licence for 1 to 10 websites, and lets an agency buy in a client's name at the listed price. Its /license page says one licence covers every domain; the EULA is the contract, so buy per client."
+  },
+  {
+    name: "Power Type",
+    subject: "foundry",
+    licence: "commercial",
+    multiClient: "unverified",
+    checked: "2026-09-24",
+    source: "https://power-type.com/eula",
+    note: "Research on 2026-09-11 reported a Super License capped at 10 self-hosted domains. The EULA page did not load when checked; read it before relying on the cap."
+  },
+  {
+    name: "Grilli Type",
+    subject: "foundry",
+    licence: "commercial",
+    multiClient: "per-site",
+    checked: "2026-09-24",
+    source: "https://www.grillitype.com/information",
+    note: "Web licences cover any number of domains controlled by the licensee, priced by monthly visitors, so a client site needs the client's own licence. Unlimited tiers start at $10,000 per style."
+  },
+  {
+    name: "Phosphor",
+    subject: "icons",
+    licence: "MIT",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://github.com/phosphor-icons/core/blob/main/LICENSE",
+    note: "Six weights. The icon-tile tells treat it exactly as they treat Lucide: the library is not the tell, the tinted tile is."
+  },
+  {
+    name: "Tabler Icons",
+    subject: "icons",
+    licence: "MIT",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://github.com/tabler/tabler-icons/blob/main/LICENSE",
+    note: "One stroke grid across the set."
+  },
+  {
+    name: "Iconoir",
+    subject: "icons",
+    licence: "MIT",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://github.com/iconoir-icons/iconoir/blob/main/LICENSE",
+    note: "Smaller set, no paid tier."
+  },
+  {
+    name: "Unicons",
+    subject: "icons",
+    licence: "IconScout Simple License",
+    multiClient: "yes",
+    checked: "2026-09-24",
+    source: "https://github.com/Iconscout/unicons/blob/master/LICENSE",
+    note: "IconScout's free set, personal and commercial use, attribution optional."
+  },
+  {
+    name: "IconScout premium",
+    subject: "icons",
+    licence: "commercial",
+    multiClient: "per-site",
+    checked: "2026-09-24",
+    source: "https://iconscout.com/licenses",
+    note: "Each licence covers a single end product. Never in a tool, template or shared kit (create-site, craft, a house component library), even modified. Record the assets each site uses. Assets come from different contributors, so take one site's set from one contributor."
+  }
+];
+function faceLicence(family) {
+  const name = family.trim().toLowerCase();
+  return LICENCES.find((l) => l.subject === "face" && l.name.toLowerCase() === name);
+}
+function licencesJson() {
+  return JSON.stringify({ licences: LICENCES }, null, 2) + "\n";
+}
+
 // 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"]);
+var STOP2 = /* @__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)));
+  return new Set((text.toLowerCase().match(/[a-z][a-z'-]{3,}/g) ?? []).map((w) => w.replace(/'s$/, "")).filter((w) => !STOP2.has(w) && !VALUE_WORDS.has(w)));
 }
 function tellFor(key, value) {
   if (key === "accent") {
@@ -5193,18 +6176,30 @@ function validateDirection(input, ctx = {}) {
         ok = false;
       }
     }
+    if ((key === "display" || key === "body") && typeof c.value === "string" && c.value.trim()) {
+      const family = normaliseFamily(c.value);
+      const entry = faceLicence(family);
+      if (!entry) {
+        warn(`${at}.value`, `${family}: licence not in craft's register. Read the licensor's own terms for use on this client's site, then add it to src/direction/licences.ts.`);
+      } else if (entry.multiClient === "unverified") {
+        warn(`${at}.value`, `${family}: licence unverified (${entry.note})`);
+      } else if (entry.multiClient === "capped" || entry.multiClient === "per-site") {
+        const scope = entry.multiClient === "capped" ? `covers up to ${entry.cap} sites` : "needs a licence for this site, in the client's name";
+        warn(`${at}.value`, `${family}: ${entry.licence} licence ${scope}. Record the purchase before launch.`);
+      }
+    }
     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)})`);
+        const measured2 = key === "accent" ? fp.accent : fp.ground;
+        if (measured2 && deltaEOk(declared, measured2) > 0.08) {
+          warn(`${at}.value`, `the page does not show it: its ${key} measures oklch(${measured2.l.toFixed(2)} ${measured2.c.toFixed(3)} ${measured2.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}`);
+        const measured2 = key === "display" ? fp.display.family : fp.body.family;
+        if (normaliseFamily(c.value).toLowerCase() !== measured2.toLowerCase()) warn(`${at}.value`, `the page sets ${measured2}, not ${c.value}`);
       }
     }
     if (ok) decided += 1;
@@ -5215,8 +6210,8 @@ function validateDirection(input, ctx = {}) {
 // src/direction/init.ts
 var hex = (o) => {
   const { r, g, b } = oklchToRgb(o);
-  const clamp2 = (n) => Math.min(1, Math.max(0, n));
-  return formatHex({ r: clamp2(r), g: clamp2(g), b: clamp2(b) });
+  const clamp3 = (n) => Math.min(1, Math.max(0, n));
+  return formatHex({ r: clamp3(r), g: clamp3(g), b: clamp3(b) });
 };
 function initDirection(input) {
   const fp = input.current;
@@ -5356,240 +6351,6 @@ function propose(input) {
   };
 }
 
-// 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((f4) => f4.toLowerCase()));
-var REFLEX_2 = new Set(REFLEX_FONTS_2.map((f4) => f4.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((f4) => f4.accent && isAiViolet(f4.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 f4 of /* @__PURE__ */ new Set([...c.display, ...c.body])) add("face", f4, 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;
@@ -5847,6 +6608,7 @@ function retrofitPlan(report2, direction) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AI_PHRASES,
+  AI_SOURCE_TYPES,
   AI_VIOLET,
   AI_WORDS,
   BASELINE_VERSION,
@@ -5854,6 +6616,7 @@ function retrofitPlan(report2, direction) {
   CATALOGUE,
   CATALOGUE_VERSION,
   CHOICE_KEYS,
+  COMPONENT_ROLES,
   DEFAULT_IGNORE,
   DENSITIES,
   DENSITY_NAMES,
@@ -5863,13 +6626,17 @@ function retrofitPlan(report2, direction) {
   DURATION_S,
   EASE,
   EASE_TUPLE,
+  EDGE_STEP,
   ESTATE_VERSION,
   EXIT_RATIO,
   FINGERPRINT_VERSION,
   HOUSE,
   HOUSE_BUDGET,
+  HOUSE_LOCKED,
   HOUSE_TYPE,
+  IMAGERY_TELLS,
   JSON_SCHEMA_VERSION,
+  LICENCES,
   LIGHTNESS_CURVE,
   MIN_DECIDED,
   MIN_RUNS,
@@ -5877,11 +6644,15 @@ function retrofitPlan(report2, direction) {
   NULL_VERSION,
   PILL_LIMIT,
   PLAINER_WORDS,
+  PROMO_BADGE,
   PROPOSED,
+  PROVENANCE_SCAN_BYTES,
   RAMP_STEPS,
+  READABLE_SNAPSHOT_VERSIONS,
   REFLEX_FONTS_1,
   REFLEX_FONTS_2,
   RENDERED_PATHS,
+  RENDERED_TELLS,
   REVEAL_LIMIT,
   REVIEW_PHRASES,
   SCALE,
@@ -5892,6 +6663,8 @@ function retrofitPlan(report2, direction) {
   SOURCE_KINDS,
   SPACE_STEPS,
   SPRING,
+  STOCK_AVATAR_HOSTS,
+  STOCK_PHOTO_HOSTS,
   STOCK_PHRASES,
   TELL_HEAVY,
   TYPE_STEPS,
@@ -5910,8 +6683,14 @@ function retrofitPlan(report2, direction) {
   checkPair,
   checkRestraint,
   choicesOf,
+  closestComponents,
   compareFacts,
   compareToEstate,
+  componentDistance,
+  componentShared,
+  componentTypicalities,
+  componentTypicality,
+  componentsOf,
   craftTokens,
   createBaseline,
   deltaEOk,
@@ -5920,9 +6699,11 @@ function retrofitPlan(report2, direction) {
   densityTokens,
   emitCss,
   emptyEstate,
+  estateComponentPairs,
   estatePairs,
   exitDuration,
   extractHtml,
+  faceLicence,
   findClaims,
   findColours,
   findingKey,
@@ -5940,6 +6721,7 @@ function retrofitPlan(report2, direction) {
   groundName,
   harvest,
   hexToOklch,
+  holdHouseBlocks,
   houseRule,
   hueName,
   hueSwatch,
@@ -5949,6 +6731,8 @@ function retrofitPlan(report2, direction) {
   initDirection,
   isAiViolet,
   isCream,
+  layoutDistance,
+  licencesJson,
   makeSnapshot,
   motionTokens,
   namedSources,
@@ -5966,8 +6750,10 @@ function retrofitPlan(report2, direction) {
   protectedFacts,
   ramp,
   rampFromAnchors,
+  readSnapshot,
   retrofitPlan,
   runTell,
+  scanProvenance,
   scanSource,
   sectionRhythm,
   semantic,
@@ -5976,6 +6762,8 @@ function retrofitPlan(report2, direction) {
   sharedParts,
   shouldAnimate,
   siblingLine,
+  stockAvatarSource,
+  stockSource,
   tailwindV3Preset,
   tailwindV4Theme,
   tellById,
@@ -5986,6 +6774,7 @@ function retrofitPlan(report2, direction) {
   typicality,
   validateDirection,
   visibleText,
+  visualMeasures,
   wcagContrast,
   wordListsJson
 });