@domandigital/craft 0.19.2 → 0.20.0

package/dist/cli-YHS2VPWQ.js

@@ -0,0 +1,122 @@
+import {
+  EMPTY_BASELINE,
+  checkExceptions,
+  judgeMeasured,
+  judgeStatic,
+  scanPhoneFirst,
+  writeBaseline
+} from "./chunk-IJUZ7RV4.js";
+import {
+  SOURCE_FILE,
+  readPaths
+} from "./chunk-LZVTN2KI.js";
+import {
+  toJson
+} from "./chunk-QIEDBL4J.js";
+import "./chunk-WK2WMWTH.js";
+import "./chunk-CZ7KT452.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
+};

package/dist/{cli-BZSJIUQH.js → cli-YUVATZD5.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-4LJFZH2I.js";
 import {
   parseFlags
-} from "./chunk-D2PEKYKH.js";
+} from "./chunk-LZVTN2KI.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-D2PEKYKH.js";
+} from "./chunk-LZVTN2KI.js";
 import "./chunk-QIEDBL4J.js";
 import "./chunk-WK2WMWTH.js";
 import "./chunk-CZ7KT452.js";