@domandigital/craft 0.18.2 → 0.19.1

package/dist/index.js

@@ -4042,8 +4042,100 @@ function markupParts(file) {
 function textNodeIsProse(body) {
   return /[a-zA-Z]{2,}/.test(body) && /\s/.test(body.trim()) || /[a-zA-Z]{4,}[.!?]/.test(body);
 }
+var FRONT_MATTER_PROSE = /* @__PURE__ */ new Set(["title", "description"]);
+var KEY_LINE = /^(\s*)(?:-\s+)?([A-Za-z][\w-]*)[ \t]*:[ \t]*/;
+var BLOCK_SCALAR = /^(?:[|>][+-]?\d*|[|>]\d+[+-]?)$/;
+function readFrontKey(line) {
+  const m = KEY_LINE.exec(line);
+  if (!m) return null;
+  return { indent: m[1].length, name: m[2], valueAt: m[0].length, value: line.slice(m[0].length) };
+}
+function indentOf(line) {
+  let i = 0;
+  while (i < line.length && (line[i] === " " || line[i] === "	")) i += 1;
+  return i;
+}
+function commentAt(value) {
+  if (value.startsWith("#")) return 0;
+  const found = /[ \t]+#/.exec(value);
+  return found ? found.index : -1;
+}
+function keepSpan(line, from, to) {
+  const start = Math.max(0, Math.min(from, line.length));
+  const end = Math.max(start, Math.min(to, line.length));
+  return " ".repeat(start) + line.slice(start, end) + " ".repeat(line.length - end);
+}
+function quoteEnd(line, from, quote) {
+  for (let i = from; i < line.length; i += 1) {
+    if (quote === '"' && line[i] === "\\") {
+      i += 1;
+      continue;
+    }
+    if (quote === "'" && line[i] === "'" && line[i + 1] === "'") {
+      i += 1;
+      continue;
+    }
+    if (line[i] === quote) return i;
+  }
+  return -1;
+}
+function maskFrontMatter(block) {
+  const lines = block.split("\n");
+  const out = lines.map((line) => blank(line));
+  for (let i = 1; i < lines.length; ) {
+    const line = lines[i];
+    if (line === "---" || line === "...") break;
+    const key = readFrontKey(line);
+    if (!key || !FRONT_MATTER_PROSE.has(key.name.toLowerCase())) {
+      i += 1;
+      continue;
+    }
+    const quote = key.value.startsWith('"') ? '"' : key.value.startsWith("'") ? "'" : "";
+    if (quote) {
+      let cursor = key.valueAt + 1;
+      while (i < lines.length && lines[i] !== "---" && lines[i] !== "...") {
+        const current = lines[i];
+        const end = quoteEnd(current, cursor, quote);
+        out[i] = keepSpan(current, cursor, end === -1 ? current.length : end);
+        i += 1;
+        cursor = 0;
+        if (end !== -1) break;
+      }
+      continue;
+    }
+    const hash = commentAt(key.value);
+    const body = (hash === -1 ? key.value : key.value.slice(0, hash)).trim();
+    if (BLOCK_SCALAR.test(body)) {
+      i += 1;
+      while (i < lines.length && lines[i] !== "---" && lines[i] !== "...") {
+        const current = lines[i];
+        if (current.trim() !== "" && indentOf(current) <= key.indent) break;
+        if (current.trim()) out[i] = current;
+        i += 1;
+      }
+      continue;
+    }
+    if (body === "" || body === "~" || /^null$/i.test(body) || body.startsWith("[") || body.startsWith("{")) {
+      i += 1;
+      continue;
+    }
+    out[i] = keepSpan(line, key.valueAt, hash === -1 ? line.length : key.valueAt + hash);
+    i += 1;
+    while (i < lines.length && lines[i] !== "---" && lines[i] !== "...") {
+      const current = lines[i];
+      if (current.trim() === "" || indentOf(current) <= key.indent) break;
+      if (!/^\s*#/.test(current)) {
+        const cut = commentAt(current);
+        out[i] = cut === -1 ? current : keepSpan(current, 0, cut);
+      }
+      i += 1;
+    }
+  }
+  const masked = out.join("\n");
+  return masked.length === block.length ? masked : blank(block);
+}
 function proseBlocks(file) {
-  const masked = file.text.replace(/^(```|~~~)[\s\S]*?^\1/gm, blank).replace(/`[^`\n]*`/g, (m) => " ".repeat(m.length)).replace(/^---\n[\s\S]*?\n---\n/, blank).replace(/<!--[\s\S]*?-->/g, blank);
+  const masked = file.text.replace(/^(```|~~~)[\s\S]*?^\1/gm, blank).replace(/`[^`\n]*`/g, (m) => " ".repeat(m.length)).replace(/^---\n[\s\S]*?\n---\n/, (block) => maskFrontMatter(block)).replace(/<!--[\s\S]*?-->/g, blank);
   return [{ path: file.path, text: masked, offset: 0 }];
 }
 function isData(path) {
@@ -5031,7 +5123,7 @@ var RENDERED_PATHS = {
 };
 
 // src/fingerprint/index.ts
-var FINGERPRINT_VERSION = 2;
+var FINGERPRINT_VERSION = 3;
 var CHROMATIC = 0.03;
 var MIN_ACCENT_AREA = 2e4;
 var oklch = (value) => {
@@ -5067,6 +5159,24 @@ function median(values) {
   const mid = Math.floor(sorted.length / 2);
   return sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
 }
+var FULL_WIDTH_IMAGE = 0.8;
+function heroOf(s) {
+  const h1 = s.headings.find((h) => h.level === 1);
+  const inside = (top, x) => top >= x.top && top < x.top + x.height;
+  const index = (() => {
+    const withH1 = h1 ? s.sections.findIndex((x) => x.kind === "hero" && inside(h1.top, x)) : -1;
+    return withH1 >= 0 ? withH1 : s.sections.findIndex((x) => x.kind === "hero");
+  })();
+  if (index < 0) return void 0;
+  const section = s.sections[index];
+  const headline = h1 && inside(h1.top, section) ? { sizePx: h1.sizePx, weight: h1.weight, class: fontClass(normaliseFamily(h1.family)), italic: h1.italic || h1.italicPart } : null;
+  if (!s.images) return { headline };
+  const picture2 = s.images.filter((i) => (i.role === "photo" || i.role === "illustration") && (i.section === index || i.section === null && inside(i.top, section))).sort((a, b) => b.width * b.height - a.width * a.height)[0];
+  if (!picture2) return { headline, image: "none" };
+  if (picture2.left === void 0) return { headline };
+  const image = picture2.width >= FULL_WIDTH_IMAGE * s.viewport.width ? "full" : picture2.left + picture2.width / 2 < s.viewport.width / 2 ? "left" : "right";
+  return { headline, image };
+}
 function fingerprint(s) {
   const effects = [];
   if (s.effects.glass > 0) effects.push("glass-panel");
@@ -5078,6 +5188,7 @@ function fingerprint(s) {
   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;
+  const hero = heroOf(s);
   return {
     version: FINGERPRINT_VERSION,
     accent: accentOf(s),
@@ -5101,10 +5212,28 @@ function fingerprint(s) {
         carousel: x.carousel ?? false,
         figures: x.figures ?? 0
       }))
-    } : {}
+    } : {},
+    ...hero ? { hero } : {}
   };
 }
-var DISTANCE_WEIGHTS = { accent: 0.25, type: 0.25, ground: 0.1, shape: 0.1, motion: 0.1, effects: 0.1, layout: 0.1 };
+var WARM_HUE = [
+  [330, 360],
+  [0, 130]
+];
+var COOL_HUE = [[160, 310]];
+var TEMPERATURE_FULL = 6e-3;
+var TEMPERATURE_NAMED = 0.4;
+function groundTemperature(o) {
+  const h = (o.h % 360 + 360) % 360;
+  const within = (bands) => bands.some(([lo, hi]) => h >= lo && h < hi);
+  const strength = Math.min(1, o.c / TEMPERATURE_FULL);
+  return within(WARM_HUE) ? strength : within(COOL_HUE) ? -strength : 0;
+}
+function temperatureName(o) {
+  const t = groundTemperature(o);
+  return t >= TEMPERATURE_NAMED ? "warm" : t <= -TEMPERATURE_NAMED ? "cool" : "neutral";
+}
+var DISTANCE_WEIGHTS = { accent: 0.2, type: 0.2, ground: 0.1, shape: 0.1, motion: 0.05, effects: 0.1, layout: 0.1, rhythm: 0.1, hero: 0.05 };
 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) {
@@ -5131,18 +5260,62 @@ function layoutDistance(a, b) {
   return longest === 0 ? 0 : levenshtein(a.layout, b.layout) / longest;
 }
 var clamp = (n) => Math.max(0, Math.min(1, n));
+function bandOf(l) {
+  return l < 0.4 ? "dark" : l >= 0.75 ? "light" : "mid";
+}
+function rhythmOf(fp) {
+  if (!fp.sections) return null;
+  const out = [];
+  for (const s of fp.sections) {
+    if (s.background === void 0) return null;
+    const band = bandOf((s.background ?? fp.ground).l);
+    if (out[out.length - 1] !== band) out.push(band);
+  }
+  return out;
+}
+var OPENING_BANDS = 3;
+function rhythmDistance(a, b) {
+  const ra = rhythmOf(a);
+  const rb = rhythmOf(b);
+  if (!ra || !rb) return null;
+  const over = (x, y) => {
+    const longest = Math.max(x.length, y.length);
+    return longest === 0 ? 0 : levenshtein(x, y) / longest;
+  };
+  return (over(ra.slice(0, OPENING_BANDS), rb.slice(0, OPENING_BANDS)) + over(ra, rb)) / 2;
+}
+var HEADLINE_OCTAVES = 1;
+function heroSection(fp) {
+  return fp.sections?.find((s) => s.role === "hero");
+}
+function heroDistance(a, b) {
+  const sa = heroSection(a);
+  const sb = heroSection(b);
+  if (!sa || !sb) return null;
+  const parts2 = [Math.abs(sa.centred - sb.centred), clamp(Math.abs(sa.width - sb.width) / 0.5)];
+  const ha = a.hero?.headline;
+  const hb = b.hero?.headline;
+  if (ha && hb) parts2.push(0.5 * (ha.class === hb.class ? 0 : 1) + 0.5 * clamp(Math.abs(Math.log2(ha.sizePx / hb.sizePx)) / HEADLINE_OCTAVES));
+  else if (a.hero && b.hero && (ha || hb)) parts2.push(1);
+  if (a.hero?.image && b.hero?.image) parts2.push(a.hero.image === b.hero.image ? 0 : 1);
+  return parts2.reduce((s, p) => s + p, 0) / parts2.length;
+}
 function faceDistance(a, b) {
   if (a.family.toLowerCase() === b.family.toLowerCase()) return 0;
   return a.class === b.class ? 0.5 : 1;
 }
 var ACCENT_SCALE = 0.3;
 var GROUND_SCALE = 0.15;
+var TEMPERATURE_WEIGHT = 0.6;
 var SHARED_PART = 0.2;
 var ACCENT_SHARED = ACCENT_SCALE * SHARED_PART;
 var GROUND_SHARED = GROUND_SCALE * SHARED_PART;
+function groundDistance(a, b) {
+  return clamp(deltaEOk(a, b) / GROUND_SCALE + TEMPERATURE_WEIGHT * Math.abs(groundTemperature(a) - groundTemperature(b)) / 2);
+}
 function fingerprintDistance(a, b) {
   const accent = a.accent && b.accent ? clamp(deltaEOk(a.accent, b.accent) / ACCENT_SCALE) : a.accent || b.accent ? 1 : 0;
-  const ground = clamp(deltaEOk(a.ground, b.ground) / GROUND_SCALE);
+  const ground = groundDistance(a.ground, b.ground);
   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));
@@ -5150,9 +5323,18 @@ function fingerprintDistance(a, b) {
   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 };
+  const rhythm = rhythmDistance(a, b);
+  const hero = heroDistance(a, b);
+  const parts2 = { accent, ground, type, shape, motion, effects, layout, rhythm, hero };
+  let sum = 0;
+  let weight = 0;
+  for (const k of Object.keys(DISTANCE_WEIGHTS)) {
+    const p = parts2[k];
+    if (p === null) continue;
+    sum += DISTANCE_WEIGHTS[k] * p;
+    weight += DISTANCE_WEIGHTS[k];
+  }
+  return { total: Math.round(sum / weight * 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);
@@ -5230,6 +5412,12 @@ function groundName(o) {
   if (o.l >= 0.97 && o.c < 0.012) return "white";
   return o.c < 0.02 ? "grey" : "tinted";
 }
+function groundLabel(o) {
+  const name = groundName(o);
+  if (name === "cream" || name === "tinted") return name;
+  const temperature = temperatureName(o);
+  return temperature === "neutral" ? name : `${temperature} ${name}`;
+}
 function shapeName(roundness) {
   if (roundness === null) return "no buttons";
   if (roundness >= 0.45) return "pill";
@@ -8504,6 +8692,33 @@ var LICENCES = [
     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."
+  },
+  {
+    name: "Saira Semi Condensed",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-10-09",
+    source: "https://github.com/google/fonts/blob/main/ofl/sairasemicondensed/OFL.txt",
+    note: "Copyright 2016 The Saira Project Authors (omnibus.type@gmail.com), reserved font name Saira. Keep the OFL notice with the font files; a modified build may not be called Saira. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
+  },
+  {
+    name: "Public Sans",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-10-09",
+    source: "https://github.com/google/fonts/blob/main/ofl/publicsans/OFL.txt",
+    note: "Copyright 2015 The Public Sans Project Authors (https://github.com/uswds/public-sans). Keep the OFL notice with the font files. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
+  },
+  {
+    name: "Martian Mono",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-10-09",
+    source: "https://github.com/google/fonts/blob/main/ofl/martianmono/OFL.txt",
+    note: "Copyright 2021 The Martian Mono Project Authors (https://github.com/evilmartians/mono). Keep the OFL notice with the font files. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
   }
 ];
 function faceLicence(family) {
@@ -8870,7 +9085,7 @@ var PART_AREA = {
   effects: { area: "effects", choice: "motif" },
   motion: { area: "motion", choice: "signature" }
 };
-var DEFAULTS = /^(?:ground )?(?:white|grey)(?: ground)?$|no scroll reveals|no reveals|accent (?:none|neutral)|^no buttons|shape no buttons/;
+var DEFAULTS = /^(?:ground )?(?:white|grey|light)(?: ground)?$|no scroll reveals|no reveals|accent (?:none|neutral)|^no buttons|shape no buttons|^light page throughout$/;
 function designFindings(findings, copyTells) {
   return (findings?.findings ?? []).filter((f4) => !copyTells.has(f4.tell));
 }
@@ -8977,7 +9192,7 @@ function areaOfShared(part) {
   if (/accent|ground/.test(part)) return "colour";
   if (/buttons/.test(part)) return "shape";
   if (/reveal/.test(part)) return "motion";
-  if (/running order/.test(part)) return "layout";
+  if (/running order|hero|page throughout/.test(part)) return "layout";
   return "effects";
 }
 function choiceOfShared(part) {
@@ -8987,7 +9202,7 @@ function choiceOfShared(part) {
   if (/ground/.test(part)) return "ground";
   if (/buttons/.test(part)) return "shape";
   if (/reveal/.test(part)) return "signature";
-  return /running order/.test(part) ? void 0 : "motif";
+  return /running order|hero|page throughout/.test(part) ? void 0 : "motif";
 }
 
 // src/calibrate/index.ts
@@ -9094,19 +9309,45 @@ function addSite(register, site) {
   const sites = [...register.sites.filter((s) => s.id !== site.id), site].sort((a, b) => a.id.localeCompare(b.id));
   return { version: ESTATE_VERSION, sites };
 }
+function sharedGround(a, b) {
+  const [x, y] = [groundLabel(a.ground), groundLabel(b.ground)];
+  if (x === y) return `${x} ground`;
+  const temperature = temperatureName(a.ground);
+  if (temperature !== "neutral" && temperature === temperatureName(b.ground)) return `${temperature} ground`;
+  return `${a.ground.l < 0.3 ? "dark" : "light"} ground`;
+}
+function sharedRhythm(a, b) {
+  const bands = rhythmOf(a) ?? [];
+  const word = (band) => band;
+  if (bands.length <= 1) return `${bands[0] ? word(bands[0]) : "light"} page throughout`;
+  const second = bands[1] === "mid" ? "mid-tone band" : `${word(bands[1])} band`;
+  return `${word(bands[0])} hero then ${second}`;
+}
+function sharedHero(a, b) {
+  const hero = a.sections?.find((s) => s.role === "hero");
+  const placement = hero && hero.centred >= 0.5 ? "centred" : "left-aligned";
+  const headline = a.hero?.headline && b.hero?.headline && a.hero.headline.class === b.hero.headline.class ? `${a.hero.headline.class} ` : "";
+  const image = a.hero?.image && a.hero.image === b.hero?.image && a.hero.image !== "none" ? `, ${a.hero.image === "full" ? "full-width picture" : `photo ${a.hero.image}`}` : "";
+  return `${placement} ${headline}hero${image}`;
+}
 function sharedParts(a, b, d = fingerprintDistance(a, b)) {
   const out = [];
-  const close = (k) => d.parts[k] <= SHARED_PART;
+  const close = (k) => {
+    const p = d.parts[k];
+    return p !== null && p <= SHARED_PART;
+  };
   if (close("accent")) out.push(a.accent || b.accent ? `${hueName(a.accent)} accent` : "no accent");
   if (close("type")) {
     if (a.display.family === b.display.family) out.push(`${a.display.family} headline`);
     if (a.body.family === b.body.family) out.push(`${a.body.family} body`);
   }
-  if (close("ground")) out.push(`${groundName(a.ground)} ground`);
+  if (close("ground")) out.push(sharedGround(a, b));
   if (close("shape")) out.push(`${shapeName(a.roundness)} buttons`);
   if (close("motion")) out.push(a.motion > 0 || b.motion > 0 ? "scroll reveals" : "no reveals");
   if (close("effects") && a.effects.length) out.push(a.effects.filter((e) => b.effects.includes(e)).join(", "));
-  if (close("layout")) out.push("running order");
+  if (close("hero")) out.push(sharedHero(a, b));
+  if (close("rhythm")) out.push(sharedRhythm(a, b));
+  if (close("layout")) out.push("same running order");
   return out;
 }
 function compareToEstate(target2, register, options = {}) {
@@ -9245,6 +9486,7 @@ export {
   MOOD,
   NEGATIVE_REASSURANCE,
   NULL_VERSION,
+  OPENING_BANDS,
   PAGE_TYPES,
   PILL_LIMIT,
   PLAINER_WORDS,
@@ -9288,6 +9530,9 @@ export {
   STOCK_PHRASES,
   STUDY_WORDS,
   TELL_HEAVY,
+  TEMPERATURE_FULL,
+  TEMPERATURE_NAMED,
+  TEMPERATURE_WEIGHT,
   TRADE_NOUNS,
   TYPE_STEPS,
   TYPICAL_AT,
@@ -9299,6 +9544,7 @@ export {
   applyHouseGate,
   applySeverity,
   auditSnapshot,
+  bandOf,
   briefTerms,
   calibrate,
   catalogueTable,
@@ -9362,10 +9608,14 @@ export {
   globToRegExp,
   gradientContrast,
   gradientStops,
+  groundDistance,
+  groundLabel,
   groundName,
+  groundTemperature,
   harvest,
   hedgeCount,
   hedgedClose,
+  heroDistance,
   hexToOklch,
   holdHouseBlocks,
   houseRule,
@@ -9413,6 +9663,8 @@ export {
   renderedOrder,
   researchPrompt,
   retrofitPlan,
+  rhythmDistance,
+  rhythmOf,
   runTell,
   scanProvenance,
   scanSource,
@@ -9439,6 +9691,7 @@ export {
   tailwindV3Preset,
   tailwindV4Theme,
   tellById,
+  temperatureName,
   toGamut,
   toJson,
   toSarif,

package/licences.json

@@ -99,6 +99,33 @@
       "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."
+    },
+    {
+      "name": "Saira Semi Condensed",
+      "subject": "face",
+      "licence": "OFL-1.1",
+      "multiClient": "yes",
+      "checked": "2026-10-09",
+      "source": "https://github.com/google/fonts/blob/main/ofl/sairasemicondensed/OFL.txt",
+      "note": "Copyright 2016 The Saira Project Authors (omnibus.type@gmail.com), reserved font name Saira. Keep the OFL notice with the font files; a modified build may not be called Saira. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
+    },
+    {
+      "name": "Public Sans",
+      "subject": "face",
+      "licence": "OFL-1.1",
+      "multiClient": "yes",
+      "checked": "2026-10-09",
+      "source": "https://github.com/google/fonts/blob/main/ofl/publicsans/OFL.txt",
+      "note": "Copyright 2015 The Public Sans Project Authors (https://github.com/uswds/public-sans). Keep the OFL notice with the font files. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
+    },
+    {
+      "name": "Martian Mono",
+      "subject": "face",
+      "licence": "OFL-1.1",
+      "multiClient": "yes",
+      "checked": "2026-10-09",
+      "source": "https://github.com/google/fonts/blob/main/ofl/martianmono/OFL.txt",
+      "note": "Copyright 2021 The Martian Mono Project Authors (https://github.com/evilmartians/mono). Keep the OFL notice with the font files. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.18.2",
+  "version": "0.19.1",
   "private": false,
   "description": "The Doman Digital house craft standard as numbers: OKLCh colour ramps that snap to existing anchors, derived semantic tokens with measured WCAG and APCA contrast, one shared motion vocabulary for CSS and JS, and a base stylesheet. Zero dependencies.",
   "license": "Apache-2.0",