@domandigital/craft 0.20.5 → 0.22.0

package/dist/{viewports-cli-C4DWICYI.js → viewports-cli-F7KJIVZL.js}

@@ -1,17 +1,28 @@
 import {
+  DEFAULT_SWEEP,
+  DEFAULT_THRESHOLDS,
   EMPTY_BASELINE,
+  LADDER,
+  SHORT_PHONE,
+  checkScreenBudgets,
+  formatScreens,
   judgeMeasured,
+  mainActionFor,
+  mergeViewportFindings,
+  parseBaseline,
+  screenBudgetFor,
+  sweepWidths,
   writeBaseline
-} from "./chunk-IJUZ7RV4.js";
+} from "./chunk-XSKLVEI6.js";
 import {
   loadPlaywright
-} from "./chunk-YFS32BZ2.js";
+} from "./chunk-6DRBFDWT.js";
 import "./chunk-JYNXGCYZ.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
-import "./chunk-PFVSKIPM.js";
-import "./chunk-FBWBDBW4.js";
+import "./chunk-DE2ZAV4G.js";
+import "./chunk-ONA73THJ.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/phone/viewports-cli.ts
@@ -25,7 +36,7 @@ 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`;
 
@@ -36,6 +47,7 @@ import { join } from "path";
 // 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;
@@ -79,6 +91,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;
@@ -385,76 +400,6 @@ function measureViewportInPage(arg) {
   return out;
 }
 
-// src/phone/viewports.ts
-var LADDER = [
-  { name: "320", width: 320, height: 568, phone: true },
-  { name: "375", width: 375, height: 812, phone: true },
-  { name: "390", width: 390, height: 844, phone: true },
-  { name: "430", width: 430, height: 932, phone: true },
-  { name: "844x390", width: 844, height: 390, phone: true, landscape: true },
-  { name: "768", width: 768, height: 1024, phone: false },
-  { name: "1024", width: 1024, height: 768, phone: false },
-  { name: "1280", width: 1280, height: 800, phone: false },
-  { name: "1440", width: 1440, height: 900, phone: false },
-  { name: "1920", width: 1920, height: 1080, phone: false }
-];
-var SHORT_PHONE = { name: "375x667", width: 375, height: 667, phone: true };
-var DEFAULT_SWEEP = { from: 320, to: 1920, step: 16, wideStep: 32, wideFrom: 1024, height: 800 };
-function sweepWidths(sweep = DEFAULT_SWEEP) {
-  const out = [];
-  for (let w = sweep.from; w <= sweep.to; w += w < sweep.wideFrom ? sweep.step : sweep.wideStep) out.push(w);
-  if (out.at(-1) !== sweep.to) out.push(sweep.to);
-  return out;
-}
-var DEFAULT_THRESHOLDS = {
-  maxLayerShare: 0.25,
-  landscapeMaxLayerShare: 0.5,
-  oversizeRatio: 2.5,
-  upscaleRatio: 1,
-  maxLineCh: 80,
-  overlapShare: 0.4,
-  minImagePx: 32
-};
-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 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))) {
-    const last = runs.at(-1);
-    if (last && rank.get(name) === rank.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(", ");
-}
-var keyOf = (f) => `${f.check}\0${f.element.replace(/("[^]*)$/, (t) => t.replace(/\d+/g, "#"))}`;
-function mergeViewportFindings(perViewport, tested) {
-  const merged = /* @__PURE__ */ new Map();
-  for (const { viewport, findings } of perViewport) {
-    const counts = /* @__PURE__ */ new Map();
-    for (const f of findings) {
-      const k = keyOf(f);
-      const had = counts.get(k);
-      if (had) had.n++;
-      else counts.set(k, { first: f, n: 1 });
-    }
-    for (const [k, { first, n }] of counts) {
-      const had = merged.get(k);
-      if (had) {
-        had.at.push(viewport);
-        had.most = Math.max(had.most, n);
-      } else merged.set(k, { first, at: [viewport], most: n });
-    }
-  }
-  const out = [];
-  for (const { first, at, most } of merged.values()) {
-    for (let i = 0; i < most; i++) out.push({ ...first, detail: `${first.detail} (at ${formatWidths(at, tested)})` });
-  }
-  return out;
-}
-
 // src/phone/run.ts
 function plan(options) {
   const ladder = options.ladder ?? LADDER;
@@ -510,6 +455,7 @@ async function collect(page, options) {
   const mainAction = mainActionFor(options.mainAction, options.route);
   const perViewport = [];
   const tested = [];
+  let screens;
   for (const stop of plan(options)) {
     await page.setViewportSize({ width: stop.width, height: stop.height });
     await settle(page, stop.ladder ? 150 : 60);
@@ -518,20 +464,36 @@ async function collect(page, options) {
     const findings = [];
     if (stop.ladder) findings.push(...await page.evaluate(measurePhoneInPage, { ...floors, only: stop.touch ? ["target", "field", "text"] : ["text"] }));
     findings.push(...await page.evaluate(measureViewportInPage, { groups: stop.groups, thresholds, mainAction, metaViewport: stop.width < 768 }));
+    if (stop.name === SHORT_PHONE.name) {
+      const height = await page.evaluate(() => document.documentElement.scrollHeight, void 0);
+      screens = Math.round(height / stop.height * 10) / 10;
+      const budget = screenBudgetFor(options.screens, options.route);
+      if (budget !== void 0 && screens > budget) findings.push({ check: "screens", element: "<page>", detail: `${screens} phone screens to the footer at ${stop.width} x ${stop.height}, over the budget of ${budget} for ${options.route}` });
+    }
     perViewport.push({ viewport: stop.name, findings });
     tested.push(stop.name);
   }
-  return { perViewport, tested };
+  return { perViewport, tested, ...screens !== void 0 ? { screens } : {} };
+}
+function mergeCollected(collected) {
+  const screens = collected.find((c) => c.screens !== void 0)?.screens;
+  return { perViewport: collected.flatMap((c) => c.perViewport), tested: collected.flatMap((c) => c.tested), ...screens !== void 0 ? { screens } : {} };
 }
 function finish(route, collected, out) {
-  const result = { route, viewports: collected.tested, findings: mergeViewportFindings(collected.perViewport, collected.tested), perViewport: collected.perViewport };
+  const result = {
+    route,
+    viewports: collected.tested,
+    ...collected.screens !== void 0 ? { screens: collected.screens } : {},
+    findings: mergeViewportFindings(collected.perViewport, collected.tested),
+    perViewport: collected.perViewport
+  };
   if (out !== false) writeMeasured(result, out ?? DEFAULT_MEASURED_DIR);
   return result;
 }
 function writeMeasured(result, dir) {
   mkdirSync(dir, { recursive: true });
-  const { route, viewport, viewports, findings } = result;
-  writeFileSync(join(dir, routeFile(route)), `${JSON.stringify({ route, ...viewport ? { viewport } : {}, ...viewports ? { viewports } : {}, findings }, null, 1)}
+  const { route, viewport, viewports, screens, findings } = result;
+  writeFileSync(join(dir, routeFile(route)), `${JSON.stringify({ route, ...viewport ? { viewport } : {}, ...viewports ? { viewports } : {}, ...screens !== void 0 ? { screens } : {}, findings }, null, 1)}
 `);
 }
 var DESKTOP = { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 };
@@ -562,7 +524,7 @@ async function measureSite(browser, options) {
       result.errors.push({ route, error: failed });
       continue;
     }
-    result.routes.push(finish(route, { perViewport: collected.flatMap((c) => c.perViewport), tested: collected.flatMap((c) => c.tested) }, options.out));
+    result.routes.push(finish(route, mergeCollected(collected), options.out));
   }
   return result;
 }
@@ -596,8 +558,7 @@ function loadConfig(path, cwd) {
 }
 function loadBaseline(path) {
   if (!existsSync(path)) return EMPTY_BASELINE;
-  const b = JSON.parse(readFileSync(path, "utf8"));
-  return { ...b.note ? { note: b.note } : {}, static: b.static ?? [], measured: b.measured ?? [] };
+  return parseBaseline(JSON.parse(readFileSync(path, "utf8")), path);
 }
 async function runViewports(args, io) {
   const flags = parse(args);
@@ -629,6 +590,7 @@ ${USAGE}`);
         ...config.mainAction ? { mainAction: config.mainAction } : {},
         ...config.thresholds ? { thresholds: config.thresholds } : {},
         ...config.floors ? { floors: config.floors } : {},
+        ...config.screens ? { screens: checkScreenBudgets(config.screens, "viewports.json screens") } : {},
         sweep: flags.sweep ? config.sweep : false,
         ...captures ? {
           onViewport: async (page, viewport, route) => {
@@ -642,7 +604,7 @@ ${USAGE}`);
     const baseline = loadBaseline(baselinePath);
     const measuredRoutes = new Set(site.routes.map((r) => r.route));
     if (flags.update) {
-      const next = writeBaseline([], site.routes, baseline.note);
+      const next = writeBaseline([], site.routes, baseline.note, baseline);
       next.static = baseline.static;
       next.measured = [...baseline.measured.filter((m) => !measuredRoutes.has(m.route)), ...next.measured].sort((a, b) => a.route.localeCompare(b.route) || a.check.localeCompare(b.check) || a.element.localeCompare(b.element));
       writeFileSync2(baselinePath, `${JSON.stringify(next, null, 2)}
@@ -653,7 +615,7 @@ ${USAGE}`);
     const judged = judgeMeasured(site.routes, { ...baseline, measured: baseline.measured.filter((m) => measuredRoutes.has(m.route)) });
     const failed = site.errors.length + judged.fresh.length + judged.stale.length > 0;
     if (flags.json) {
-      io.out(toJson({ pass: !failed, routes: site.routes.map((r) => ({ route: r.route, viewports: r.viewports, findings: r.findings.length })), errors: site.errors, measured: judged }));
+      io.out(toJson({ pass: !failed, routes: site.routes.map((r) => ({ route: r.route, viewports: r.viewports, screens: r.screens ?? null, findings: r.findings.length })), errors: site.errors, measured: judged }));
       return failed ? 1 : 0;
     }
     const section = (title, lines) => lines.length ? `
@@ -661,13 +623,16 @@ ${title}
 ${lines.map((l) => `  ${l}`).join("\n")}` : "";
     const viewports = site.routes[0]?.viewports ?? [];
     const summary = `${site.routes.length} route${site.routes.length === 1 ? "" : "s"} at ${viewports.length} viewports${judged.known ? `, ${judged.known} known breach${judged.known === 1 ? "" : "es"} in the baseline` : ""}`;
+    const screens = formatScreens(site.routes, config.screens);
+    const screensLine = screens ? `
+  phone screens to the footer: ${screens}` : "";
     if (!failed) {
-      io.out(`craft viewports: pass. ${summary}.`);
+      io.out(`craft viewports: pass. ${summary}.${screensLine}`);
       return 0;
     }
     io.err(
       [
-        `craft viewports: fail. ${summary}.`,
+        `craft viewports: fail. ${summary}.${screensLine}`,
         section("Did not answer (not measured, so not passed):", site.errors.map((e) => `${e.route}: ${e.error}`)),
         section("Measured across the viewports, phone first:", judged.fresh),
         section("The baseline claims more than is there (good: lower it, so the fix stays fixed):", judged.stale)

package/package.json

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

package/word-lists.json

@@ -1,5 +1,5 @@
 {
-  "catalogueVersion": "2026.10.3",
+  "catalogueVersion": "2026.10.4",
   "lists": {
     "aiWords": [
       "tapestry",

package/dist/chunk-IJUZ7RV4.js

@@ -1,151 +0,0 @@
-// src/phone/judge.ts
-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:?(.*)/;
-function reasonOf(line) {
-  const m = line?.match(OK);
-  return m ? m[1].replace(/\*\/|-->|[{}]/g, "").trim() : null;
-}
-function scanPhoneFirst(files, exceptions = []) {
-  const excusedFiles = new Set(exceptions.filter((e) => e.reason?.trim()).map((e) => e.file));
-  const findings = [];
-  let excused = 0;
-  for (const { path, text } of files) {
-    if (excusedFiles.has(path)) continue;
-    const lines = text.split("\n");
-    const lineOf = (index) => text.slice(0, index).split("\n").length;
-    const found = [];
-    for (const m of text.matchAll(MEDIA)) {
-      if (CAPS_WIDTH.test(m[1])) found.push({ line: lineOf(m.index), what: `${m[0].slice(0, m[0].length - m[1].length)}${m[1].replace(/\s+/g, " ").trimEnd()}` });
-    }
-    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 here = reasonOf(lines[line - 1]);
-      const above = reasonOf(lines[line - 2]);
-      if (here || above) {
-        excused++;
-        continue;
-      }
-      findings.push({ file: path, line, what: here === "" || above === "" ? `${what} (mobile-first-ok with no reason)` : what });
-    }
-  }
-  return { findings, excused };
-}
-function checkExceptions(exceptions, exists) {
-  const problems = [];
-  exceptions.forEach((e, i) => {
-    const at = `exceptions[${i}]`;
-    const x = e;
-    if (typeof x?.file !== "string" || !x.file.trim()) problems.push(`${at}: names no file`);
-    else if (typeof x.reason !== "string" || !x.reason.trim()) problems.push(`${at} (${x.file}): no reason. Say why this file needs a max-width query, or remove the exception.`);
-    else if (!exists(x.file)) problems.push(`${at}: ${x.file} is not there. Remove the exception.`);
-  });
-  return problems;
-}
-var normaliseElement = (element) => element.replace(/("[^]*)$/, (text) => text.replace(/\d+/g, "#"));
-var tally = (items, key) => {
-  const m = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    const k = key(item);
-    const had = m.get(k);
-    if (had) had.count++;
-    else m.set(k, { item, count: 1 });
-  }
-  return m;
-};
-function judgeStatic(findings, baseline) {
-  const byFile = tally(findings, (f) => f.file);
-  const allowed = new Map(baseline.static.map((b) => [b.file, b.count]));
-  const fresh = [];
-  const stale = [];
-  let known = 0;
-  for (const [file, { count }] of byFile) {
-    const allow = allowed.get(file) ?? 0;
-    known += Math.min(count, allow);
-    if (count > allow) {
-      const here = findings.filter((f) => f.file === file);
-      const lead = allow ? `${file}: ${count} desktop-first rules, the baseline allows ${allow}. One of these is new:` : `${file}:`;
-      fresh.push(`${lead}
-${here.map((f) => `    line ${f.line}: ${f.what}`).join("\n")}`);
-    }
-  }
-  for (const { file, count } of baseline.static) {
-    const now = byFile.get(file)?.count ?? 0;
-    if (now < count) stale.push(`${file}: the baseline allows ${count}, there ${now === 1 ? "is" : "are"} ${now} now. Lower it to ${now}${now ? "" : " (remove the line)"}.`);
-  }
-  return { fresh, stale, known };
-}
-var measuredKey = (route, check, element) => `${route}\0${check}\0${element}`;
-function judgeMeasured(routes, baseline) {
-  const fresh = [];
-  const stale = [];
-  let known = 0;
-  const allowed = new Map(baseline.measured.map((b) => [measuredKey(b.route, b.check, b.element), b.count]));
-  const seen = /* @__PURE__ */ new Map();
-  const measured = new Set(routes.map((r) => r.route));
-  for (const { route, findings } of routes) {
-    const counted = tally(findings, (f) => measuredKey(route, f.check, normaliseElement(f.element)));
-    for (const [key, { item, count }] of counted) {
-      seen.set(key, count);
-      const allow = allowed.get(key) ?? 0;
-      known += Math.min(count, allow);
-      if (count > allow) {
-        const times = allow ? ` (${count} found, the baseline allows ${allow})` : count > 1 ? ` (${count} of them)` : "";
-        fresh.push(`${route}: ${LABEL[item.check]} ${item.element}: ${item.detail}${times}`);
-      }
-    }
-  }
-  const missing = /* @__PURE__ */ new Set();
-  for (const b of baseline.measured) {
-    const key = measuredKey(b.route, b.check, b.element);
-    if (!measured.has(b.route)) {
-      if (!missing.has(b.route)) stale.push(`${b.route}: in the baseline but not measured this run. Measure it, or remove its lines.`);
-      missing.add(b.route);
-      continue;
-    }
-    const now = seen.get(key) ?? 0;
-    if (now < b.count) stale.push(`${b.route}: ${LABEL[b.check]} ${b.element}: the baseline allows ${b.count}, ${now} found. Lower it to ${now}${now ? "" : " (remove the line)"}.`);
-  }
-  return { fresh, stale, known };
-}
-var LABEL = {
-  scroll: "scrolls sideways",
-  target: "small target",
-  field: "small field",
-  text: "small text",
-  title: "title cut off",
-  overlap: "text overlaps text",
-  action: "main action out of reach",
-  layers: "fixed layers cover too much",
-  landscape: "landscape screen eaten by fixed layers",
-  image: "image not sized for its place",
-  input: "wrong keyboard",
-  autocomplete: "field the phone cannot fill in",
-  tel: "phone number is not a link",
-  linelength: "line too long"
-};
-function writeBaseline(findings, routes, note) {
-  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 }))
-  );
-  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))
-  };
-}
-
-export {
-  EMPTY_BASELINE,
-  scanPhoneFirst,
-  checkExceptions,
-  judgeStatic,
-  judgeMeasured,
-  writeBaseline
-};

package/dist/cli-56H5IPWT.js

@@ -1,122 +0,0 @@
-import {
-  EMPTY_BASELINE,
-  checkExceptions,
-  judgeMeasured,
-  judgeStatic,
-  scanPhoneFirst,
-  writeBaseline
-} from "./chunk-IJUZ7RV4.js";
-import {
-  SOURCE_FILE,
-  readPaths
-} from "./chunk-TSO5W32N.js";
-import {
-  toJson
-} from "./chunk-QIEDBL4J.js";
-import "./chunk-PFVSKIPM.js";
-import "./chunk-FBWBDBW4.js";
-import "./chunk-QYBAVU3P.js";
-
-// src/phone/cli.ts
-import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
-import { join, resolve } from "path";
-var USAGE = "usage: craft phone-first [--config phone-first.json] [--measured <dir>] [--update-baseline] [--json]";
-function parse(args) {
-  const flags = { config: "phone-first.json", update: false, json: false };
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a === "--update-baseline") flags.update = true;
-    else if (a === "--json") flags.json = true;
-    else if (a === "--config" || a === "--measured") {
-      const v = args[++i];
-      if (!v || v.startsWith("--")) return `${a} needs a value`;
-      if (a === "--config") flags.config = v;
-      else flags.measured = v;
-    } else return `unknown argument ${a}`;
-  }
-  return flags;
-}
-function loadConfig(path) {
-  if (!existsSync(path)) throw new Error(`no ${path}. Write one: { "source": ["<dirs with styles and components>"], "baseline": "phone-first.baseline.json" }`);
-  const c = JSON.parse(readFileSync(path, "utf8"));
-  if (!Array.isArray(c.source) || c.source.length === 0 || c.source.some((s) => typeof s !== "string")) throw new Error(`${path}: "source" should list the folders to scan`);
-  if (c.ignore !== void 0 && (!Array.isArray(c.ignore) || c.ignore.some((s) => typeof s !== "string"))) throw new Error(`${path}: "ignore" should be a list of globs`);
-  if (c.exceptions !== void 0 && !Array.isArray(c.exceptions)) throw new Error(`${path}: "exceptions" should be a list of { "file", "reason" }`);
-  return { source: c.source, ignore: c.ignore ?? [], exceptions: c.exceptions ?? [], baseline: c.baseline ?? "phone-first.baseline.json" };
-}
-function loadBaseline(path) {
-  if (!existsSync(path)) return EMPTY_BASELINE;
-  const b = JSON.parse(readFileSync(path, "utf8"));
-  return { ...b.note ? { note: b.note } : {}, static: b.static ?? [], measured: b.measured ?? [] };
-}
-function loadMeasured(dir) {
-  if (!existsSync(dir)) throw new Error(`--measured ${dir}: no such folder. Run the portal's phone-first specs first; they write it.`);
-  const routes = readdirSync(dir).filter((f) => f.endsWith(".json")).sort().map((f) => JSON.parse(readFileSync(join(dir, f), "utf8")));
-  if (routes.length === 0) throw new Error(`--measured ${dir}: no measured routes in it. Did the phone-first specs run?`);
-  return routes;
-}
-function runPhoneFirst(args, io) {
-  const flags = parse(args);
-  if (typeof flags === "string") {
-    io.err(`craft phone-first: ${flags}
-${USAGE}`);
-    return 2;
-  }
-  try {
-    const config = loadConfig(resolve(io.cwd, flags.config));
-    const baselinePath = resolve(io.cwd, config.baseline);
-    const baseline = loadBaseline(baselinePath);
-    const exceptionProblems = checkExceptions(config.exceptions, (f) => existsSync(resolve(io.cwd, f)));
-    const sources = config.source.filter((s2) => existsSync(resolve(io.cwd, s2)));
-    const missing = config.source.filter((s2) => !sources.includes(s2));
-    if (missing.length) throw new Error(`${flags.config}: source ${missing.join(", ")} not found`);
-    const files = readPaths(sources, io.cwd, SOURCE_FILE, void 0, config.ignore);
-    const { findings, excused } = scanPhoneFirst(files, config.exceptions);
-    const routes = flags.measured ? loadMeasured(resolve(io.cwd, flags.measured)) : null;
-    if (flags.update) {
-      const next = writeBaseline(findings, routes ?? [], baseline.note);
-      if (!routes) next.measured = baseline.measured;
-      writeFileSync(baselinePath, `${JSON.stringify(next, null, 2)}
-`);
-      io.out(`craft phone-first: wrote ${config.baseline} (${next.static.reduce((n, s2) => n + s2.count, 0)} static, ${next.measured.reduce((n, m2) => n + m2.count, 0)} measured)`);
-      return exceptionProblems.length ? 1 : 0;
-    }
-    const s = judgeStatic(findings, baseline);
-    const m = routes ? judgeMeasured(routes, baseline) : { fresh: [], stale: [], known: 0 };
-    const failed = exceptionProblems.length + s.fresh.length + s.stale.length + m.fresh.length + m.stale.length > 0;
-    if (flags.json) {
-      io.out(toJson({ pass: !failed, files: files.length, excused, routes: routes?.map((r) => r.route) ?? null, exceptionProblems, static: s, measured: m }));
-      return failed ? 1 : 0;
-    }
-    const wide = routes?.some((r) => r.viewports) ?? false;
-    const section = (title, lines) => lines.length ? `
-${title}
-${lines.map((l) => `  ${l}`).join("\n")}` : "";
-    const known = s.known + m.known;
-    const summary = [
-      `${files.length} files${routes ? ` and ${routes.length} route${routes.length === 1 ? "" : "s"} at ${wide ? "every viewport" : "375px"}` : ""}`,
-      excused ? `${excused} recorded exception${excused === 1 ? "" : "s"}` : null,
-      known ? `${known} known breach${known === 1 ? "" : "es"} in ${config.baseline}` : null
-    ].filter(Boolean).join(", ");
-    if (!failed) {
-      io.out(`craft phone-first: pass. ${summary}.`);
-      return 0;
-    }
-    io.err(
-      [
-        `craft phone-first: fail. ${summary}.`,
-        section("The exceptions:", exceptionProblems),
-        section("Built desktop first (write the phone as the base styles and widen with min-width; a genuine exception takes `mobile-first-ok: <reason>` on its line):", s.fresh),
-        section(wide ? "Measured across the viewports, phone first:" : "Measured at 375px:", m.fresh),
-        section("The baseline claims more than is there (good: lower it, so the fix stays fixed):", [...s.stale, ...m.stale])
-      ].join("")
-    );
-    return 1;
-  } catch (error) {
-    io.err(`craft phone-first: ${error.message}`);
-    return 2;
-  }
-}
-export {
-  runPhoneFirst
-};