@domandigital/craft 0.15.0 → 0.16.0

package/dist/cli-CWORJYOU.js

@@ -0,0 +1,190 @@
+import {
+  characterReport
+} from "./chunk-NTIPJ5U7.js";
+import {
+  merge
+} from "./chunk-TQKDCA4V.js";
+import "./chunk-YK2FFL6Z.js";
+import "./chunk-JYNXGCYZ.js";
+import {
+  SIBLING_AT,
+  compareToEstate,
+  loadEstate
+} from "./chunk-CVG5GSMN.js";
+import {
+  PAGE_TYPES,
+  validateDirection
+} from "./chunk-WAV6AKR4.js";
+import {
+  loadNull
+} from "./chunk-LWVGIJ5A.js";
+import "./chunk-OQXTQQAU.js";
+import {
+  COPY_FILE,
+  NOT_COPY_DIR,
+  SOURCE_FILE,
+  applySeverity,
+  loadConfig,
+  loadExceptions,
+  parseFlags,
+  readPaths,
+  toJson
+} from "./chunk-LXDNIJFG.js";
+import {
+  readSnapshot
+} from "./chunk-WUACK2HX.js";
+import {
+  CATALOGUE,
+  auditSnapshot,
+  checkCopy,
+  fingerprint,
+  scanSource,
+  typicality
+} from "./chunk-B2MJLGF6.js";
+import "./chunk-QYBAVU3P.js";
+
+// src/report/cli.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { dirname, resolve } from "path";
+
+// src/report/retrofit.ts
+var HEADINGS = {
+  direction: "Decide first",
+  type: "Type",
+  colour: "Colour",
+  shape: "Shape",
+  effects: "Effects",
+  motion: "Motion",
+  layout: "How sections look (not where they sit)",
+  copy: "Copy"
+};
+var ORDER = ["direction", "type", "colour", "shape", "effects", "motion", "layout", "copy"];
+function target(a, direction) {
+  if (!a.choice || a.area === "direction") return "";
+  const c = direction?.choices?.[a.choice];
+  if (c && c.because && !c.because.startsWith("PROPOSED:")) return `
+  - Use: **${c.value}** for ${a.choice}. ${c.because}`;
+  return `
+  - Waits on: deciding **${a.choice}** in art-direction.json.`;
+}
+function retrofitPlan(report, direction) {
+  const lines = [
+    `# Retrofit: ${report.site}`,
+    "",
+    `**Now:** ${report.verdict}. ${report.summary}`,
+    "",
+    "| Signal | Raised | Reading |",
+    "|---|---|---|",
+    ...report.signals.map((s) => `| ${s.id} | ${s.raised === null ? "not measured" : s.raised ? "yes" : "no"} | ${s.detail} |`),
+    "",
+    "**Done when** `craft report` says *decided*: fewer than three design tells, typicality under 0.10 against this brief's null, no sibling in the estate, and at least five of the seven choices decided with a reason.",
+    ""
+  ];
+  let n = 0;
+  for (const area of ORDER) {
+    const list = report.actions.filter((a) => a.area === area);
+    if (list.length === 0) continue;
+    n += 1;
+    lines.push(`## ${n}. ${HEADINGS[area]}`, "");
+    for (const a of list) lines.push(`- [ ] ${a.what} *(${a.why})*${target(a, direction)}`);
+    lines.push("");
+  }
+  if (n === 0) lines.push("Nothing to change.", "");
+  lines.push(
+    "## Leave alone",
+    "",
+    "Navigation, the order of the sections, where the call to action sits, reading order and legibility. Change the look, never the page grammar. A layout tell above is about how a section looks: the icon tiles, the chip, the strip. The section stays where it is.",
+    ""
+  );
+  return lines.join("\n");
+}
+
+// src/report/cli.ts
+var USAGE = "usage: craft report|retrofit <url | snapshot.json> [--repo <dir>] [--null <dir>] [--estate <estate.json>] [--direction <file>] [--json] [--out <file>]";
+var sameUrl = (a, b) => a.replace(/\/+$/, "").toLowerCase() === b.replace(/\/+$/, "").toLowerCase();
+function formatCharacter(r) {
+  const lines = [`craft report ${r.site}`, "", `Verdict: ${r.verdict.toUpperCase()}. ${r.summary}`, ""];
+  for (const s of r.signals) lines.push(`  ${s.id.padEnd(11)} ${s.raised === null ? "\xB7" : s.raised ? "RAISED" : "ok"}  ${s.detail}`);
+  lines.push("", "What to do, in order:");
+  r.actions.slice(0, 12).forEach((a, i) => lines.push(`  ${String(i + 1).padStart(2)}. [${a.area}] ${a.what}`, `      ${a.why}`));
+  if (r.actions.length > 12) lines.push(`  ...and ${r.actions.length - 12} more: craft retrofit writes them all.`);
+  return lines.join("\n");
+}
+async function runReport(command, args, io) {
+  try {
+    const flags = parseFlags(args);
+    if (typeof flags === "string") throw new Error(flags);
+    const target2 = flags.positional[0];
+    if (!target2) throw new Error(USAGE);
+    const page = flags.page ?? "home";
+    if (!PAGE_TYPES.includes(page)) throw new Error(`--page takes one of ${PAGE_TYPES.join(", ")}`);
+    const local = resolve(io.cwd, target2);
+    let snap;
+    if (/\.json$/i.test(target2) && existsSync(local)) {
+      snap = readSnapshot(JSON.parse(readFileSync(local, "utf8")), target2);
+    } else {
+      const { snapshotUrl } = await import("./audit-UJCUWORL.js");
+      snap = await snapshotUrl(target2);
+    }
+    const fp = fingerprint(snap);
+    const repo = flags.repo ? resolve(io.cwd, flags.repo) : null;
+    const exceptions = loadExceptions(flags, repo ?? io.cwd);
+    const config = loadConfig(flags, repo ?? io.cwd);
+    let findings = auditSnapshot(snap, { exceptions });
+    if (repo) {
+      findings = merge(scanSource(readPaths(["."], repo, SOURCE_FILE, void 0, config.ignore), { exceptions }), findings);
+      const copyPaths = config.copyPaths ?? ["."];
+      findings = merge(findings, checkCopy(readPaths(copyPaths, repo, COPY_FILE, (d) => NOT_COPY_DIR(d) || d === "docs", config.ignore), { exceptions }));
+    }
+    findings = applySeverity(findings, config);
+    const nulls = flags.null ? flags.null.split(",").map((p) => loadNull(p.trim(), io.cwd)) : [];
+    const typical = nulls.length ? typicality(fp, nulls.flatMap((m, i) => m.runs.map((r) => nulls.length > 1 ? { ...r, id: `${i + 1}/${r.id}` } : r))) : null;
+    let estate = null;
+    if (flags.estate) {
+      const register = loadEstate(resolve(io.cwd, flags.estate));
+      const self = register.sites.find((s) => sameUrl(s.url, snap.url));
+      estate = compareToEstate(fp, register, { exclude: self?.id, siblingAt: SIBLING_AT });
+    }
+    const directionFile = resolve(repo ?? io.cwd, flags.direction ?? "art-direction.json");
+    let direction = null;
+    let directionReport = null;
+    if (existsSync(directionFile)) {
+      direction = JSON.parse(readFileSync(directionFile, "utf8"));
+      directionReport = validateDirection(direction, {
+        fingerprint: fp,
+        snapshot: snap,
+        page,
+        strict: flags.strict,
+        pathExists: (p) => existsSync(resolve(dirname(directionFile), p)),
+        readSource: (s) => {
+          if (!s.path || /^https?:/.test(s.path) || !/\.(?:txt|md|markdown|csv|json|html?)$/i.test(s.path)) return void 0;
+          const path = resolve(dirname(directionFile), s.path);
+          return existsSync(path) ? readFileSync(path, "utf8") : void 0;
+        }
+      });
+    } else if (flags.direction) {
+      throw new Error(`no such file: ${flags.direction}`);
+    }
+    const copyTells = new Set(CATALOGUE.filter((t) => t.surface === "copy").map((t) => t.id));
+    const report = characterReport({ site: snap.url, findings, typicality: typical, estate, direction: directionReport }, copyTells);
+    if (command === "retrofit") {
+      const plan = retrofitPlan(report, direction);
+      if (flags.out) {
+        writeFileSync(resolve(io.cwd, flags.out), plan);
+        io.out(`craft retrofit: ${report.actions.length} step${report.actions.length === 1 ? "" : "s"} for ${snap.url} in ${flags.out}`);
+      } else io.out(plan);
+      return 0;
+    }
+    io.out(flags.json ? toJson(report) : formatCharacter(report));
+    if (flags.out) writeFileSync(resolve(io.cwd, flags.out), `${toJson(report)}
+`);
+    return flags.strict && report.verdict !== "decided" ? 1 : 0;
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
+export {
+  formatCharacter,
+  runReport
+};

package/dist/{cli-7OZCYOQY.js → cli-K4LSRYBE.js}

@@ -7,11 +7,11 @@ import {
   PROPOSED,
   researchPrompt,
   validateDirection
-} from "./chunk-YDURAOYR.js";
+} from "./chunk-WAV6AKR4.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-MUVFECFC.js";
+} from "./chunk-LXDNIJFG.js";
 import {
   readSnapshot
 } from "./chunk-WUACK2HX.js";
