@domandigital/craft 0.14.0 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.14.0",
+  "version": "0.16.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/chunk-OOZOEWGD.js

@@ -1,295 +0,0 @@
-import {
-  REFLEX_FONTS_1,
-  REFLEX_FONTS_2,
-  deltaEOk,
-  isAiViolet,
-  isCream,
-  normaliseFamily,
-  parseColour
-} from "./chunk-GQVEYTBY.js";
-
-// src/direction/licences.ts
-var LICENCES = [
-  {
-    name: "Basteleur",
-    subject: "face",
-    licence: "OFL-1.1",
-    multiClient: "yes",
-    checked: "2026-09-24",
-    source: "https://velvetyne.fr/fonts/basteleur/",
-    note: "Velvetyne, designed by Keussel. Keep the OFL notice with the font files."
-  },
-  {
-    name: "Gulax",
-    subject: "face",
-    licence: "OFL-1.1",
-    multiClient: "yes",
-    checked: "2026-09-24",
-    source: "https://velvetyne.fr/fonts/gulax/",
-    note: "Velvetyne. Keep the OFL notice with the font files."
-  },
-  {
-    name: "Le Murmure",
-    subject: "face",
-    licence: "OFL-1.1",
-    multiClient: "yes",
-    checked: "2026-09-24",
-    source: "https://velvetyne.fr/fonts/le-murmure/",
-    note: "Velvetyne. Keep the OFL notice with the font files."
-  },
-  {
-    name: "Blaze Type",
-    subject: "foundry",
-    licence: "commercial",
-    multiClient: "per-site",
-    cap: 10,
-    checked: "2026-09-24",
-    source: "https://blazetype.eu/eula",
-    note: "The EULA sells a professional licence for 1 to 10 websites, and lets an agency buy in a client's name at the listed price. Its /license page says one licence covers every domain; the EULA is the contract, so buy per client."
-  },
-  {
-    name: "Power Type",
-    subject: "foundry",
-    licence: "commercial",
-    multiClient: "unverified",
-    checked: "2026-09-24",
-    source: "https://power-type.com/eula",
-    note: "Research on 2026-09-11 reported a Super License capped at 10 self-hosted domains. The EULA page did not load when checked; read it before relying on the cap."
-  },
-  {
-    name: "Grilli Type",
-    subject: "foundry",
-    licence: "commercial",
-    multiClient: "per-site",
-    checked: "2026-09-24",
-    source: "https://www.grillitype.com/information",
-    note: "Web licences cover any number of domains controlled by the licensee, priced by monthly visitors, so a client site needs the client's own licence. Unlimited tiers start at $10,000 per style."
-  },
-  {
-    name: "Phosphor",
-    subject: "icons",
-    licence: "MIT",
-    multiClient: "yes",
-    checked: "2026-09-24",
-    source: "https://github.com/phosphor-icons/core/blob/main/LICENSE",
-    note: "Six weights. The icon-tile tells treat it exactly as they treat Lucide: the library is not the tell, the tinted tile is."
-  },
-  {
-    name: "Tabler Icons",
-    subject: "icons",
-    licence: "MIT",
-    multiClient: "yes",
-    checked: "2026-09-24",
-    source: "https://github.com/tabler/tabler-icons/blob/main/LICENSE",
-    note: "One stroke grid across the set."
-  },
-  {
-    name: "Iconoir",
-    subject: "icons",
-    licence: "MIT",
-    multiClient: "yes",
-    checked: "2026-09-24",
-    source: "https://github.com/iconoir-icons/iconoir/blob/main/LICENSE",
-    note: "Smaller set, no paid tier."
-  },
-  {
-    name: "Unicons",
-    subject: "icons",
-    licence: "IconScout Simple License",
-    multiClient: "yes",
-    checked: "2026-09-24",
-    source: "https://github.com/Iconscout/unicons/blob/master/LICENSE",
-    note: "IconScout's free set, personal and commercial use, attribution optional."
-  },
-  {
-    name: "IconScout premium",
-    subject: "icons",
-    licence: "commercial",
-    multiClient: "per-site",
-    checked: "2026-09-24",
-    source: "https://iconscout.com/licenses",
-    note: "Each licence covers a single end product. Never in a tool, template or shared kit (create-site, craft, a house component library), even modified. Record the assets each site uses. Assets come from different contributors, so take one site's set from one contributor."
-  }
-];
-function faceLicence(family) {
-  const name = family.trim().toLowerCase();
-  return LICENCES.find((l) => l.subject === "face" && l.name.toLowerCase() === name);
-}
-
-// src/direction/types.ts
-var DIRECTION_VERSION = 1;
-var SOURCE_KINDS = [
-  "livery",
-  "shopfront",
-  "signage",
-  "packaging",
-  "product",
-  "uniform",
-  "interior",
-  "place",
-  "material",
-  "trade",
-  "print",
-  "photo",
-  "founder"
-];
-var CHOICE_KEYS = ["accent", "ground", "display", "body", "shape", "motif", "signature"];
-
-// src/direction/validate.ts
-var PREFERENCE = /\b(?:client (?:likes|liked|wants|wanted|asked|chose|prefers?)|(?:we|they|i) (?:like|liked|love|loved|prefer)|on[- ]trend|trendy|popular|what (?:everyone|competitors) (?:uses?|does)|brand (?:colou?r|font|guidelines?) (?:is|are|says?))\b/i;
-var MOOD = /\b(?:modern|clean|fresh|professional|trustworthy|premium|elegant|sleek|timeless|minimal(?:ist)?|bold|vibrant|friendly|approachable|luxur(?:y|ious)|sophisticated|contemporary|stylish|warm|inviting|high[- ]end)\b/gi;
-var VALUE_WORDS = /* @__PURE__ */ new Set(["green", "blue", "navy", "black", "white", "cream", "grey", "gray", "gold", "yellow", "orange", "purple", "violet", "pink", "brown", "teal", "bottle", "dark", "light", "deep", "pale", "bright", "colour", "color", "font", "face", "serif", "sans", "type", "lettering"]);
-var STOP = /* @__PURE__ */ new Set(["with", "that", "this", "from", "their", "they", "have", "been", "were", "which", "what", "when", "where", "there", "about", "into", "onto", "over", "same", "each", "every"]);
-function words(text) {
-  return new Set((text.toLowerCase().match(/[a-z][a-z'-]{3,}/g) ?? []).map((w) => w.replace(/'s$/, "")).filter((w) => !STOP.has(w) && !VALUE_WORDS.has(w)));
-}
-function tellFor(key, value) {
-  if (key === "accent") {
-    const c = parseColour(value);
-    return c && isAiViolet(c.oklch) ? "ai-violet" : null;
-  }
-  if (key === "ground") {
-    const c = parseColour(value);
-    return c && isCream(c.oklch) ? "cream-palette" : null;
-  }
-  if (key === "display" || key === "body") {
-    const name = normaliseFamily(value).toLowerCase();
-    if (REFLEX_FONTS_1.some((f) => f.toLowerCase() === name)) return "reflex-font";
-    if (REFLEX_FONTS_2.some((f) => f.toLowerCase() === name)) return "reflex-font-2";
-  }
-  return null;
-}
-function validateDirection(input, ctx = {}) {
-  const problems = [];
-  const err = (at, message) => problems.push({ severity: "error", at, message });
-  const warn = (at, message) => problems.push({ severity: "warn", at, message });
-  if (!input || typeof input !== "object" || Array.isArray(input)) {
-    err("", "art-direction.json must be a JSON object");
-    return { valid: false, problems, decided: 0 };
-  }
-  const d = input;
-  const legacy = d.version === void 0 && d.choices === void 0 && Array.isArray(d.exceptions);
-  if (legacy) {
-    warn("", "exceptions only: run craft direction init to record the choices and their reasons");
-    return { valid: true, problems, decided: 0 };
-  }
-  if (d.version !== DIRECTION_VERSION) err("version", `version must be ${DIRECTION_VERSION}`);
-  if (typeof d.client !== "string" || !d.client.trim()) err("client", "name the client");
-  if (typeof d.brief !== "string" || d.brief.trim().split(/\s+/).length < 8) err("brief", "the brief needs a sentence: who, where, and what they do");
-  const sources = Array.isArray(d.sources) ? d.sources : [];
-  if (!Array.isArray(d.sources)) err("sources", "sources must be a list");
-  if (sources.length === 0) err("sources", "no sources: a reason needs something in the client's world to point at");
-  const ids = /* @__PURE__ */ new Set();
-  sources.forEach((s, i) => {
-    const at = `sources[${i}]`;
-    if (!s || typeof s !== "object") return err(at, "a source must be an object");
-    if (typeof s.id !== "string" || !/^[a-z0-9][a-z0-9-]*$/.test(s.id)) err(`${at}.id`, "id must be short kebab-case");
-    else if (ids.has(s.id)) err(`${at}.id`, `"${s.id}" is used twice`);
-    else ids.add(s.id);
-    if (!SOURCE_KINDS.includes(s.kind)) err(`${at}.kind`, `kind must be one of: ${SOURCE_KINDS.join(", ")}`);
-    if (typeof s.note !== "string" || s.note.trim().split(/\s+/).length < 3) err(`${at}.note`, "say what it is and where");
-    if (s.path && ctx.pathExists && !/^https?:/.test(s.path) && !ctx.pathExists(s.path)) err(`${at}.path`, `${s.path} does not exist`);
-    for (const [j, c] of (s.colours ?? []).entries()) if (!parseColour(c)) err(`${at}.colours[${j}]`, `"${c}" is not a colour`);
-  });
-  const choices = d.choices && typeof d.choices === "object" ? d.choices : {};
-  if (!d.choices || typeof d.choices !== "object") err("choices", "choices must be an object");
-  const exceptions = Array.isArray(d.exceptions) ? d.exceptions : [];
-  let decided = 0;
-  for (const key of Object.keys(choices)) {
-    if (!CHOICE_KEYS.includes(key)) err(`choices.${key}`, `not a choice craft knows. Choices are: ${CHOICE_KEYS.join(", ")}. Layout and navigation stay conventional.`);
-  }
-  for (const key of CHOICE_KEYS) {
-    const c = choices[key];
-    const at = `choices.${key}`;
-    if (!c) {
-      warn(at, "not decided yet");
-      continue;
-    }
-    let ok = true;
-    if (typeof c.value !== "string" || !c.value.trim()) {
-      err(`${at}.value`, "no value");
-      ok = false;
-    } else if ((key === "accent" || key === "ground") && !parseColour(c.value)) {
-      err(`${at}.value`, `"${c.value}" is not a colour`);
-      ok = false;
-    }
-    const because = typeof c.because === "string" ? c.because.trim() : "";
-    const evidence = Array.isArray(c.evidence) ? c.evidence : [];
-    if (because.split(/\s+/).filter(Boolean).length < 8) {
-      err(`${at}.because`, "a reason is at least a sentence. Without one this is a default, however good it looks.");
-      ok = false;
-    } else if (because.startsWith("PROPOSED:")) {
-      err(`${at}.because`, "a proposal, not yet a decision. Check it against the source, then rewrite the reason in your own words.");
-      ok = false;
-    } else {
-      if (PREFERENCE.test(because)) {
-        err(`${at}.because`, "that is a preference, not a reason. Say what in the client's world this comes from.");
-        ok = false;
-      }
-      const moods = because.match(MOOD) ?? [];
-      if (moods.length >= 2) {
-        err(`${at}.because`, `"${moods.join(", ")}" describes a mood, not a source. Name the thing it comes from.`);
-        ok = false;
-      }
-    }
-    if (evidence.length === 0) {
-      err(`${at}.evidence`, "cite at least one source");
-      ok = false;
-    }
-    for (const id of evidence) {
-      if (!ids.has(id)) {
-        err(`${at}.evidence`, `no source called "${id}"`);
-        ok = false;
-      }
-    }
-    if (ok) {
-      const cited = sources.filter((s) => evidence.includes(s.id));
-      const reasonWords = words(because);
-      const tied = cited.some((s) => reasonWords.has(s.id) || [...words(`${s.note} ${s.lettering ?? ""}`)].some((w) => reasonWords.has(w)));
-      if (!tied) {
-        err(`${at}.because`, `the reason does not mention what its evidence shows (${evidence.join(", ")}). Say what on it this comes from.`);
-        ok = false;
-      }
-    }
-    if (typeof c.value === "string") {
-      const tell = tellFor(key, c.value);
-      if (tell && !exceptions.some((e) => e.tell === tell)) {
-        err(`${at}.value`, `${c.value} is on the tell catalogue (${tell}). Keep it only with an exception for ${tell}, carrying the same reason.`);
-        ok = false;
-      }
-    }
-    if ((key === "display" || key === "body") && typeof c.value === "string" && c.value.trim()) {
-      const family = normaliseFamily(c.value);
-      const entry = faceLicence(family);
-      if (!entry) {
-        warn(`${at}.value`, `${family}: licence not in craft's register. Read the licensor's own terms for use on this client's site, then add it to src/direction/licences.ts.`);
-      } else if (entry.multiClient === "unverified") {
-        warn(`${at}.value`, `${family}: licence unverified (${entry.note})`);
-      } else if (entry.multiClient === "capped" || entry.multiClient === "per-site") {
-        const scope = entry.multiClient === "capped" ? `covers up to ${entry.cap} sites` : "needs a licence for this site, in the client's name";
-        warn(`${at}.value`, `${family}: ${entry.licence} licence ${scope}. Record the purchase before launch.`);
-      }
-    }
-    const fp = ctx.fingerprint;
-    if (fp && typeof c.value === "string") {
-      if ((key === "accent" || key === "ground") && parseColour(c.value)) {
-        const declared = parseColour(c.value).oklch;
-        const measured = key === "accent" ? fp.accent : fp.ground;
-        if (measured && deltaEOk(declared, measured) > 0.08) {
-          warn(`${at}.value`, `the page does not show it: its ${key} measures oklch(${measured.l.toFixed(2)} ${measured.c.toFixed(3)} ${measured.h.toFixed(0)})`);
-        }
-      }
-      if (key === "display" || key === "body") {
-        const measured = key === "display" ? fp.display.family : fp.body.family;
-        if (normaliseFamily(c.value).toLowerCase() !== measured.toLowerCase()) warn(`${at}.value`, `the page sets ${measured}, not ${c.value}`);
-      }
-    }
-    if (ok) decided += 1;
-  }
-  return { valid: problems.every((p) => p.severity !== "error"), problems, decided };
-}
-
-export {
-  DIRECTION_VERSION,
-  validateDirection
-};