@domandigital/craft 0.20.4 → 0.21.0

package/dist/index.js

@@ -1740,6 +1740,33 @@ var OUTCOME_PROMISES = [
   /\byou(?:['’]ll| will)\s+(?:get|see|win|receive|start getting)\s+more\b/i,
   new RegExp(`\\b(?:will|we['\u2019]ll)\\s+(?:(?:bring|drive|generate|get)\\s+you|bring|drive|generate)\\s+more\\s+(?:[\\w-]+\\s+)?${SALES_RESULTS}\\b`, "i")
 ];
+var SENTENCE_START = String.raw`(?<=^|[\n>"“]|[.!?]\s+)`;
+var MATEY = [
+  // "Alright Carlo,", "Oi Dave", "Alright, mate"
+  /\b(?:Alright|Oi)(?:,\s*|\s+)(?:mate\b|[A-Z][a-z]+\b)/,
+  // "mate" as a form of address, not "a mate who knows"
+  /,\s*mate\b|\b(?:thanks|ta|cheers|alright|oi|fussed|sorry|worries|bother|hiya|hey)\s+mate\b/i,
+  /\b(?:innit|chuffed|lovely jubbly)\b|\bbish,?\s+bash,?\s+bosh\b|\bbob['’]?s\s+your\s+uncle\b/i,
+  /\bno\s+(?:worries|bother)\b|\bnot\s+fussed\b/i,
+  // "Right then," opening a sentence, not "the right then left turn"
+  new RegExp(`${SENTENCE_START}Right,?\\s+then\\b[,!.]`),
+  // "we'll get you sorted", "all sorted", "Sorted!", not "sorted by date"
+  /\b(?:all|get(?:ting)?\s+(?:it|that|this|you|them|everything)|got\s+(?:it|that|you)|you['’]re)\s+sorted\b(?!\s+(?:by|in|into|alphabetically)\b)/i,
+  new RegExp(`${SENTENCE_START}Sorted[.!]`),
+  // "proper" as an intensifier before an adjective, not "proper planning"
+  /\bproper\s+(?:good|nice|quick|tidy|lovely|decent|chuffed|busy|mint|smart|happy|gutted|brilliant|buzzing)\b/i,
+  /\bgive\s+(?:me|us)\s+a\s+(?:shout|bell|buzz|tinkle)\b/i,
+  /\bwhen\s+you\s+(?:get|have|['’]ve\s+got)\s+a\s+(?:sec|min|mo)\b/i,
+  /\bhave\s+a\s+(?:quick\s+)?(?:gander|squiz|nosey|nose(?:\s+(?:round|around))?)\b(?!\s+for\b)/i,
+  /\bcheck\s+out\s+(?:our|my|this|these)\b/i
+];
+var CLIPPED = [
+  /\b(?:take|takes|took|taking|have|has|had|having)\s+(?:quick\s+)?look\s+(?:at|on|over|through|in)\b/i,
+  /\bgive\s+(?:it|this|that|them)\s+(?:go|try|look|read|whirl|bash)\b(?![-\w])/i,
+  new RegExp(`${SENTENCE_START}Quick\\s+one\\b(?=\\s*[:,.!?\u2014\u2013-]|\\s+(?:for you|before|on|about)\\b)`),
+  // "Alright Carlo, built you a proper site": the "I" left out
+  /(?<=^|[\n>"“]|[.!?—–-]\s*|,\s+)(?:[Bb]uilt|[Mm]ade|[Pp]ut together|[Kk]nocked up)\s+(?:you|your\s+\w+|the\s+\w+)\s+an?\b/
+];
 var NEGATION = [
   // "It's not just a haircut, it's an experience."
   /\b(?:it['’]?s|it is|this is|this isn['’]t|we['’]re|we are|they['’]re)\s+(?:not|more than)\s+(?:just|only|merely|simply)?\s*[^.!?\n]{1,60}?[,;.—-]\s*(?:it['’]?s|it is|this is|we['’]re|we are|they['’]re)\b/i,
@@ -1976,6 +2003,40 @@ var COPY_TELLS = [
       ]
     }
   },
+  {
+    id: "matey-register",
+    name: "Matey register",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'Alright Dave,', 'no worries, we'll get you sorted', 'Quick one:', 'have look at': a put-on, over-familiar British voice, with the small words clipped out. A model asked to sound British writes it; the UK is broad, and a client reads it as cringe and a little rude.",
+    fix: "Write plain, complete British English. 'Alright Dave, built you a site' becomes 'Hi Dave, I have built you a site'; 'No worries, we'll get you sorted' becomes 'We can fit you in on Thursday'.",
+    detect: phrases([...MATEY, ...CLIPPED], quoted),
+    fixtures: {
+      flag: [
+        // From the portal's seeded prospect follow-ups, 2026-10-19.
+        f("emails/followup.md", "Alright Dave, it's Dmitri. No pressure, have a look when you get a min."),
+        f("emails/followup.md", "All good if you're not fussed mate, I'll leave it there."),
+        f("emails/followup.md", "Carlo, built the shop a proper site."),
+        f("content/contact.md", "No worries, we'll get you sorted."),
+        f("emails/quote.md", "Take look on these photos and give it go."),
+        f("emails/quote.md", "Quick one: is Thursday still good?"),
+        f("emails/quote.md", "Right then, here is the plan."),
+        f("content/reviews.md", "The fitters did a proper good job and we were chuffed.")
+      ],
+      pass: [
+        f("content/home.md", "Proper planning saves a second visit."),
+        f("content/certificates.md", "Download a sorted list of certificates, sorted by date."),
+        f("content/directions.md", "At the junction, take the right then left turn."),
+        // Chair and Blade's own approved line, and "mate" as a noun.
+        f("content/home.md", "Every cut starts with a proper chat about what you actually want."),
+        f("content/home.md", "It feels like getting a cut from a mate who knows what he is doing."),
+        f("emails/quote.md", "Have a look at the quote and ring me if Thursday does not work."),
+        f("content/contact.md", "Give us a ring on 01280 700123. We take a look at the fault before quoting."),
+        f("content/home.md", "Built to last, and made for older houses.")
+      ]
+    }
+  },
   {
     id: "hollow-imperative",
     name: "Hollow imperative",
@@ -2176,7 +2237,12 @@ var FALSE_RANGE = [
 ];
 var RESIDUE = [
   /\bas an AI(?:\s+language)?\s+(?:model|assistant)\b/i,
-  /(?:^|\n|>)\s*(?:Certainly|Sure|Absolutely|Of course|Great question)[!,.]\s+(?:Here(?:['’]s| is| are)|Below)\b/i,
+  // At the start of a line, or after a sentence that ends in a full stop or
+  // an exclamation mark: "I hope this email finds you well! Certainly, here
+  // is the handover request." slipped through when only a line start counted
+  // (found live, 2026-10-19). Not after a question mark: an FAQ answer may
+  // honestly open "Do you work weekends? Absolutely, here are our hours."
+  /(?<=^|[\n>]|[.!]\s+)\s*(?:Certainly|Sure|Absolutely|Of course|Great question)[!,.]\s+(?:Here(?:['’]s| is| are)|Below)\b/i,
   /\bhere(?:['’]s| is)\s+(?:a|an|the|your)\s+(?:revised|rewritten|updated|polished|refined|improved|draft|more concise)\s+(?:version|draft|copy)\b/i,
   /\blet me know if you(?:['’]d| would) like me to\b/i,
   /\b(?:my|the) (?:knowledge|training) cut-?off\b|\bas of my last (?:update|training)\b/i,
@@ -2192,6 +2258,13 @@ var RESIDUE = [
   /[\uE200-\uE2FF]*entity[\uE200-\uE2FF]*\["[a-z_]+"\s*,\s*"[^"\n]{1,80}"(?:\s*,\s*"[^"\n]{0,160}")*\][\uE200-\uE2FF]*/,
   /【\d+(?:[:†][^】]{0,40})?】/
 ];
+var STOCK_EMAIL = [
+  /\bI (?:hope|trust) (?:this|my|the) (?:e-?mail|message|note|letter) finds you(?: all)? (?:well|in good health)\b/i,
+  /\bI hope you(?:['’]re| are)(?: all)? (?:doing |keeping )?well\b/i,
+  /\b(?:I )?hope you(?:['’]re| are) having an? (?:great|good|lovely|wonderful|fantastic) (?:day|week|weekend)\b/i,
+  /\blet (?:me|us) know if you have any (?:further |other |more )?questions\b/i,
+  /\b(?:do not|don['’]t) hesitate to (?:contact|reach out|get in touch|ask|call)\b/i
+];
 var AI_UTM = /utm_source=(?:chatgpt\.com|chat\.openai\.com|openai|perplexity(?:\.ai)?|claude\.ai|copilot(?:\.microsoft\.com)?|gemini(?:\.google\.com)?)\b/gi;
 function residueHits(ctx) {
   const hits = phrases(RESIDUE, quoted, allText)(ctx);
@@ -2273,15 +2346,39 @@ var RESEARCH_TELLS = [
         f("content/home.md", "Prices start at \xA340 :contentReference[oaicite:2]{index=2} for a full set."),
         f("content/home.md", "Prices start at \xA340\u30104\u2020source\u3011 for a full set."),
         f("app/guide.tsx", `export const Guide = () => <a href="https://example.com/guide?utm_source=chatgpt.com">Read the guide</a>;`),
-        f("content/home.md", "Here's a more concise version for the hero.")
+        f("content/home.md", "Here's a more concise version for the hero."),
+        // The client handover email that a clean copy-check let through, 2026-10-19.
+        f("emails/handover.md", "Hi,\n\nI hope this email finds you well! Certainly, here is the handover request. Let me know if you have any questions.")
       ],
       pass: [
         f("content/home.md", "Certainly the busiest week of the year: book early."),
+        f("content/faq.md", "Do you work weekends? Absolutely, here are our hours."),
         f("content/home.md", "Here's the price list for 2026."),
         f("app/guide.tsx", `export const Guide = () => <a href="https://example.com/guide?utm_source=newsletter">Read the guide</a>;`)
       ]
     }
   },
+  {
+    id: "stock-email-line",
+    name: "Stock email line",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "'I hope this email finds you well', 'let me know if you have any questions', 'don't hesitate to contact us': the opener and closer of a form email. A client reads past them, and a model drafting an email writes them every time.",
+    fix: "Cut the opener and start with the reason for writing. Replace the closer with the next step and who to ask: 'Ring me on 07700 900123 if the date does not work.'",
+    detect: phrases(STOCK_EMAIL, quoted),
+    fixtures: {
+      flag: [
+        f("emails/handover.md", "Hi,\n\nI hope this email finds you well! Certainly, here is the handover request. Let me know if you have any questions."),
+        f("emails/quote.md", "Hope you're having a great week. The quote is attached."),
+        f("content/contact.md", "Please don't hesitate to contact us about a rewire.")
+      ],
+      pass: [
+        f("emails/handover.md", "Hi Sam,\n\nThe handover pack is attached: certificates, the board schedule and the warranty. Ring me on 07700 900123 if anything is missing."),
+        f("content/contact.md", "If you have any questions, ring Jo on 01280 700123.")
+      ]
+    }
+  },
   {
     id: "prompt-context",
     name: "Prompt context",
@@ -4891,6 +4988,10 @@ var HOUSE = {
   // New 2026-10-14 (founder): review first, like every new tell, until estate hits are read.
   "sales-tagline": { tier: "review", label: "sales tagline, say what you will actually do" },
   "outcome-promise": { tier: "review", label: "outcome promise, promise the work, not the result" },
+  // New 2026-10-19: review first, like every new tell, until estate hits are read.
+  "stock-email-line": { tier: "review", label: "stock email line, start with the reason for writing and end with the next step" },
+  // New 2026-10-19 (founder): review first, like every new tell, until estate hits are read.
+  "matey-register": { tier: "review", label: "matey register, write plain and complete British English" },
   "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
   "stock-phrase": { tier: "review", label: "stock phrase" },
   "hollow-imperative": { tier: "review", label: "hollow imperative" },
@@ -6096,7 +6197,7 @@ var IMAGERY_TELLS = [
 ];
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.10.2";
+var CATALOGUE_VERSION = "2026.10.4";
 var CATALOGUE = [
   ...[...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map((t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t),
   ...SPECIFICITY_COPY_TELLS,

package/dist/phone.cjs

@@ -33,8 +33,13 @@ __export(phone_exports, {
   WIDE_WIDTHS: () => WIDE_WIDTHS,
   bandOf: () => bandOf,
   checkExceptions: () => checkExceptions,
+  cleanRoute: () => cleanRoute,
   formatWidths: () => formatWidths,
+  hasReason: () => hasReason,
+  hasUnexcusedEntries: () => hasUnexcusedEntries,
+  judgeGrowth: () => judgeGrowth,
   judgeMeasured: () => judgeMeasured,
+  judgeRoutes: () => judgeRoutes,
   judgeStatic: () => judgeStatic,
   mainActionFor: () => mainActionFor,
   measurePhone: () => measurePhone,
@@ -45,8 +50,12 @@ __export(phone_exports, {
   measureViewports: () => measureViewports,
   mergeViewportFindings: () => mergeViewportFindings,
   normaliseElement: () => normaliseElement,
+  parseBaseline: () => parseBaseline,
   reasonOf: () => reasonOf,
   routeFile: () => routeFile,
+  routeMatches: () => routeMatches,
+  routesFromManifest: () => routesFromManifest,
+  routesFromPages: () => routesFromPages,
   scanPhoneFirst: () => scanPhoneFirst,
   sweepWidths: () => sweepWidths,
   writeBaseline: () => writeBaseline
@@ -62,13 +71,14 @@ var PHONE = {
   isMobile: true,
   hasTouch: true
 };
-var PHONE_FLOORS = { targetPx: 44, fieldFontPx: 16, textPx: 12 };
+var PHONE_FLOORS = { targetPx: 44, fieldFontPx: 16, textPx: 12, fieldHeightPx: 48 };
 var DEFAULT_MEASURED_DIR = "phone-first/measured";
 var routeFile = (route) => `${route === "/" ? "home" : route.replace(/^\/+|\/+$/g, "").replace(/[^\w.-]+/g, "-")}.json`;
 
 // src/phone/measure-in-page.ts
 function measurePhoneInPage(floors) {
   const out = [];
+  const fieldHeightPx = floors.fieldHeightPx ?? 48;
   const only = floors.only;
   const on = (c) => !only || only.includes(c);
   const vw = document.documentElement.clientWidth;
@@ -112,6 +122,9 @@ function measurePhoneInPage(floors) {
     if (!shown(e) || quiet(e) || e.tagName === "INPUT" && NOT_TEXT.has(e.type)) continue;
     const px = parseFloat(getComputedStyle(e).fontSize);
     if (px < floors.fieldFontPx) out.push({ check: "field", element: describe(e), detail: `set at ${px}px, under ${floors.fieldFontPx}px, so Safari on iOS zooms on focus` });
+    const box = e.getBoundingClientRect();
+    const height = Math.round(box.height);
+    if (box.width > 1 && height > 1 && height < fieldHeightPx) out.push({ check: "field", element: describe(e), detail: `${height}px tall, under ${fieldHeightPx}px (use min-h-12)` });
   }
   for (const e of on("text") ? Array.from(document.body.querySelectorAll("*")) : []) {
     if (!shown(e) || quiet(e) || ["SCRIPT", "STYLE", "NOSCRIPT", "TEMPLATE"].includes(e.tagName)) continue;
@@ -419,17 +432,26 @@ function measureViewportInPage(arg) {
 }
 
 // src/phone/judge.ts
+var hasReason = (entry) => typeof entry.reason === "string" && entry.reason.trim() !== "";
+function parseBaseline(raw, where) {
+  const b = raw ?? {};
+  const entries = [...b.static ?? [], ...b.measured ?? []];
+  const bad = entries.find((e) => e.reason !== void 0 && typeof e.reason !== "string");
+  if (bad) throw new Error(`${where}: an entry has a "reason" that is not text: ${JSON.stringify(bad)}`);
+  return { ...b.note ? { note: b.note } : {}, static: b.static ?? [], measured: b.measured ?? [] };
+}
 var EMPTY_BASELINE = { static: [], measured: [] };
 var MEDIA = /@(?:custom-)?media\b([^{;]*)/g;
 var CAPS_WIDTH = /\bmax-(?:device-)?width\s*:|\bwidth\s*<|>=?\s*(?:device-)?width\b/i;
 var VARIANT = /(?<![\w@-])max-(\[[^\]\s]+\]|[a-z0-9]+):/g;
 var NOT_VARIANTS = /* @__PURE__ */ new Set(["width", "height", "lines", "resolution", "zoom", "inline-size", "block-size"]);
 var OK = /mobile-first-ok\b:?(.*)/;
+var VAR_OPACITY = /[^\s"'`]*var\([^)]*\)\]\/[0-9]+/g;
 function reasonOf(line) {
   const m = line?.match(OK);
   return m ? m[1].replace(/\*\/|-->|[{}]/g, "").trim() : null;
 }
-function scanPhoneFirst(files, exceptions = []) {
+function scanPhoneFirst(files, exceptions = [], options = {}) {
   const excusedFiles = new Set(exceptions.filter((e) => e.reason?.trim()).map((e) => e.file));
   const findings = [];
   let excused = 0;
@@ -444,7 +466,18 @@ function scanPhoneFirst(files, exceptions = []) {
     for (const m of text.matchAll(VARIANT)) {
       if (!NOT_VARIANTS.has(m[1])) found.push({ line: lineOf(m.index), what: m[0] });
     }
-    for (const { line, what } of found.sort((a, b) => a.line - b.line)) {
+    const silent = /* @__PURE__ */ new Set();
+    if (options.tailwind3?.(path)) {
+      for (const m of text.matchAll(VAR_OPACITY)) {
+        silent.add(found.push({ line: lineOf(m.index), what: `${m[0]} (Tailwind 3 emits no CSS for opacity on a var() colour)` }) - 1);
+      }
+    }
+    const order = found.map((f, i) => ({ ...f, silent: silent.has(i) })).sort((a, b) => a.line - b.line);
+    for (const { line, what, silent: cannotExcuse } of order) {
+      if (cannotExcuse) {
+        findings.push({ file: path, line, what });
+        continue;
+      }
       const here = reasonOf(lines[line - 1]);
       const above = reasonOf(lines[line - 2]);
       if (here || above) {
@@ -549,17 +582,101 @@ var LABEL = {
   tel: "phone number is not a link",
   linelength: "line too long"
 };
-function writeBaseline(findings, routes, note) {
+function writeBaseline(findings, routes, note, previous) {
   const byFile = tally(findings, (f) => f.file);
   const measured = routes.flatMap(
     ({ route, findings: findings2 }) => [...tally(findings2, (f) => measuredKey(route, f.check, normaliseElement(f.element))).values()].map(({ item, count }) => ({ route, check: item.check, element: normaliseElement(item.element), count }))
   );
+  const staticReasons = new Map((previous?.static ?? []).filter(hasReason).map((b) => [b.file, b.reason]));
+  const measuredReasons = new Map((previous?.measured ?? []).filter(hasReason).map((b) => [measuredKey(b.route, b.check, b.element), b.reason]));
   return {
     ...note ? { note } : {},
-    static: [...byFile.values()].map(({ item, count }) => ({ file: item.file, count, found: findings.filter((f) => f.file === item.file).map((f) => f.what) })).sort((a, b) => a.file.localeCompare(b.file)),
-    measured: measured.sort((a, b) => a.route.localeCompare(b.route) || a.check.localeCompare(b.check) || a.element.localeCompare(b.element))
+    static: [...byFile.values()].map(({ item, count }) => ({ file: item.file, count, found: findings.filter((f) => f.file === item.file).map((f) => f.what), ...staticReasons.has(item.file) ? { reason: staticReasons.get(item.file) } : {} })).sort((a, b) => a.file.localeCompare(b.file)),
+    measured: measured.map((m) => measuredReasons.has(measuredKey(m.route, m.check, m.element)) ? { ...m, reason: measuredReasons.get(measuredKey(m.route, m.check, m.element)) } : m).sort((a, b) => a.route.localeCompare(b.route) || a.check.localeCompare(b.check) || a.element.localeCompare(b.element))
   };
 }
+function judgeGrowth(current, base, baseName = "main") {
+  const out = [];
+  const baseStatic = new Map(base.static.map((b) => [b.file, b.count]));
+  for (const b of current.static) {
+    const was = baseStatic.get(b.file) ?? 0;
+    if (b.count > was && !hasReason(b)) out.push(`${b.file}: ${was ? `${b.count} desktop-first rules, ${baseName} allows ${was}` : `${b.count} desktop-first rule${b.count === 1 ? "" : "s"} added to the baseline`}`);
+  }
+  const baseMeasured = new Map(base.measured.map((b) => [measuredKey(b.route, b.check, b.element), b.count]));
+  for (const b of current.measured) {
+    const was = baseMeasured.get(measuredKey(b.route, b.check, b.element)) ?? 0;
+    if (b.count > was && !hasReason(b)) out.push(`${b.route}: ${LABEL[b.check]} ${b.element}: ${was ? `${b.count} in the baseline, ${baseName} allows ${was}` : `added to the baseline (${b.count})`}`);
+  }
+  return out;
+}
+var hasUnexcusedEntries = (b) => [...b.static, ...b.measured].some((e) => !hasReason(e));
+var PAGE_FILE = /(?:^|\/)page\.(?:tsx|ts|jsx|js|mdx)$/;
+var INTERCEPTING = /^\(\.{1,3}\)/;
+function routesFromPages(files) {
+  const routes = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    const rel = file.replace(/\\/g, "/");
+    if (!PAGE_FILE.test(rel)) continue;
+    const dirs = rel.split("/").slice(0, -1);
+    if (dirs.some((d) => INTERCEPTING.test(d) || d.startsWith("_"))) continue;
+    const url = dirs.filter((d) => !/^\(.*\)$/.test(d) && !d.startsWith("@"));
+    routes.add(`/${url.join("/")}`);
+  }
+  return [...routes].sort();
+}
+function routesFromManifest(manifest) {
+  const routes = /* @__PURE__ */ new Set();
+  for (const [key, route] of Object.entries(manifest ?? {})) {
+    if (!/(?:^|\/)page$/.test(key) || typeof route !== "string") continue;
+    if (route.split("/").some((d) => d.startsWith("_"))) continue;
+    routes.add(route);
+  }
+  return [...routes].sort();
+}
+var segmentsOf = (route) => route.split("/").filter(Boolean);
+var rank = (seg) => seg.startsWith("[[...") ? 3 : seg.startsWith("[...") ? 2 : seg.startsWith("[") ? 1 : 0;
+var cleanRoute = (route) => {
+  const path = route.replace(/[?#].*$/, "").replace(/\/+$/, "");
+  return path === "" ? "/" : path;
+};
+function routeMatches(pattern, route) {
+  if (pattern === route) return true;
+  const want = segmentsOf(pattern);
+  const have = segmentsOf(route);
+  for (let i = 0; i < want.length; i++) {
+    const seg = want[i];
+    if (seg.startsWith("[[...")) return true;
+    if (seg.startsWith("[...")) return have.length > i;
+    if (have[i] === void 0) return false;
+    if (!seg.startsWith("[") && seg !== have[i]) return false;
+  }
+  return want.length === have.length;
+}
+var moreSpecific = (a, b) => {
+  const x = segmentsOf(a).map(rank);
+  const y = segmentsOf(b).map(rank);
+  for (let i = 0; i < Math.min(x.length, y.length); i++) if (x[i] !== y[i]) return x[i] < y[i];
+  return x.length > y.length;
+};
+var excludes = (entry, page) => entry.endsWith("/*") ? page === entry.slice(0, -2) || page.startsWith(entry.slice(0, -1)) : entry === page;
+function judgeRoutes(pages, measuredRoutes, excluded = []) {
+  const problems = [];
+  excluded.forEach((e, i) => {
+    const at = `excludeRoutes[${i}]`;
+    const x = e;
+    if (typeof x?.route !== "string" || !x.route.startsWith("/")) problems.push(`${at}: names no route (start it with /)`);
+    else if (typeof x.reason !== "string" || !x.reason.trim()) problems.push(`${at} (${x.route}): no reason. Say why the gate cannot measure this page, or remove the entry.`);
+    else if (!pages.some((p) => excludes(x.route, p))) problems.push(`${at}: ${x.route} is not a page route of the app. Remove the entry.`);
+  });
+  const named = excluded.filter((e) => typeof e?.route === "string" && typeof e.reason === "string" && e.reason.trim());
+  const covered = /* @__PURE__ */ new Set();
+  for (const route of measuredRoutes.map(cleanRoute)) {
+    const hit = pages.filter((p) => routeMatches(p, route)).sort((a, b) => moreSpecific(a, b) ? -1 : moreSpecific(b, a) ? 1 : 0)[0];
+    if (hit) covered.add(hit);
+  }
+  for (const page of pages) if (named.some((e) => excludes(e.route, page))) covered.add(page);
+  return { missing: pages.filter((p) => !covered.has(p)), problems, covered: covered.size };
+}
 
 // src/phone/viewports.ts
 var BANDS = [
@@ -603,16 +720,16 @@ var DEFAULT_THRESHOLDS = {
 var mainActionFor = (config, route) => typeof config === "string" ? config : config ? config[route] ?? config["*"] : void 0;
 function formatWidths(failing, tested) {
   const plain = tested.filter((n) => /^\d+$/.test(n)).sort((a, b) => Number(a) - Number(b));
-  const rank = new Map(plain.map((name, i) => [name, i]));
+  const rank2 = new Map(plain.map((name, i) => [name, i]));
   const names = [...new Set(failing)];
   const runs = [];
-  for (const name of names.filter((n) => rank.has(n)).sort((a, b) => rank.get(a) - rank.get(b))) {
+  for (const name of names.filter((n) => rank2.has(n)).sort((a, b) => rank2.get(a) - rank2.get(b))) {
     const last = runs.at(-1);
-    if (last && rank.get(name) === rank.get(last.at(-1)) + 1) last.push(name);
+    if (last && rank2.get(name) === rank2.get(last.at(-1)) + 1) last.push(name);
     else runs.push([name]);
   }
   const out = runs.map((r) => r.length > 1 ? `${r[0]}-${r.at(-1)}` : r[0]);
-  return [...out, ...names.filter((n) => !rank.has(n))].join(", ");
+  return [...out, ...names.filter((n) => !rank2.has(n))].join(", ");
 }
 var keyOf = (f) => `${f.check}\0${f.element.replace(/("[^]*)$/, (t) => t.replace(/\d+/g, "#"))}`;
 function mergeViewportFindings(perViewport, tested) {
@@ -777,7 +894,7 @@ async function measureSite(browser, options) {
 async function measurePhone(page, options) {
   if (!options.route.startsWith("/")) throw new Error(`measurePhone: route "${options.route}" should start with /`);
   await page.evaluate(() => document.fonts?.ready.then(() => void 0), void 0);
-  const findings = await page.evaluate(measurePhoneInPage, PHONE_FLOORS);
+  const findings = await page.evaluate(measurePhoneInPage, { ...PHONE_FLOORS, ...options.floors ?? {} });
   const viewport = page.viewportSize?.() ?? void 0;
   const result = { route: options.route, ...viewport ? { viewport } : {}, findings };
   const dir = options.out ?? DEFAULT_MEASURED_DIR;
@@ -801,8 +918,13 @@ async function measurePhone(page, options) {
   WIDE_WIDTHS,
   bandOf,
   checkExceptions,
+  cleanRoute,
   formatWidths,
+  hasReason,
+  hasUnexcusedEntries,
+  judgeGrowth,
   judgeMeasured,
+  judgeRoutes,
   judgeStatic,
   mainActionFor,
   measurePhone,
@@ -813,8 +935,12 @@ async function measurePhone(page, options) {
   measureViewports,
   mergeViewportFindings,
   normaliseElement,
+  parseBaseline,
   reasonOf,
   routeFile,
+  routeMatches,
+  routesFromManifest,
+  routesFromPages,
   scanPhoneFirst,
   sweepWidths,
   writeBaseline

package/dist/phone.d.cts

@@ -1,9 +1,3 @@
-interface SourceFile {
-    /** Repo-relative path. The extension decides how the file is read. */
-    path: string;
-    text: string;
-}
-
 /**
  * The in-page half of the phone-first gate.
  *
@@ -23,6 +17,12 @@ interface PhoneFloors {
     targetPx: number;
     fieldFontPx: number;
     textPx: number;
+    /**
+     * The height of a text field, select or textarea (portal standard rule 5:
+     * 48px inputs). Left out, 48. Below `targetPx` the field also fails the
+     * target check; this floor is what catches 44 to 47px.
+     */
+    fieldHeightPx?: number;
 }
 /**
  * What a measure can find. The first five are the 375px floors (DOM-775); the
@@ -44,6 +44,12 @@ declare function measurePhoneInPage(floors: PhoneFloors & {
     only?: PhoneCheck[];
 }): RawPhoneFinding[];
 
+interface SourceFile {
+    /** Repo-relative path. The extension decides how the file is read. */
+    path: string;
+    text: string;
+}
+
 /**
  * The judging half of the phone-first gate: pure text work, tested without a
  * browser or a disk.
@@ -62,6 +68,11 @@ declare function measurePhoneInPage(floors: PhoneFloors & {
  * the day it goes in while the existing ones stay listed in the open. The
  * baseline only shrinks: a count higher than what is found fails as well
  * ("lower the baseline"), so a fix cannot leave room for the next breach.
+ *
+ * Shrinking is also enforced against the base branch (DOM-1053): a baseline
+ * entry, or a higher count, that main's copy does not have fails, unless the
+ * entry carries a `reason` (a named exception: third-party UI, a
+ * destructive-only form).
  */
 
 interface StaticFinding {
@@ -86,18 +97,30 @@ interface MeasuredRoute {
 interface Baseline {
     /** Why the baseline exists and which issue burns it down. Free text, for a person. */
     note?: string;
+    /**
+     * `reason` makes an entry a named exception: it may be added, or raised,
+     * after the baseline went in. Absent on the faults that were there first.
+     */
     static: {
         file: string;
         count: number;
         found?: string[];
+        reason?: string;
     }[];
     measured: {
         route: string;
         check: PhoneCheck;
         element: string;
         count: number;
+        reason?: string;
     }[];
 }
+/** An entry is a named exception when its `reason` says something. */
+declare const hasReason: (entry: {
+    reason?: unknown;
+}) => boolean;
+/** A baseline file, read. Old files (no `reason`, no `note`) read as before; a `reason` that is not text is an error. */
+declare function parseBaseline(raw: unknown, where: string): Baseline;
 declare const EMPTY_BASELINE: Baseline;
 /** The reason in a `mobile-first-ok: <reason>` comment, "" for the marker with no reason, null for none. */
 declare function reasonOf(line: string | undefined): string | null;
@@ -106,7 +129,10 @@ declare function reasonOf(line: string | undefined): string | null;
  * `mobile-first-ok: <reason>` on the line or the line above, or the whole file
  * in `exceptions` with a reason. A marker with no reason is itself a finding.
  */
-declare function scanPhoneFirst(files: SourceFile[], exceptions?: FileException[]): {
+declare function scanPhoneFirst(files: SourceFile[], exceptions?: FileException[], options?: {
+    /** True for a file in an app whose tailwindcss is v3: it is also scanned for `/NN` opacity on a `var()` colour. */
+    tailwind3?: (path: string) => boolean;
+}): {
     findings: StaticFinding[];
     excused: number;
 };
@@ -128,7 +154,48 @@ interface Judgement {
 declare function judgeStatic(findings: StaticFinding[], baseline: Baseline): Judgement;
 declare function judgeMeasured(routes: MeasuredRoute[], baseline: Baseline): Judgement;
 /** The baseline that makes this run pass: what is there now, counted. */
-declare function writeBaseline(findings: StaticFinding[], routes: MeasuredRoute[], note?: string): Baseline;
+declare function writeBaseline(findings: StaticFinding[], routes: MeasuredRoute[], note?: string, previous?: Baseline): Baseline;
+/**
+ * Entries the baseline holds that the base branch's copy does not, or holds
+ * at a lower count, and that name no reason. The baseline lists the faults
+ * that were there when the gate arrived; a new breach is fixed where it is.
+ * An entry with a `reason` is a named exception and may be added or raised.
+ */
+declare function judgeGrowth(current: Baseline, base: Baseline, baseName?: string): string[];
+/** Whether the baseline holds anything a reason does not name: only then is the base branch's copy needed. */
+declare const hasUnexcusedEntries: (b: Baseline) => boolean;
+/**
+ * Page routes from the page files of a Next app directory, as paths relative
+ * to it (`portal/(shell)/invoices/[id]/page.tsx`). Route groups `(x)`, parallel
+ * slots `@x` and private folders `_x` are not part of the URL; an intercepting
+ * route `(.)x` is a second way into a page, not a page of its own.
+ */
+declare function routesFromPages(files: string[]): string[];
+/** Page routes from Next's `app-path-routes-manifest.json` (`{ "/portal/page": "/portal" }`). Route handlers and internal `_` routes are not pages. */
+declare function routesFromManifest(manifest: unknown): string[];
+interface ExcludedRoute {
+    route: string;
+    reason: string;
+}
+/** A route as the gate names it: no query, no hash, no trailing slash. */
+declare const cleanRoute: (route: string) => string;
+/** Whether a measured route (`/portal/projects/p1`, or the pattern itself) is a page route (`/portal/projects/[id]`). */
+declare function routeMatches(pattern: string, route: string): boolean;
+interface RouteJudgement {
+    /** Page routes nothing measured and no exclusion covers: the gate fails on these. */
+    missing: string[];
+    /** Problems with `excludeRoutes` itself: no reason, or names no page. */
+    problems: string[];
+    /** Pages measured or excluded with a reason. */
+    covered: number;
+}
+/**
+ * Every page route of the app is in the gate's route list. A measured route
+ * counts for the most specific page it matches, so `/portal/projects/new` does
+ * not cover `/portal/projects/[id]`. A page that only redirects measures
+ * nothing: it is excluded with that reason.
+ */
+declare function judgeRoutes(pages: string[], measuredRoutes: string[], excluded?: ExcludedRoute[]): RouteJudgement;
 
 /**
  * What "every viewport" means (STANDARD.md section 10, DOM-787): the ladder
@@ -263,8 +330,13 @@ declare const PHONE: {
     readonly isMobile: true;
     readonly hasTouch: true;
 };
-/** The house floors at phone width. Not per-repo settings. */
-declare const PHONE_FLOORS: PhoneFloors;
+/**
+ * The house floors at phone width. A site may raise `textPx`, or lower
+ * `fieldHeightPx` with a reason; they are not per-repo taste. The field height
+ * is portal standard rule 5 (48px inputs); until DOM-1053 the gate held fields
+ * to the 44px target floor only.
+ */
+declare const PHONE_FLOORS: Required<PhoneFloors>;
 /** Where `measurePhone` writes and `craft phone-first --measured` reads, unless told otherwise. */
 declare const DEFAULT_MEASURED_DIR = "phone-first/measured";
 /** A route as a file name: `/portal/invoices` is `portal-invoices.json`, `/` is `home.json`. */
@@ -309,7 +381,7 @@ interface MeasureViewportsOptions {
     scope?: "all" | "phone" | "wide";
     /** Override house thresholds. */
     thresholds?: Partial<Thresholds>;
-    /** Override the 12 / 16 / 44px floors. The defaults are the house standard; a site may set `textPx` higher. */
+    /** Override the 12 / 16 / 44px floors and the 48px field height (`fieldHeightPx`). The defaults are the house standard; a site may set `textPx` higher. */
     floors?: Partial<PhoneFloors>;
     /** The main action's selector: one for all routes, or per route with `*` as the fallback. Absent: not checked. */
     mainAction?: MainAction;
@@ -440,6 +512,8 @@ interface MeasurePhoneOptions {
     route: string;
     /** The folder to write `<route>.json` into. Default `phone-first/measured`, from the working directory. */
     out?: string;
+    /** Override the 12 / 16 / 44 / 48px floors (text, field text, target, field height). The defaults are the house standard. */
+    floors?: Partial<PhoneFloors>;
 }
 /**
  * Measure the page as it is now and write the result for `craft phone-first`.
@@ -448,4 +522,4 @@ interface MeasurePhoneOptions {
  */
 declare function measurePhone(page: MinimalPage, options: MeasurePhoneOptions): Promise<MeasuredRoute>;
 
-export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, DESKTOP, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, type OpenedPage, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureRoute, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };
+export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, DESKTOP, EMPTY_BASELINE, type ExcludedRoute, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, type OpenedPage, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, type RouteJudgement, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, cleanRoute, formatWidths, hasReason, hasUnexcusedEntries, judgeGrowth, judgeMeasured, judgeRoutes, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureRoute, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, parseBaseline, reasonOf, routeFile, routeMatches, routesFromManifest, routesFromPages, scanPhoneFirst, sweepWidths, writeBaseline };