@domandigital/craft 0.19.2 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.19.2",
+  "version": "0.20.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/dist/cli-RAH4CKYY.js

@@ -1,249 +0,0 @@
-import {
-  SOURCE_FILE,
-  readPaths
-} from "./chunk-D2PEKYKH.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";
-
-// 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(/\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 = count - allow > 1 ? ` (${count - allow} more than the baseline's ${allow})` : allow ? ` (the baseline allows ${allow})` : "";
-        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"
-};
-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))
-  };
-}
-
-// src/phone/cli.ts
-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 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 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("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
-};