@domandigital/craft 0.19.0 → 0.19.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @domandigital/craft
 
+## 0.19.1
+
+### Patch Changes
+
+- 5056c6a: STANDARD.md: a new section 10, "The phone is the base layout" (DOM-774): base styles are the phone and wider layouts use `min-width` only, 375px is the floor every surface is designed and measured at, touch targets are at least 44 x 44 CSS px, form fields at least 16px, reviews start from the phone capture, and performance is judged on the mobile Lighthouse profile. What is not a rule is now section 11 and says layout stays free at every width; the numbers are section 12. The older sections lose their em dashes to the house copy check, with the wording unchanged. Docs only.
+- 00d79a0: `craft copy` reads `title` and `description` in Markdown front matter. A dash or a stock phrase in an agent description or a page title is reported on that line, and `copy-ok` on the line or the line above still suppresses it. Other front matter keys stay unread, and fenced code stays unread.
+
 ## 0.19.0
 
 ### Minor Changes

package/README.md

@@ -67,7 +67,7 @@ module.exports = { presets: [tailwindV3Preset()] };
 
 ## The standard itself
 
-[STANDARD.md](./STANDARD.md) is the eleven-section house standard, every numeric
+[STANDARD.md](./STANDARD.md) is the twelve-section house standard, every numeric
 rule cited, including a section on what is deliberately *not* a rule. Its
 canonical numbers are compared against the code on every test run, so the
 document cannot drift from what ships.

package/STANDARD.md

@@ -1,17 +1,18 @@
 # The Doman Digital craft standard
 
-Eleven sections. Every numeric rule is cited, and section 10 says what is
+Twelve sections. Every numeric rule is cited, and section 11 says what is
 deliberately *not* a rule.
 
 This document and the package are bound together by a test: the machine-readable
-block in section 11 is compared against `HOUSE_BUDGET`, `EASE` and
+block in section 12 is compared against `HOUSE_BUDGET`, `EASE` and
 `DURATION_MS` on every run, so the standard cannot drift from what ships.
 
 ---
 
+<!-- copy-ok: the standard names the practice each rule replaces -->
 ## 1. Colour is derived, not picked
 
-Anchors — colours a surface already ships — are sacred and come back byte-identical.
+Anchors, the colours a surface already ships, are sacred and come back byte-identical.
 Everything else is generated in OKLCh from those anchors.
 
 - Ramps have **11 steps** (50–950).
@@ -19,7 +20,7 @@ Everything else is generated in OKLCh from those anchors.
   (CSS Color 4 §13.2). RGB clipping is rejected: it walks a saturated violet
   toward magenta.
 - Derived values standing in for a hand-picked one must be within
-  **ΔE_OK ≤ 0.02** — the just-noticeable difference — or be declared an
+  **ΔE_OK ≤ 0.02** (the just-noticeable difference) or be declared an
   intentional change.
 
 *Source: Ottosson, "A perceptual color space for image processing" (2020); CSS Color 4 §13.2.*
@@ -40,9 +41,9 @@ Everything else is generated in OKLCh from those anchors.
 ## 3. Type is fluid, and always has a rem term
 
 - Steps **−2 to 5**, `clamp()` interpolated between a small and a large viewport.
-- The interpolation term is **`rem + vw`, never bare `vw`** — a bare-`vw` size
+- The interpolation term is **`rem + vw`, never bare `vw`**. A bare-`vw` size
   ignores the browser text-size setting and fails WCAG 1.4.4 at 200% zoom.
-- Existing sizes are **pinned**, not regenerated, so adopting the scale moves
+- Existing sizes are **pinned**, not regenerated, so adopting the scale moves <!-- copy-ok -->
   nothing.
 
 *Source: Utopia (utopia.fyi); WCAG 2.2 SC 1.4.4.*
@@ -58,7 +59,7 @@ Everything else is generated in OKLCh from those anchors.
 - Clipped display text gets a **descender mask** (`padding-bottom: .16em;
   margin-bottom: -.16em`), or it loses the tails of g, j, p, q, y.
 
