@domandigital/craft 0.10.0 → 0.12.0

package/dist/index.cjs

@@ -23,10 +23,12 @@ __export(index_exports, {
   AI_PHRASES: () => AI_PHRASES,
   AI_VIOLET: () => AI_VIOLET,
   AI_WORDS: () => AI_WORDS,
+  BASELINE_VERSION: () => BASELINE_VERSION,
   BUZZWORDS: () => BUZZWORDS,
   CATALOGUE: () => CATALOGUE,
   CATALOGUE_VERSION: () => CATALOGUE_VERSION,
   CHOICE_KEYS: () => CHOICE_KEYS,
+  DEFAULT_IGNORE: () => DEFAULT_IGNORE,
   DENSITIES: () => DENSITIES,
   DENSITY_NAMES: () => DENSITY_NAMES,
   DIRECTION_VERSION: () => DIRECTION_VERSION,
@@ -35,12 +37,16 @@ __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,
+  JSON_SCHEMA_VERSION: () => JSON_SCHEMA_VERSION,
+  LICENCES: () => LICENCES,
   LIGHTNESS_CURVE: () => LIGHTNESS_CURVE,
   MIN_DECIDED: () => MIN_DECIDED,
   MIN_RUNS: () => MIN_RUNS,
@@ -50,6 +56,7 @@ __export(index_exports, {
   PLAINER_WORDS: () => PLAINER_WORDS,
   PROPOSED: () => PROPOSED,
   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,
@@ -71,7 +78,9 @@ __export(index_exports, {
   accentFork: () => accentFork,
   addSite: () => addSite,
   apcaContrast: () => apcaContrast,
+  applyBaseline: () => applyBaseline,
   applyHouseGate: () => applyHouseGate,
+  applySeverity: () => applySeverity,
   auditSnapshot: () => auditSnapshot,
   catalogueTable: () => catalogueTable,
   characterReport: () => characterReport,
@@ -82,6 +91,7 @@ __export(index_exports, {
   compareFacts: () => compareFacts,
   compareToEstate: () => compareToEstate,
   craftTokens: () => craftTokens,
+  createBaseline: () => createBaseline,
   deltaEOk: () => deltaEOk,
   deltaEOkHex: () => deltaEOkHex,
   densityCss: () => densityCss,
@@ -91,8 +101,10 @@ __export(index_exports, {
   estatePairs: () => estatePairs,
   exitDuration: () => exitDuration,
   extractHtml: () => extractHtml,
+  faceLicence: () => faceLicence,
   findClaims: () => findClaims,
   findColours: () => findColours,
+  findingKey: () => findingKey,
   fingerprint: () => fingerprint,
   fingerprintDistance: () => fingerprintDistance,
   fluidClamp: () => fluidClamp,
@@ -103,17 +115,22 @@ __export(index_exports, {
   formatComparison: () => formatComparison,
   formatHex: () => formatHex,
   formatReport: () => formatReport,
+  globToRegExp: () => globToRegExp,
   groundName: () => groundName,
   harvest: () => harvest,
   hexToOklch: () => hexToOklch,
+  holdHouseBlocks: () => holdHouseBlocks,
   houseRule: () => houseRule,
   hueName: () => hueName,
   hueSwatch: () => hueSwatch,
+  ignoreMatcher: () => ignoreMatcher,
   inP3Gamut: () => inP3Gamut,
   inSrgbGamut: () => inSrgbGamut,
   initDirection: () => initDirection,
   isAiViolet: () => isAiViolet,
   isCream: () => isCream,
+  layoutDistance: () => layoutDistance,
+  licencesJson: () => licencesJson,
   makeSnapshot: () => makeSnapshot,
   motionTokens: () => motionTokens,
   namedSources: () => namedSources,
@@ -123,17 +140,21 @@ __export(index_exports, {
   oklchToHex: () => oklchToHex,
   oklchToRgb: () => oklchToRgb,
   paletteFromPixels: () => paletteFromPixels,
+  parseBaseline: () => parseBaseline,
   parseColour: () => parseColour,
+  parseCraftConfig: () => parseCraftConfig,
   parseHex: () => parseHex,
   propose: () => propose,
   protectedFacts: () => protectedFacts,
   ramp: () => ramp,
   rampFromAnchors: () => rampFromAnchors,
+  readSnapshot: () => readSnapshot,
   retrofitPlan: () => retrofitPlan,
   runTell: () => runTell,
   scanSource: () => scanSource,
   sectionRhythm: () => sectionRhythm,
   semantic: () => semantic,
+  severityExceptions: () => severityExceptions,
   shapeName: () => shapeName,
   sharedParts: () => sharedParts,
   shouldAnimate: () => shouldAnimate,
@@ -142,10 +163,13 @@ __export(index_exports, {
   tailwindV4Theme: () => tailwindV4Theme,
   tellById: () => tellById,
   toGamut: () => toGamut,
+  toJson: () => toJson,
+  toSarif: () => toSarif,
   typeFeatureTokens: () => typeFeatureTokens,
   typicality: () => typicality,
   validateDirection: () => validateDirection,
   visibleText: () => visibleText,
+  visualMeasures: () => visualMeasures,
   wcagContrast: () => wcagContrast,
   wordListsJson: () => wordListsJson
 });
@@ -2895,6 +2919,7 @@ var REFLEX_FONTS_2 = [
   "Plus Jakarta Sans",
   "Outfit",
   "Geist",
+  "Cal Sans",
   "Sora",
   "Instrument Sans",
   "Instrument Serif",
@@ -3116,7 +3141,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) {
@@ -3263,6 +3288,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;
@@ -3480,6 +3511,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",
@@ -3706,6 +3754,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;
@@ -4039,7 +4098,7 @@ function extractStrings(file) {
 }
 
 // src/snapshot/types.ts
-var SNAPSHOT_VERSION = 1;
+var SNAPSHOT_VERSION = 2;
 
 // src/snapshot/fixture.ts
 function makeSnapshot(patch = {}) {
@@ -4373,7 +4432,7 @@ var RENDERED_PATHS = {
 };
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.09.8";
+var CATALOGUE_VERSION = "2026.09.9";
 var CATALOGUE = [...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map(
   (t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t
 );
@@ -4752,8 +4811,267 @@ function formatClaims(report2, label = "craft copy claims") {
   return lines.join("\n");
 }
 
+// src/character/baseline.ts
+var BASELINE_VERSION = 1;
+function fnv1a(text) {
+  let hash = 2166136261;
+  for (let i = 0; i < text.length; i += 1) {
+    hash ^= text.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+var excerptHash = (f4) => fnv1a(f4.excerpt.replace(/\s+/g, " ").trim());
+var keyOf = (tell, path, excerpt) => `${tell}\0${path}\0${excerpt}`;
+function findingKey(f4) {
+  return keyOf(f4.tell, f4.path, excerptHash(f4));
+}
+function createBaseline(report2) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const f4 of report2.findings) {
+    const excerpt = excerptHash(f4);
+    const key = keyOf(f4.tell, f4.path, excerpt);
+    const entry = counts.get(key);
+    if (entry) entry.count += 1;
+    else counts.set(key, { tell: f4.tell, path: f4.path, excerpt, count: 1 });
+  }
+  const entries = [...counts.values()].sort((a, b) => a.path.localeCompare(b.path) || a.tell.localeCompare(b.tell) || a.excerpt.localeCompare(b.excerpt));
+  return { version: BASELINE_VERSION, catalogueVersion: report2.catalogueVersion, entries };
+}
+function parseBaseline(data, source = "baseline") {
+  const b = data;
+  if (!b || typeof b !== "object" || b.version !== BASELINE_VERSION || !Array.isArray(b.entries)) {
+    throw new Error(`${source}: not a craft baseline (version ${BASELINE_VERSION})`);
+  }
+  for (const e of b.entries) {
+    if (typeof e?.tell !== "string" || typeof e.path !== "string" || typeof e.excerpt !== "string" || !Number.isInteger(e.count) || e.count < 1) {
+      throw new Error(`${source}: malformed entry ${JSON.stringify(e)}`);
+    }
+  }
+  return b;
+}
+function recount(report2, findings) {
+  const byGeneration = { 1: 0, 2: 0, 3: 0 };
+  const byTell = {};
+  for (const f4 of findings) {
+    byGeneration[f4.generation] += 1;
+    byTell[f4.tell] = (byTell[f4.tell] ?? 0) + 1;
+  }
+  return {
+    ...report2,
+    findings,
+    summary: { ...report2.summary, findings: findings.length, byGeneration, byTell, blocking: findings.filter((f4) => f4.severity === "block").length }
+  };
+}
+function applyBaseline(report2, baseline) {
+  const remaining = /* @__PURE__ */ new Map();
+  for (const e of baseline.entries) {
+    const key = keyOf(e.tell, e.path, e.excerpt);
+    remaining.set(key, (remaining.get(key) ?? 0) + e.count);
+  }
+  const kept = [];
+  let baselined = 0;
+  for (const f4 of report2.findings) {
+    const key = findingKey(f4);
+    const left = remaining.get(key) ?? 0;
+    if (left > 0) {
+      remaining.set(key, left - 1);
+      baselined += 1;
+    } else kept.push(f4);
+  }
+  return { ...recount(report2, kept), baselined };
+}
+
+// src/character/config.ts
+var DEFAULT_IGNORE = [".claude", ".agents", ".cursor"];
+var KEYS = /* @__PURE__ */ new Set(["$schema", "ignore", "copyPaths", "severity"]);
+var LEVELS = /* @__PURE__ */ new Set(["warn", "block", "off"]);
+var MIN_BECAUSE = 12;
+var isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isStringArray = (v) => Array.isArray(v) && v.every((s) => typeof s === "string");
+function parseCraftConfig(data, knownTells, source = "craft.config.json") {
+  if (!isRecord(data)) throw new Error(`${source}: expected an object`);
+  for (const key of Object.keys(data)) if (!KEYS.has(key)) throw new Error(`${source}: unknown key "${key}"`);
+  const ignore = data.ignore ?? [];
+  if (!isStringArray(ignore)) throw new Error(`${source}: "ignore" must be an array of glob strings`);
+  if (data.copyPaths !== void 0 && !isStringArray(data.copyPaths)) throw new Error(`${source}: "copyPaths" must be an array of paths`);
+  const severity = {};
+  const raw = data.severity ?? {};
+  if (!isRecord(raw)) throw new Error(`${source}: "severity" must map a tell id to { level, because }`);
+  for (const [tell, value] of Object.entries(raw)) {
+    if (!knownTells.has(tell)) throw new Error(`${source}: severity names no tell called "${tell}"`);
+    if (!isRecord(value) || !LEVELS.has(value.level)) {
+      throw new Error(`${source}: severity.${tell} needs a level of "warn", "block" or "off"`);
+    }
+    if (typeof value.because !== "string" || value.because.trim().length < MIN_BECAUSE) {
+      throw new Error(`${source}: severity.${tell} needs a because of at least a sentence`);
+    }
+    severity[tell] = { level: value.level, because: value.because };
+  }
+  return { ignore, severity, ...data.copyPaths ? { copyPaths: data.copyPaths } : {} };
+}
+function globToRegExp(glob) {
+  const pattern = glob.replace(/^\.\//, "").replace(/\/$/, "").replace(/\/\*\*$/, "");
+  let body = "";
+  for (let i = 0; i < pattern.length; i += 1) {
+    const c = pattern[i];
+    if (c === "*" && pattern[i + 1] === "*") {
+      const slash = pattern[i + 2] === "/";
+      body += slash ? "(?:.*/)?" : ".*";
+      i += slash ? 2 : 1;
+    } else if (c === "*") body += "[^/]*";
+    else if (c === "?") body += "[^/]";
+    else body += c.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+  }
+  const anywhere = !pattern.includes("/");
+  return new RegExp(`^${anywhere ? "(?:.*/)?" : ""}${body}(?:/.*)?$`);
+}
+function ignoreMatcher(patterns) {
+  const res = patterns.map(globToRegExp);
+  return (path) => {
+    const p = path.replace(/\\/g, "/").replace(/^\.\//, "");
+    return res.some((re) => re.test(p));
+  };
+}
+function severityExceptions(config) {
+  return Object.entries(config.severity).filter(([, o]) => o.level === "off").map(([tell, o]) => ({ tell, because: `craft.config.json: ${o.because}` }));
+}
+function applySeverity(report2, config) {
+  const findings = report2.findings.map((f4) => {
+    const o = config.severity[f4.tell];
+    return o && o.level !== "off" ? { ...f4, severity: o.level } : f4;
+  });
+  return { ...report2, findings, summary: { ...report2.summary, blocking: findings.filter((f4) => f4.severity === "block").length } };
+}
+
+// src/character/sarif.ts
+var isUrl = (path) => /^[a-z][a-z0-9+.-]*:\/\//i.test(path);
+function toSarif(report2, options) {
+  const byId = new Map(options.tells.map((t) => [t.id, t]));
+  const ids = [...new Set(report2.findings.map((f4) => f4.tell))].sort();
+  const index = new Map(ids.map((id, i) => [id, i]));
+  const rules = ids.map((id) => {
+    const t = byId.get(id);
+    return {
+      id,
+      name: t?.name ?? id,
+      shortDescription: { text: t?.name ?? id },
+      ...t ? { fullDescription: { text: t.why }, help: { text: t.fix } } : {}
+    };
+  });
+  const results = report2.findings.map((f4) => ({
+    ruleId: f4.tell,
+    ruleIndex: index.get(f4.tell),
+    level: f4.severity === "block" ? "error" : "warning",
+    message: { text: `${f4.message}. ${f4.fix}` },
+    locations: [
+      {
+        physicalLocation: {
+          artifactLocation: { uri: isUrl(f4.path) ? f4.path : f4.path.replace(/\\/g, "/") },
+          ...f4.line > 0 ? { region: { startLine: f4.line, snippet: { text: f4.excerpt } } } : {}
+        }
+      }
+    ],
+    partialFingerprints: { "craftFinding/v1": fnv1a(findingKey(f4)) }
+  }));
+  return {
+    $schema: "https://json.schemastore.org/sarif-2.1.0.json",
+    version: "2.1.0",
+    runs: [
+      {
+        tool: {
+          driver: {
+            name: "craft",
+            version: report2.catalogueVersion,
+            informationUri: options.informationUri ?? "https://www.npmjs.com/package/@domandigital/craft",
+            rules
+          }
+        },
+        results
+      }
+    ]
+  };
+}
+
+// src/character/json.ts
+var JSON_SCHEMA_VERSION = 1;
+function toJson(data) {
+  return JSON.stringify({ schemaVersion: JSON_SCHEMA_VERSION, ...data }, null, 2);
+}
+
+// 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;
+}
+
+// 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;
+      }
+    }
+  }
+  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/fingerprint/index.ts
-var FINGERPRINT_VERSION = 1;
+var FINGERPRINT_VERSION = 2;
 var CHROMATIC = 0.03;
 var MIN_ACCENT_AREA = 2e4;
 var oklch = (value) => {
@@ -4808,23 +5126,36 @@ function fingerprint(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)
+    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 })) } : {}
   };
 }
 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) {
+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 + (a[i - 1] === b[j - 1] ? 0 : 1));
+      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 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 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;
+}
 var clamp = (n) => Math.max(0, Math.min(1, n));
 function faceDistance(a, b) {
   if (a.family.toLowerCase() === b.family.toLowerCase()) return 0;
@@ -4839,8 +5170,7 @@ function fingerprintDistance(a, b) {
   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 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 };
@@ -4868,6 +5198,117 @@ 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;
@@ -4991,6 +5432,18 @@ 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)) {
@@ -5647,10 +6100,12 @@ function retrofitPlan(report2, direction) {
   AI_PHRASES,
   AI_VIOLET,
   AI_WORDS,
+  BASELINE_VERSION,
   BUZZWORDS,
   CATALOGUE,
   CATALOGUE_VERSION,
   CHOICE_KEYS,
+  DEFAULT_IGNORE,
   DENSITIES,
   DENSITY_NAMES,
   DIRECTION_VERSION,
@@ -5659,12 +6114,16 @@ function retrofitPlan(report2, direction) {
   DURATION_S,
   EASE,
   EASE_TUPLE,
+  EDGE_STEP,
   ESTATE_VERSION,
   EXIT_RATIO,
   FINGERPRINT_VERSION,
   HOUSE,
   HOUSE_BUDGET,
+  HOUSE_LOCKED,
   HOUSE_TYPE,
+  JSON_SCHEMA_VERSION,
+  LICENCES,
   LIGHTNESS_CURVE,
   MIN_DECIDED,
   MIN_RUNS,
@@ -5674,6 +6133,7 @@ function retrofitPlan(report2, direction) {
   PLAINER_WORDS,
   PROPOSED,
   RAMP_STEPS,
+  READABLE_SNAPSHOT_VERSIONS,
   REFLEX_FONTS_1,
   REFLEX_FONTS_2,
   RENDERED_PATHS,
@@ -5695,7 +6155,9 @@ function retrofitPlan(report2, direction) {
   accentFork,
   addSite,
   apcaContrast,
+  applyBaseline,
   applyHouseGate,
+  applySeverity,
   auditSnapshot,
   catalogueTable,
   characterReport,
@@ -5706,6 +6168,7 @@ function retrofitPlan(report2, direction) {
   compareFacts,
   compareToEstate,
   craftTokens,
+  createBaseline,
   deltaEOk,
   deltaEOkHex,
   densityCss,
@@ -5715,8 +6178,10 @@ function retrofitPlan(report2, direction) {
   estatePairs,
   exitDuration,
   extractHtml,
+  faceLicence,
   findClaims,
   findColours,
+  findingKey,
   fingerprint,
   fingerprintDistance,
   fluidClamp,
@@ -5727,17 +6192,22 @@ function retrofitPlan(report2, direction) {
   formatComparison,
   formatHex,
   formatReport,
+  globToRegExp,
   groundName,
   harvest,
   hexToOklch,
+  holdHouseBlocks,
   houseRule,
   hueName,
   hueSwatch,
+  ignoreMatcher,
   inP3Gamut,
   inSrgbGamut,
   initDirection,
   isAiViolet,
   isCream,
+  layoutDistance,
+  licencesJson,
   makeSnapshot,
   motionTokens,
   namedSources,
@@ -5747,17 +6217,21 @@ function retrofitPlan(report2, direction) {
   oklchToHex,
   oklchToRgb,
   paletteFromPixels,
+  parseBaseline,
   parseColour,
+  parseCraftConfig,
   parseHex,
   propose,
   protectedFacts,
   ramp,
   rampFromAnchors,
+  readSnapshot,
   retrofitPlan,
   runTell,
   scanSource,
   sectionRhythm,
   semantic,
+  severityExceptions,
   shapeName,
   sharedParts,
   shouldAnimate,
@@ -5766,10 +6240,13 @@ function retrofitPlan(report2, direction) {
   tailwindV4Theme,
   tellById,
   toGamut,
+  toJson,
+  toSarif,
   typeFeatureTokens,
   typicality,
   validateDirection,
   visibleText,
+  visualMeasures,
   wcagContrast,
   wordListsJson
 });