@domandigital/craft 0.11.0 → 0.12.0

package/dist/index.cjs

@@ -37,13 +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,
@@ -53,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,
@@ -97,6 +101,7 @@ __export(index_exports, {
   estatePairs: () => estatePairs,
   exitDuration: () => exitDuration,
   extractHtml: () => extractHtml,
+  faceLicence: () => faceLicence,
   findClaims: () => findClaims,
   findColours: () => findColours,
   findingKey: () => findingKey,
@@ -114,6 +119,7 @@ __export(index_exports, {
   groundName: () => groundName,
   harvest: () => harvest,
   hexToOklch: () => hexToOklch,
+  holdHouseBlocks: () => holdHouseBlocks,
   houseRule: () => houseRule,
   hueName: () => hueName,
   hueSwatch: () => hueSwatch,
@@ -123,6 +129,8 @@ __export(index_exports, {
   initDirection: () => initDirection,
   isAiViolet: () => isAiViolet,
   isCream: () => isCream,
+  layoutDistance: () => layoutDistance,
+  licencesJson: () => licencesJson,
   makeSnapshot: () => makeSnapshot,
   motionTokens: () => motionTokens,
   namedSources: () => namedSources,
@@ -140,6 +148,7 @@ __export(index_exports, {
   protectedFacts: () => protectedFacts,
   ramp: () => ramp,
   rampFromAnchors: () => rampFromAnchors,
+  readSnapshot: () => readSnapshot,
   retrofitPlan: () => retrofitPlan,
   runTell: () => runTell,
   scanSource: () => scanSource,
@@ -160,6 +169,7 @@ __export(index_exports, {
   typicality: () => typicality,
   validateDirection: () => validateDirection,
   visibleText: () => visibleText,
+  visualMeasures: () => visualMeasures,
   wcagContrast: () => wcagContrast,
   wordListsJson: () => wordListsJson
 });
@@ -2909,6 +2919,7 @@ var REFLEX_FONTS_2 = [
   "Plus Jakarta Sans",
   "Outfit",
   "Geist",
+  "Cal Sans",
   "Sora",
   "Instrument Sans",
   "Instrument Serif",
@@ -3130,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) {
@@ -3277,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;
@@ -3494,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",
@@ -3720,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;
@@ -4053,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 = {}) {
@@ -4387,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
 );
@@ -4954,8 +4999,79 @@ 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) => {
@@ -5010,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;
@@ -5041,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 };
@@ -5070,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;
@@ -5193,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)) {
@@ -5863,13 +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,
@@ -5879,6 +6133,7 @@ function retrofitPlan(report2, direction) {
   PLAINER_WORDS,
   PROPOSED,
   RAMP_STEPS,
+  READABLE_SNAPSHOT_VERSIONS,
   REFLEX_FONTS_1,
   REFLEX_FONTS_2,
   RENDERED_PATHS,
@@ -5923,6 +6178,7 @@ function retrofitPlan(report2, direction) {
   estatePairs,
   exitDuration,
   extractHtml,
+  faceLicence,
   findClaims,
   findColours,
   findingKey,
@@ -5940,6 +6196,7 @@ function retrofitPlan(report2, direction) {
   groundName,
   harvest,
   hexToOklch,
+  holdHouseBlocks,
   houseRule,
   hueName,
   hueSwatch,
@@ -5949,6 +6206,8 @@ function retrofitPlan(report2, direction) {
   initDirection,
   isAiViolet,
   isCream,
+  layoutDistance,
+  licencesJson,
   makeSnapshot,
   motionTokens,
   namedSources,
@@ -5966,6 +6225,7 @@ function retrofitPlan(report2, direction) {
   protectedFacts,
   ramp,
   rampFromAnchors,
+  readSnapshot,
   retrofitPlan,
   runTell,
   scanSource,
@@ -5986,6 +6246,7 @@ function retrofitPlan(report2, direction) {
   typicality,
   validateDirection,
   visibleText,
+  visualMeasures,
   wcagContrast,
   wordListsJson
 });