-*Source: house habit — the −0.01em display tracking and the ch measure were arrived at independently in two client repos.*
+*Source: house habit. The −0.01em display tracking and the ch measure were arrived at independently in two client repos.*
 
 ## 5. Space is fluid and proportional to type
 
@@ -66,7 +67,7 @@ Everything else is generated in OKLCh from those anchors.
 - Section rhythm has **three** sizes, not five. Five shipped with zero consumers,
   which is the signature of a scale invented ahead of a need.
 
-*Source: Utopia; measured — `--space-section-xs..xl` had no consumers in the monorepo.*
+*Source: Utopia; measured: `--space-section-xs..xl` had no consumers in the monorepo.*
 
 ## 6. Density is a property of the surface
 
@@ -89,7 +90,7 @@ needs. Set once on a shell via `[data-density]`, inherited below.
   meaning it covers more ground per unit time arriving than it averaged.
 - **UI durations ≤ 300ms.** Drawers and one gated reveal may exceed it.
 - **Don't animate what fires 100×/day**, and never animate a keyboard-triggered
-  interaction — the user is moving faster than the animation.
+  interaction: the user is moving faster than the animation.
 - **One signature moment per page**, gated, never the LCP element.
 
 *Source: Emil Kowalski, "Animations on the Web"; Core Web Vitals (LCP).*
@@ -101,12 +102,12 @@ needs. Set once on a shell via `[data-density]`, inherited below.
 
 **Never `animation: none` inside the block.** That drops the `forwards` fill along with the
 animation, so a forwards-filled entrance never applies its end state and the
-element keeps `opacity: 0` from its base rule — permanently invisible, for
+element keeps `opacity: 0` from its base rule, permanently invisible, for
 exactly the users who asked for less motion. This shipped.
 
 Images: AVIF and WebP, in that order.
 
-*Source: WCAG 2.2 SC 2.3.3; measured — a live site was stranded at opacity 0 by this exact defect.*
+*Source: WCAG 2.2 SC 2.3.3; measured: a live site was stranded at opacity 0 by this exact defect.*
 
 ## 9. Restraint is the budget
 
@@ -118,11 +119,11 @@ step: `code { font-size: 0.875em }` states one relationship and applies it
 wherever code appears, rather than adding a rung to the ladder. Counting it
 against the scale is the same category error as counting the framework's theme.
 It is still counted, because eight competing ratios is as unreadable as eight
-competing steps — split, not dropped. A value that stops being reported is a
+competing steps: split, not dropped. A value that stops being reported is a
 value that grows.
 
 Differentiation guards pass anything that differs from its siblings, however
-ugly. What they cannot see is accumulation — eighteen font sizes, six shadows,
+ugly. What they cannot see is accumulation: eighteen font sizes, six shadows,
 four competing accents, each added reasonably, together reading as noise.
 
 The budget counts the vocabulary a surface **chose**, and the whole difficulty
@@ -141,7 +142,7 @@ second reports a pass.
 
 The line is **used versus unused**, which is not a property of the layer:
 
-- References are **resolved**, not skipped — through the token chain, to the
+- References are **resolved**, not skipped: through the token chain, to the <!-- copy-ok -->
   value that renders.
 - A definition is only ever reached from a declaration in a kept layer, so a
   framework default nothing uses still counts for nothing.
@@ -154,7 +155,34 @@ The line is **used versus unused**, which is not a property of the layer:
 
 *Source: measured against the estate. The budget is the observed ceiling of the surfaces that read as designed; the resolution rule is what it took to measure them at all.*
 