@@ -24,7 +24,7 @@ import {
   isCream,
   oklchToRgb,
   parseColour
-} from "./chunk-LFNSB6W7.js";
+} from "./chunk-B2MJLGF6.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/direction/cli.ts
@@ -205,7 +205,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-MTUC24XU.js");
+    const { snapshotUrl } = await import("./audit-UJCUWORL.js");
     return snapshotUrl(target);
   }
   return readSnapshot(readJson(resolve(cwd, target)), target);

package/dist/{cli-22TSWAX6.js → cli-PEATEW57.js}

@@ -4,13 +4,13 @@ import {
   formatPairs,
   loadEstate,
   runEstate
-} from "./chunk-QU6Q2QZZ.js";
-import "./chunk-YDURAOYR.js";
-import "./chunk-RXXRXV3V.js";
+} from "./chunk-CVG5GSMN.js";
+import "./chunk-WAV6AKR4.js";
+import "./chunk-LWVGIJ5A.js";
 import "./chunk-OQXTQQAU.js";
-import "./chunk-MUVFECFC.js";
+import "./chunk-LXDNIJFG.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-LFNSB6W7.js";
+import "./chunk-B2MJLGF6.js";
 import "./chunk-QYBAVU3P.js";
 export {
   formatComponentPairs,

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-MUVFECFC.js";
-import "./chunk-LFNSB6W7.js";
+} from "./chunk-LXDNIJFG.js";
+import "./chunk-B2MJLGF6.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/cli.ts