@domandigital/craft 0.20.2 → 0.20.3

package/dist/cli-YQEVPRL5.js

@@ -1,337 +0,0 @@
-import {
-  decodePng
-} from "./chunk-JYNXGCYZ.js";
-import {
-  DIRECTION_VERSION,
-  PAGE_TYPES,
-  PROPOSED,
-  researchPrompt,
-  validateDirection
-} from "./chunk-2OBDCIVW.js";
-import {
-  parseFlags
-} from "./chunk-JLLULDVW.js";
-import {
-  toJson
-} from "./chunk-QIEDBL4J.js";
-import {
-  readSnapshot
-} from "./chunk-WUACK2HX.js";
-import {
-  deltaEOk,
-  fingerprint,
-  formatHex,
-  hexToOklch,
-  isAiViolet,
-  isCream,
-  oklchToRgb,
-  parseColour
-} from "./chunk-JGWOA4LI.js";
-import "./chunk-7DQDF3VL.js";
-import "./chunk-QYBAVU3P.js";
-
-// src/direction/cli.ts
-import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join, resolve } from "path";
-
-// src/direction/init.ts
-var hex = (o) => {
-  const { r, g, b } = oklchToRgb(o);
-  const clamp = (n) => Math.min(1, Math.max(0, n));
-  return formatHex({ r: clamp(r), g: clamp(g), b: clamp(b) });
-};
-function initDirection(input) {
-  const fp = input.current;
-  const empty = (value) => ({ value, because: "", evidence: [] });
-  const choices = fp ? {
-    ...fp.accent ? { accent: empty(hex(fp.accent)) } : {},
-    ground: empty(hex(fp.ground)),
-    display: empty(fp.display.family),
-    body: empty(fp.body.family),
-    ...fp.roundness !== null ? { shape: empty(fp.roundness >= 0.45 ? "pill buttons" : fp.roundness <= 0.05 ? "square corners" : `corners at ${Math.round(fp.roundness * 100)}% of button height`) } : {}
-  } : {};
-  const part = () => ({ value: "", evidence: [] });
-  return {
-    $schema: "https://unpkg.com/@domandigital/craft/art-direction.schema.json",
-    version: DIRECTION_VERSION,
-    client: input.client ?? "",
-    brief: input.brief ?? "",
-    // Empty on purpose, like the reasons: the first validate lists the job and the structure as undecided.
-    job: {
-      statement: { verb: "", object: "", context: "" },
-      functional: part(),
-      emotional: part(),
-      social: part(),
-      consideration: { value: "low", because: "", evidence: [] },
-      objections: [],
-      language: [],
-      evidence: []
-    },
-    hierarchy: {
-      home: {
-        primaryAction: { value: "", positions: [], because: "" },
-        order: fp?.sections?.length ? fp.sections.map((s) => ({ role: s.role, because: "" })) : [],
-        lead: { value: "", because: "" },
-        journey: []
-      }
-    },
-    sources: [],
-    choices,
-    ...input.exceptions?.length ? { exceptions: input.exceptions } : {}
-  };
-}
-
-// src/direction/propose.ts
-function srgbToLinear(c) {
-  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
-}
-function toLab(r, g, b) {
-  const lr = srgbToLinear(r / 255);
-  const lg = srgbToLinear(g / 255);
-  const lb = srgbToLinear(b / 255);
-  const l = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);
-  const m = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);
-  const s = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);
-  return [0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s, 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s, 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s];
-}
-function paletteFromPixels(rgba, k = 6, maxSamples = 2e4) {
-  const total = Math.floor(rgba.length / 4);
-  const step = Math.max(1, Math.floor(total / maxSamples));
-  const px = [];
-  for (let i = 0; i < total; i += step) {
-    const o = i * 4;
-    if (rgba[o + 3] < 128) continue;
-    px.push({ lab: toLab(rgba[o], rgba[o + 1], rgba[o + 2]), rgb: [rgba[o], rgba[o + 1], rgba[o + 2]] });
-  }
-  if (px.length === 0) return [];
-  const sorted = [...px].sort((a, b) => a.lab[0] - b.lab[0]);
-  const n = Math.min(k, px.length);
-  let centres = Array.from({ length: n }, (_, i) => sorted[Math.floor((i + 0.5) / n * sorted.length)].lab.slice());
-  let assign = new Array(px.length).fill(0);
-  for (let iter = 0; iter < 12; iter += 1) {
-    assign = px.map((p) => {
-      let best = 0;
-      let bestD = Infinity;
-      centres.forEach((c, j) => {
-        const d = (p.lab[0] - c[0]) ** 2 + (p.lab[1] - c[1]) ** 2 + (p.lab[2] - c[2]) ** 2;
-        if (d < bestD) {
-          bestD = d;
-          best = j;
-        }
-      });
-      return best;
-    });
-    centres = centres.map((c, j) => {
-      const members = px.filter((_, i) => assign[i] === j);
-      if (members.length === 0) return c;
-      return [0, 1, 2].map((d) => members.reduce((s, m) => s + m.lab[d], 0) / members.length);
-    });
-  }
-  return centres.map((_, j) => {
-    const members = px.filter((__, i) => assign[i] === j);
-    if (members.length === 0) return null;
-    const avg = [0, 1, 2].map((d) => members.reduce((s, m) => s + m.rgb[d], 0) / members.length / 255);
-    const hex2 = formatHex({ r: avg[0], g: avg[1], b: avg[2] });
-    return { hex: hex2, share: members.length / px.length, oklch: hexToOklch(hex2) };
-  }).filter((c) => c !== null).sort((a, b) => b.share - a.share);
-}
-var chromatic = (o) => o.c >= 0.04 && o.l >= 0.2 && o.l <= 0.85;
-function accentCandidates(input) {
-  const out = [];
-  for (const s of input.sources) {
-    for (const c of s.colours ?? []) {
-      const parsed = parseColour(c);
-      if (!parsed || !chromatic(parsed.oklch)) continue;
-      const o = parsed.oklch;
-      const siblings = [
-        ...(input.estate ?? []).map((e) => ({ id: e.id, d: e.fingerprint.accent ? deltaEOk(o, e.fingerprint.accent) : 1 })),
-        ...(input.declared ?? []).flatMap((e) => {
-          const p = parseColour(e.accent);
-          return p ? [{ id: `${e.id} (declared)`, d: deltaEOk(o, p.oklch) }] : [];
-        })
-      ];
-      const nearest = siblings.sort((a, b) => a.d - b.d)[0];
-      const penalty = isAiViolet(o) ? 1 : 0;
-      out.push({
-        value: c.startsWith("#") ? c.toLowerCase() : c,
-        evidence: [s.id],
-        note: `from ${s.id} (${s.kind})${nearest ? `; nearest estate accent ${nearest.id} at \u0394E ${nearest.d.toFixed(2)}` : ""}${penalty ? "; in the reflex violet band" : ""}`,
-        score: (nearest ? Math.min(nearest.d, 0.3) : 0.3) - penalty + o.c
-      });
-    }
-  }
-  return out.sort((a, b) => b.score - a.score).map(({ score: _s, ...rest }) => rest);
-}
-function groundCandidates(input) {
-  const out = [];
-  for (const s of input.sources) {
-    for (const c of s.colours ?? []) {
-      const parsed = parseColour(c);
-      if (!parsed || parsed.oklch.l < 0.9) continue;
-      out.push({ value: c, evidence: [s.id], note: `a light colour from ${s.id}${isCream(parsed.oklch) ? "; reads as the cream tell, needs its reason" : ""}` });
-    }
-  }
-  return out;
-}
-function typeCandidates(input) {
-  return input.sources.filter((s) => s.lettering).map((s) => ({ value: "", evidence: [s.id], note: `find a face with the character of "${s.lettering}" on ${s.id}` }));
-}
-function propose(input) {
-  const proposals = [
-    { key: "accent", candidates: accentCandidates(input) },
-    { key: "ground", candidates: groundCandidates(input) },
-    { key: "display", candidates: typeCandidates(input) }
-  ];
-  const choices = {};
-  const draft = (p) => {
-    const top = p.candidates[0];
-    if (!top || !top.value) return void 0;
-    const source = input.sources.find((s) => s.id === top.evidence[0]);
-    return {
-      value: top.value,
-      because: `${PROPOSED} taken from the ${source.id}: ${source.note} Confirm it matches, then rewrite this in your own words.`,
-      evidence: top.evidence
-    };
-  };
-  for (const p of proposals) {
-    const c = draft(p);
-    if (c) choices[p.key] = c;
-  }
-  return {
-    proposals,
-    direction: { version: DIRECTION_VERSION, client: input.client, brief: input.brief, sources: input.sources, choices }
-  };
-}
-
-// src/direction/cli.ts
-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-BN2GSFKT.js");
-    return snapshotUrl(target);
-  }
-  return readSnapshot(readJson(resolve(cwd, target)), target);
-}
-function declaredFrom(path, cwd) {
-  if (!path || !path.endsWith(".json")) return [];
-  const register = readJson(resolve(cwd, path));
-  return register.sites ?? [];
-}
-var TEXT_SOURCE = /\.(?:txt|md|markdown|csv|json|html?)$/i;
-function estateFrom(dir, cwd) {
-  if (!dir) return [];
-  const root = resolve(cwd, dir);
-  if (root.endsWith(".json")) {
-    const register = readJson(root);
-    return (register.sites ?? []).filter((s) => s.fingerprint).map((s) => ({ id: s.id, fingerprint: s.fingerprint }));
-  }
-  return readdirSync(root).filter((f) => f.endsWith(".json")).flatMap((f) => {
-    try {
-      const snap = readSnapshot(readJson(join(root, f)), f);
-      return snap.fonts ? [{ id: f.replace(/(\.snapshot)?\.json$/, ""), fingerprint: fingerprint(snap) }] : [];
-    } catch {
-      return [];
-    }
-  });
-}
-async function runDirection(args, io) {
-  try {
-    const flags = parseFlags(args);
-    if (typeof flags === "string") throw new Error(flags);
-    const [sub] = flags.positional;
-    const file = resolve(io.cwd, flags.direction ?? "art-direction.json");
-    if (sub === "research") {
-      const base = existsSync(file) ? readJson(file) : {};
-      const brief = flags.brief ?? base.brief;
-      if (!brief || brief.trim().split(/\s+/).length < 5) throw new Error('usage: craft direction research --brief "<who, where, what they do>" [--visual], or run it next to an art-direction.json with a brief');
-      io.out(researchPrompt({ brief, client: flags.client ?? base.client, visual: flags.visual }));
-      return 0;
-    }
-    const page = flags.page ?? "home";
-    if (!PAGE_TYPES.includes(page)) throw new Error(`--page takes one of ${PAGE_TYPES.join(", ")}`);
-    const snapshot = await snapshotFrom(flags.snapshot, io.cwd);
-    const current = snapshot ? fingerprint(snapshot) : void 0;
-    if (sub === "init") {
-      const out = resolve(io.cwd, flags.out ?? "art-direction.json");
-      if (existsSync(out) && !flags.out) {
-        const existing = readJson(out);
-        if (existing.version !== void 0) throw new Error(`${out} already records choices. Pass --out to write elsewhere.`);
-        const next = initDirection({ client: flags.client, brief: flags.brief, current, exceptions: existing.exceptions });
-        writeFileSync(out, `${JSON.stringify(next, null, 2)}
-`);
-      } else {
-        writeFileSync(out, `${JSON.stringify(initDirection({ client: flags.client, brief: flags.brief, current }), null, 2)}
-`);
-      }
-      io.out(`craft direction: wrote ${out}. Add the sources and a reason for every choice, then run craft direction validate.`);
-      return 0;
-    }
-    if (sub === "validate") {
-      if (!existsSync(file)) throw new Error(`no ${file}. Run craft direction init.`);
-      const direction = readJson(file);
-      const estate = declaredFrom(flags.estate, io.cwd);
-      const report = validateDirection(direction, {
-        fingerprint: current,
-        snapshot,
-        page,
-        strict: flags.strict,
-        pathExists: (p) => existsSync(resolve(dirname(file), p)),
-        readSource: (s) => {
-          if (!s.path || /^https?:/.test(s.path) || !TEXT_SOURCE.test(s.path)) return void 0;
-          const path = resolve(dirname(file), s.path);
-          return existsSync(path) ? readFileSync(path, "utf8") : void 0;
-        },
-        estate,
-        estateId: estate.find((s) => s.client && s.client === direction.client)?.id
-      });
-      if (flags.json) io.out(toJson(report));
-      else {
-        for (const p of report.problems) io.out(`  ${p.severity === "error" ? "error" : "warn "}  ${p.at || "(file)"}  ${p.message}`);
-        const l = report.layers;
-        const pages = l.hierarchy.map((h) => `${h.page} ${h.decided} of ${h.total}`).join(", ");
-        io.out(
-          `craft direction: ${report.valid ? "valid" : "not valid"}. Job ${l.job ? "decided" : "not decided"}; hierarchy ${pages || "not decided"}; tokens ${l.tokens.decided} of ${l.tokens.total}.${l.complete ? " Every layer decided." : ""}`
-        );
-      }
-      return report.valid ? 0 : 1;
-    }
-    if (sub === "propose") {
-      if (!existsSync(file)) throw new Error(`no ${file}. Run craft direction init and add the sources first.`);
-      const base = readJson(file);
-      const sources = (base.sources ?? []).map((s) => {
-        if (s.colours?.length || !s.path || !/\.png$/i.test(s.path)) return s;
-        const path = resolve(dirname(file), s.path);
-        if (!existsSync(path)) return s;
-        try {
-          const { rgba } = decodePng(readFileSync(path));
-          return { ...s, colours: paletteFromPixels(rgba).filter((c) => c.share >= 0.03).map((c) => c.hex) };
-        } catch (error) {
-          io.err(`craft direction: ${s.path}: ${error.message}`);
-          return s;
-        }
-      });
-      const declared = declaredFrom(flags.estate, io.cwd).flatMap((s) => s.direction?.accent && s.client !== base.client ? [{ id: s.id, accent: s.direction.accent }] : []);
-      const result = propose({ client: base.client, brief: base.brief, sources, current, estate: estateFrom(flags.estate, io.cwd), declared });
-      const merged = { ...base, sources, choices: { ...result.direction.choices, ...stripUndecided(base.choices) }, ...base.exceptions ? { exceptions: base.exceptions } : {} };
-      const text = `${JSON.stringify(merged, null, 2)}
-`;
-      if (flags.out) writeFileSync(resolve(io.cwd, flags.out), text);
-      else io.out(text);
-      for (const p of result.proposals) {
-        io.err(`${p.key}: ${p.candidates.length ? p.candidates.map((c) => `${c.value || "?"} (${c.note})`).join("; ") : "nothing in the sources to draw on yet"}`);
-      }
-      return 0;
-    }
-    throw new Error("usage: craft direction init | validate | propose | research");
-  } catch (error) {
-    io.err(`craft: ${error.message}`);
-    return 2;
-  }
-}
-function stripUndecided(choices = {}) {
-  return Object.fromEntries(Object.entries(choices).filter(([, c]) => c && c.because && c.because.trim().length > 0));
-}
-export {
-  runDirection
-};