-## 10. What is deliberately not a rule
+## 10. The phone is the base layout
+
+Mobile first is a rule about **order and floor**, not about a layout. The phone
+is designed, built and measured first, and every wider layout is derived from
+it. A desktop layout squeezed onto a phone keeps the desktop's priorities and
+drops whatever did not fit; a phone layout widened keeps what matters and adds.
+
+- **The phone is the base.** Base styles are the phone layout. Wider layouts
+  are added with `min-width` queries only (Tailwind: unprefixed is the phone,
+  `sm:` `md:` `lg:` add). A `max-width` query, a `width <` range or a Tailwind
+  `max-*:` variant needs a recorded exception with its reason.
+- **375px is the floor.** Every surface is designed and measured at **375 CSS
+  px** first, the narrowest iPhone width in common use (SE, mini, X to 11 Pro).
+  Nothing scrolls sideways at 375. 390 is still measured: it is the width the
+  design is accepted at.
+- **Touch targets at least 44 × 44 CSS px.** A link inside a sentence is exempt,
+  as in WCAG's own inline exception. 24px (SC 2.5.8, AA) is what an audit asks
+  for; 44 is the house bar.
+- **Form inputs at least 16px.** Safari on iOS zooms the page when a field set
+  smaller gets focus, and the visitor has to pinch back out. Fix the size, never
+  the viewport: `maximum-scale=1` takes zoom away from people who need it.
+- **Reviews look at the phone capture first**, then the desktop one.
+- **Performance is judged on the mobile Lighthouse profile.** A desktop score
+  is not evidence: the phone is the slower device and the one Google indexes.
+
+*Source: WCAG 2.2 SC 2.5.5 (Target Size, Enhanced), SC 2.5.8 and SC 1.4.4; Apple Human Interface Guidelines, "Accessibility" (44 × 44 pt hit targets); WebKit's focus zoom on fields under 16px; Lighthouse's default mobile emulation; Google Search Central, "Mobile-first indexing"; Luke Wroblewski, "Mobile First" (2011).*
+
+## 11. What is deliberately not a rule
 
 The package emits **plain CSS custom properties** precisely so these stay free:
 
@@ -162,9 +190,11 @@ The package emits **plain CSS custom properties** precisely so these stay free:
   two; the third needs nothing.
 - **The motion library.** `EASE_TUPLE` carries the same control points as `EASE`,
   so Framer Motion, GSAP and CSS agree without the package choosing one.
-- **Where tokens live.** A `:root` block, a generated file, a Tailwind theme —
+- **Where tokens live.** A `:root` block, a generated file, a Tailwind theme:
   the package does not care.
-- **Layout, grid and component structure.** Not a rule. Layout *defaults*
+- **Layout, grid and component structure.** Not a rule, at any width. Section
+  10 fixes the order the widths are designed in and the floor they are
+  measured at; what the phone layout looks like stays free. Layout *defaults*
   (hero straight into a trust strip, three icon cards, a reveal on every
   section) are measured as character in [CHARACTER.md](./CHARACTER.md), as
   warnings with a declared-exception path, never as rules here.
@@ -172,7 +202,7 @@ The package emits **plain CSS custom properties** precisely so these stay free:
 
 A rule here has to be one that is wrong to break. Everything else is a default.
 
-## 11. The numbers
+## 12. The numbers
 
 <!-- craft:canonical -->
 ```json

package/dist/{audit-X7LGATAQ.js → audit-43PC4LMS.js}

@@ -9,10 +9,10 @@ import {
   snapshotPage,
   snapshotUrl,
   snapshotUrls
-} from "./chunk-W7PMRSDG.js";
+} from "./chunk-VDUIIWG7.js";
 import "./chunk-JYNXGCYZ.js";
-import "./chunk-IHT6CJOM.js";
-import "./chunk-4QWEAL4G.js";
+import "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.js";
 import "./chunk-QYBAVU3P.js";
 export {
   PROVENANCE_BUDGET_MS,

package/dist/{chunk-J35UYAVV.js → chunk-37ARRJAD.js}

@@ -1,11 +1,11 @@
 import {
   snapshotUrl,
   snapshotUrls
-} from "./chunk-W7PMRSDG.js";
+} from "./chunk-VDUIIWG7.js";
 import {
   describeTypicality,
   loadNull
-} from "./chunk-NCBCZFDY.js";
+} from "./chunk-ORFILP5L.js";
 import {
   SOURCE_FILE,
   finish,
@@ -14,7 +14,7 @@ import {
   parseFlags,
   prepareReport,
   readPaths
-} from "./chunk-GNVZGG3E.js";
+} from "./chunk-DUUDGR56.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -28,7 +28,7 @@ import {
   rhythmOf,
   scanSource,
   typicality
-} from "./chunk-IHT6CJOM.js";
+} from "./chunk-WK2WMWTH.js";
 
 // src/audit/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-RNHV2SXC.js → chunk-4LJFZH2I.js}

@@ -10,10 +10,10 @@ import {
   levenshtein,
   normaliseFamily,
   parseColour
-} from "./chunk-IHT6CJOM.js";
+} from "./chunk-WK2WMWTH.js";
 import {
   TRADE_NOUNS
-} from "./chunk-4QWEAL4G.js";
+} from "./chunk-CZ7KT452.js";
 
 // src/direction/types.ts
 var DIRECTION_VERSION = 2;

package/dist/{chunk-4QWEAL4G.js → chunk-CZ7KT452.js}

@@ -263,8 +263,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) {

package/dist/{chunk-GNVZGG3E.js → chunk-DUUDGR56.js}

@@ -10,7 +10,7 @@ import {
   holdHouseBlocks,
   houseRule,
   scanSource
-} from "./chunk-IHT6CJOM.js";
+} from "./chunk-WK2WMWTH.js";
 import {
   compareCompetitor,
   compareFacts,
@@ -21,7 +21,7 @@ import {
   pageCopy,
   protectedFacts,
   visibleText
-} from "./chunk-4QWEAL4G.js";
+} from "./chunk-CZ7KT452.js";
 
 // src/character/config.ts
 var DEFAULT_IGNORE = [".claude", ".agents", ".cursor"];
@@ -601,7 +601,7 @@ async function pageSnapshot(target, cwd) {
     return readSnapshot(JSON.parse(readFileSync(local, "utf8")), target);
   }
   if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL nor a snapshot file`);
-  const { snapshotUrl } = await import("./audit-X7LGATAQ.js");
+  const { snapshotUrl } = await import("./audit-43PC4LMS.js");
   return snapshotUrl(target);
 }
 async function briefFor(flags, cwd) {
@@ -612,7 +612,7 @@ async function briefFor(flags, cwd) {
     if (typeof brief === "string" && brief.trim()) return brief;
   } else if (flags.direction) throw new Error(`no such file: ${flags.direction}`);
   if (flags.null) {
-    const { loadNull } = await import("./cli-3WWHRJRG.js");
+    const { loadNull } = await import("./cli-L3VGKWZH.js");
     return loadNull(flags.null, cwd).brief;
   }
   return void 0;
@@ -638,31 +638,31 @@ async function compareWithCompetitor(flags, io) {
 function run(argv, io) {
   const [command, ...rest] = argv;
   if (command === "direction") {
-    return import("./cli-DKI37OXK.js").then((m) => m.runDirection(rest, io));
+    return import("./cli-TH76ATN3.js").then((m) => m.runDirection(rest, io));
   }
   if (command === "report" || command === "retrofit") {
-    return import("./cli-KXVJJDN5.js").then((m) => m.runReport(command, rest, io));
+    return import("./cli-AACBHRUG.js").then((m) => m.runReport(command, rest, io));
   }
   if (command === "register") {
-    return import("./cli-JB4X5LAG.js").then((m) => m.runRegister(rest, io));
+    return import("./cli-VPARW6FY.js").then((m) => m.runRegister(rest, io));
   }
   if (command === "estate") {
-    return import("./cli-U7WEVPZL.js").then((m) => m.runEstate(rest, io));
+    return import("./cli-3P44X6E3.js").then((m) => m.runEstate(rest, io));
   }
   if (command === "null") {
-    return import("./cli-3WWHRJRG.js").then((m) => m.runNull(rest, io));
+    return import("./cli-L3VGKWZH.js").then((m) => m.runNull(rest, io));
   }
   if (command === "calibrate") {
-    return import("./cli-YD3VN52R.js").then((m) => m.runCalibrate(rest, io));
+    return import("./cli-7OUA6ZSE.js").then((m) => m.runCalibrate(rest, io));
   }
   if (command === "tells" && rest[0] === "harvest") {
-    return import("./cli-3WWHRJRG.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+    return import("./cli-L3VGKWZH.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
       io.err(`craft: ${error.message}`);
       return 2;
     });
   }
   if (command === "snapshot" || command === "audit") {
-    return import("./cli-ZGB6MUN2.js").then((m) => m.runAudit(command, rest, io));
+    return import("./cli-4D7Q5BCE.js").then((m) => m.runAudit(command, rest, io));
   }
   if (!command || command === "help" || command === "--help" || command === "-h") {
     io.out(HELP);

package/dist/{chunk-NCBCZFDY.js → chunk-ORFILP5L.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-OQXTQQAU.js";
 import {
   parseFlags
-} from "./chunk-GNVZGG3E.js";
+} from "./chunk-DUUDGR56.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -22,10 +22,10 @@ import {
   hueSwatch,
   nullPrompt,
   scanSource
-} from "./chunk-IHT6CJOM.js";
+} from "./chunk-WK2WMWTH.js";
 import {
   extractStrings
-} from "./chunk-4QWEAL4G.js";
+} from "./chunk-CZ7KT452.js";
 
 // src/null/cli.ts
 import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
@@ -120,7 +120,7 @@ async function build(flags, io) {
   const toShoot = ids.filter((id) => existsSync(join(pages, `${id}.html`)) && !existsSync(join(shots, `${id}.json`)));
   if (toShoot.length) {
     io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"}`);
-    const { snapshotUrls } = await import("./audit-X7LGATAQ.js");
+    const { snapshotUrls } = await import("./audit-43PC4LMS.js");
     const results = await snapshotUrls(toShoot.map((id) => pathToFileURL(join(pages, `${id}.html`)).href));
     results.forEach((r, i) => {
       const id = toShoot[i];
@@ -241,7 +241,7 @@ async function importPages(flags, io) {
   const toShoot = pages.filter((p) => !existsSync(join(shots, `${p.id}.json`)));
   if (toShoot.length) {
     io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"} from ${flags.builder}`);
-    const { snapshotUrls } = await import("./audit-X7LGATAQ.js");
+    const { snapshotUrls } = await import("./audit-43PC4LMS.js");
     const servers = /* @__PURE__ */ new Map();
     try {
       for (const p of toShoot) if (!servers.has(p.root)) servers.set(p.root, await serveDir(p.root));

package/dist/{chunk-LWKMGJSW.js → chunk-P37LLKL4.js}

@@ -4,13 +4,13 @@ import {
   formatDirectionMatches,
   summariseDirection,
   validateDirection
-} from "./chunk-RNHV2SXC.js";
+} from "./chunk-4LJFZH2I.js";
 import {
   loadNull
-} from "./chunk-NCBCZFDY.js";
+} from "./chunk-ORFILP5L.js";
 import {
   parseFlags
-} from "./chunk-GNVZGG3E.js";
+} from "./chunk-DUUDGR56.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -30,7 +30,7 @@ import {
   rhythmOf,
   shapeName,
   temperatureName
-} from "./chunk-IHT6CJOM.js";
+} from "./chunk-WK2WMWTH.js";
 
 // src/estate/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -133,7 +133,7 @@ async function snapshotOf(target, cwd) {
     return snap;
   }
   if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL, a snapshot file, nor a site in the register`);
-  const { snapshotUrl } = await import("./audit-X7LGATAQ.js");
+  const { snapshotUrl } = await import("./audit-43PC4LMS.js");
   return snapshotUrl(target);
 }
 var line = (distance, sibling, shared) => `${distance.toFixed(2)}${sibling ? "  SIBLING" : ""}${shared.length ? `  shares ${shared.join(", ")}` : ""}`;

package/dist/{chunk-W7PMRSDG.js → chunk-VDUIIWG7.js}

@@ -4,7 +4,7 @@ import {
 import {
   auditSnapshot,
   fingerprint
-} from "./chunk-IHT6CJOM.js";
+} from "./chunk-WK2WMWTH.js";
 import {
   SNAPSHOT_VERSION
 } from "./chunk-QYBAVU3P.js";

package/dist/{chunk-IHT6CJOM.js → chunk-WK2WMWTH.js}

@@ -9,7 +9,7 @@ import {
   parseFile,
   sentencesOf,
   specificity
-} from "./chunk-4QWEAL4G.js";
+} from "./chunk-CZ7KT452.js";
 import {
   SNAPSHOT_VERSION
 } from "./chunk-QYBAVU3P.js";

package/dist/{cli-U7WEVPZL.js → cli-3P44X6E3.js}

@@ -4,15 +4,15 @@ import {
   formatPairs,
   loadEstate,
   runEstate
-} from "./chunk-LWKMGJSW.js";
-import "./chunk-RNHV2SXC.js";
-import "./chunk-NCBCZFDY.js";
+} from "./chunk-P37LLKL4.js";
+import "./chunk-4LJFZH2I.js";
+import "./chunk-ORFILP5L.js";
 import "./chunk-OQXTQQAU.js";
-import "./chunk-GNVZGG3E.js";
+import "./chunk-DUUDGR56.js";
 import "./chunk-QIEDBL4J.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-IHT6CJOM.js";
-import "./chunk-4QWEAL4G.js";
+import "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.js";
 import "./chunk-QYBAVU3P.js";
 export {
   formatComponentPairs,

package/dist/{cli-ZGB6MUN2.js → cli-4D7Q5BCE.js}

@@ -4,16 +4,16 @@ import {
   merge,
   resolvePages,
   runAudit
-} from "./chunk-J35UYAVV.js";
-import "./chunk-W7PMRSDG.js";
+} from "./chunk-37ARRJAD.js";
+import "./chunk-VDUIIWG7.js";
 import "./chunk-JYNXGCYZ.js";
-import "./chunk-NCBCZFDY.js";
+import "./chunk-ORFILP5L.js";
 import "./chunk-OQXTQQAU.js";
-import "./chunk-GNVZGG3E.js";
+import "./chunk-DUUDGR56.js";
 import "./chunk-QIEDBL4J.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-IHT6CJOM.js";
-import "./chunk-4QWEAL4G.js";
+import "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.js";
 import "./chunk-QYBAVU3P.js";
 export {
   describeComponents,

package/dist/{cli-YD3VN52R.js → cli-7OUA6ZSE.js}

@@ -4,11 +4,11 @@ import {
 import {
   expandNullTargets,
   loadNull
-} from "./chunk-NCBCZFDY.js";
+} from "./chunk-ORFILP5L.js";
 import "./chunk-OQXTQQAU.js";
 import {
   parseFlags
-} from "./chunk-GNVZGG3E.js";
+} from "./chunk-DUUDGR56.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -21,8 +21,8 @@ import {
   fingerprint,
   scanSource,
   typicality
-} from "./chunk-IHT6CJOM.js";
-import "./chunk-4QWEAL4G.js";
+} from "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.js";
 import {
   SNAPSHOT_VERSION
 } from "./chunk-QYBAVU3P.js";
@@ -188,7 +188,7 @@ async function runCalibrate(args, io) {
     if (toTake.length) {
       io.err(`craft calibrate: taking ${toTake.length} snapshot${toTake.length === 1 ? "" : "s"}`);
       try {
-        const { snapshotUrls } = await import("./audit-X7LGATAQ.js");
+        const { snapshotUrls } = await import("./audit-43PC4LMS.js");
         const results = await snapshotUrls(toTake.map((t) => t.url));
         results.forEach((r, i) => {
           const { entry, keep } = toTake[i];

package/dist/{cli-KXVJJDN5.js → cli-AACBHRUG.js}

@@ -3,21 +3,21 @@ import {
 } from "./chunk-OKVHWXYV.js";
 import {
   merge
-} from "./chunk-J35UYAVV.js";
-import "./chunk-W7PMRSDG.js";
+} from "./chunk-37ARRJAD.js";
+import "./chunk-VDUIIWG7.js";
 import "./chunk-JYNXGCYZ.js";
 import {
   SIBLING_AT,
   compareToEstate,
   loadEstate
-} from "./chunk-LWKMGJSW.js";
+} from "./chunk-P37LLKL4.js";
 import {
   PAGE_TYPES,
   validateDirection
-} from "./chunk-RNHV2SXC.js";
+} from "./chunk-4LJFZH2I.js";
 import {
   loadNull
-} from "./chunk-NCBCZFDY.js";
+} from "./chunk-ORFILP5L.js";
 import "./chunk-OQXTQQAU.js";
 import {
   COPY_FILE,
@@ -28,7 +28,7 @@ import {
   loadExceptions,
   parseFlags,
   readPaths
-} from "./chunk-GNVZGG3E.js";
+} from "./chunk-DUUDGR56.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -42,8 +42,8 @@ import {
   fingerprint,
   scanSource,
   typicality
-} from "./chunk-IHT6CJOM.js";
-import "./chunk-4QWEAL4G.js";
+} from "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/report/cli.ts
@@ -126,7 +126,7 @@ async function runReport(command, args, io) {
     if (/\.json$/i.test(target2) && existsSync(local)) {
       snap = readSnapshot(JSON.parse(readFileSync(local, "utf8")), target2);
     } else {
-      const { snapshotUrl } = await import("./audit-X7LGATAQ.js");
+      const { snapshotUrl } = await import("./audit-43PC4LMS.js");
       snap = await snapshotUrl(target2);
     }
     const fp = fingerprint(snap);

package/dist/{cli-3WWHRJRG.js → cli-L3VGKWZH.js}

@@ -9,13 +9,13 @@ import {
   runHarvest,
   runNull,
   serveDir
-} from "./chunk-NCBCZFDY.js";
+} from "./chunk-ORFILP5L.js";
 import "./chunk-OQXTQQAU.js";
-import "./chunk-GNVZGG3E.js";
+import "./chunk-DUUDGR56.js";
 import "./chunk-QIEDBL4J.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-IHT6CJOM.js";
-import "./chunk-4QWEAL4G.js";
+import "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.js";
 import "./chunk-QYBAVU3P.js";
 export {
   describeTypicality,

package/dist/{cli-DKI37OXK.js → cli-TH76ATN3.js}

@@ -7,10 +7,10 @@ import {
   PROPOSED,
   researchPrompt,
   validateDirection
-} from "./chunk-RNHV2SXC.js";
+} from "./chunk-4LJFZH2I.js";
 import {
   parseFlags
-} from "./chunk-GNVZGG3E.js";
+} from "./chunk-DUUDGR56.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -26,8 +26,8 @@ import {
   isCream,
   oklchToRgb,
   parseColour
-} from "./chunk-IHT6CJOM.js";
-import "./chunk-4QWEAL4G.js";
+} from "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/direction/cli.ts
@@ -208,7 +208,7 @@ var readJson = (path) => JSON.parse(readFileSync(path, "utf8"));
 async function snapshotFrom(target, cwd) {
   if (!target) return void 0;
   if (/^https?:\/\//.test(target)) {
-    const { snapshotUrl } = await import("./audit-X7LGATAQ.js");
+    const { snapshotUrl } = await import("./audit-43PC4LMS.js");
     return snapshotUrl(target);
   }
   return readSnapshot(readJson(resolve(cwd, target)), target);

package/dist/{cli-JB4X5LAG.js → cli-VPARW6FY.js}

@@ -9,7 +9,7 @@ import {
   STOCK_PHRASES,
   countWords,
   specificity
-} from "./chunk-4QWEAL4G.js";
+} from "./chunk-CZ7KT452.js";
 
 // src/register/cli.ts
 import { existsSync, readFileSync } from "fs";

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-GNVZGG3E.js";
+} from "./chunk-DUUDGR56.js";
 import "./chunk-QIEDBL4J.js";
-import "./chunk-IHT6CJOM.js";
-import "./chunk-4QWEAL4G.js";
+import "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/cli.ts

package/dist/index.cjs

@@ -4344,8 +4344,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) {

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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.19.0",
+  "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",