@domandigital/craft 0.14.0 → 0.16.0

package/art-direction.schema.json

@@ -2,40 +2,257 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://unpkg.com/@domandigital/craft/art-direction.schema.json",
   "title": "art-direction.json",
-  "description": "What a site decided about how it looks, and why. Every choice carries a reason from the client's real world and cites a source that shows it. The reason rule itself is enforced by `craft direction validate`; this schema only checks the shape.",
+  "description": "What a site decided, and why: the visitor's job, the structure decided from it, and how it looks. Every decision carries a reason: tokens from the client's real world, the job from the customer's own words, structure from the job. The reason rules are enforced by `craft direction validate`; this schema only checks the shape. Version 1 files (tokens only) still validate.",
   "type": "object",
-  "required": ["version", "client", "brief", "sources", "choices"],
+  "required": [
+    "version",
+    "client",
+    "brief",
+    "sources",
+    "choices"
+  ],
   "properties": {
-    "$schema": { "type": "string" },
-    "version": { "const": 1 },
-    "client": { "type": "string", "minLength": 1 },
-    "brief": { "type": "string", "description": "Who, where, and what they do, in a sentence or two." },
+    "$schema": {
+      "type": "string"
+    },
+    "version": {
+      "enum": [
+        1,
+        2
+      ]
+    },
+    "client": {
+      "type": "string",
+      "minLength": 1
+    },
+    "brief": {
+      "type": "string",
+      "description": "Who, where, and what they do, in a sentence or two."
+    },
+    "job": {
+      "type": "object",
+      "description": "Version 2. What the visitor is trying to get done, in their words.",
+      "properties": {
+        "statement": {
+          "type": "object",
+          "required": [
+            "verb",
+            "object",
+            "context"
+          ],
+          "properties": {
+            "verb": {
+              "type": "string"
+            },
+            "object": {
+              "type": "string"
+            },
+            "context": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "functional": {
+          "$ref": "#/$defs/jobPart"
+        },
+        "emotional": {
+          "$ref": "#/$defs/jobPart"
+        },
+        "social": {
+          "$ref": "#/$defs/jobPart"
+        },
+        "consideration": {
+          "type": "object",
+          "required": [
+            "value",
+            "because",
+            "evidence"
+          ],
+          "properties": {
+            "value": {
+              "enum": [
+                "low",
+                "considered",
+                "high"
+              ]
+            },
+            "because": {
+              "type": "string"
+            },
+            "evidence": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "objections": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "language": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "statement",
+        "functional",
+        "emotional",
+        "social",
+        "consideration",
+        "objections",
+        "language",
+        "evidence"
+      ]
+    },
+    "hierarchy": {
+      "type": "object",
+      "description": "Version 2. Keyed by page type.",
+      "propertyNames": {
+        "enum": [
+          "home",
+          "service",
+          "about",
+          "pricing",
+          "booking",
+          "contact",
+          "article",
+          "landing"
+        ]
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/page"
+      },
+      "required": [
+        "home"
+      ]
+    },
     "sources": {
       "type": "array",
       "items": {
         "type": "object",
-        "required": ["id", "kind", "note"],
+        "required": [
+          "id",
+          "kind",
+          "note"
+        ],
         "properties": {
-          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
-          "kind": { "enum": ["livery", "shopfront", "signage", "packaging", "product", "uniform", "interior", "place", "material", "trade", "print", "photo", "founder"] },
-          "note": { "type": "string" },
-          "path": { "type": "string" },
-          "colours": { "type": "array", "items": { "type": "string" } },
-          "lettering": { "type": "string" }
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]*$"
+          },
+          "kind": {
+            "enum": [
+              "livery",
+              "shopfront",
+              "signage",
+              "packaging",
+              "product",
+              "uniform",
+              "interior",
+              "place",
+              "material",
+              "trade",
+              "print",
+              "photo",
+              "founder",
+              "review",
+              "enquiry",
+              "conversation",
+              "search",
+              "reference"
+            ]
+          },
+          "note": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          },
+          "colours": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "lettering": {
+            "type": "string"
+          },
+          "category": {
+            "type": "string",
+            "description": "For a reference: where it comes from. Never the client's own category."
+          }
         },
-        "additionalProperties": false
+        "additionalProperties": false,
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "kind": {
+                  "const": "reference"
+                }
+              },
+              "required": [
+                "kind"
+              ]
+            },
+            "then": {
+              "required": [
+                "category"
+              ]
+            }
+          }
+        ]
       }
     },
     "choices": {
       "type": "object",
-      "propertyNames": { "enum": ["accent", "ground", "display", "body", "shape", "motif", "signature"] },
+      "propertyNames": {
+        "enum": [
+          "accent",
+          "ground",
+          "display",
+          "body",
+          "shape",
+          "motif",
+          "signature"
+        ]
+      },
       "additionalProperties": {
         "type": "object",
-        "required": ["value", "because", "evidence"],
+        "required": [
+          "value",
+          "because",
+          "evidence"
+        ],
         "properties": {
-          "value": { "type": "string" },
-          "because": { "type": "string" },
-          "evidence": { "type": "array", "items": { "type": "string" } }
+          "value": {
+            "type": "string"
+          },
+          "because": {
+            "type": "string"
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
         },
         "additionalProperties": false
       }
@@ -44,16 +261,202 @@
       "type": "array",
       "items": {
         "type": "object",
-        "required": ["tell", "because"],
+        "required": [
+          "tell",
+          "because"
+        ],
         "properties": {
-          "tell": { "type": "string" },
-          "because": { "type": "string" },
-          "evidence": { "type": "string" },
-          "path": { "type": "string" }
+          "tell": {
+            "type": "string"
+          },
+          "because": {
+            "type": "string"
+          },
+          "evidence": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          }
         },
         "additionalProperties": false
       }
     }
   },
-  "additionalProperties": false
+  "additionalProperties": false,
+  "$defs": {
+    "jobPart": {
+      "type": "object",
+      "required": [
+        "value",
+        "evidence"
+      ],
+      "properties": {
+        "value": {
+          "type": "string"
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "role": {
+      "enum": [
+        "hero",
+        "logos",
+        "stats",
+        "cards",
+        "marquee",
+        "text",
+        "other",
+        "cta-band",
+        "footer-cta",
+        "pricing",
+        "testimonials",
+        "faq",
+        "process",
+        "features",
+        "team",
+        "contact"
+      ]
+    },
+    "page": {
+      "type": "object",
+      "required": [
+        "primaryAction",
+        "order",
+        "lead",
+        "journey"
+      ],
+      "properties": {
+        "primaryAction": {
+          "type": "object",
+          "required": [
+            "value",
+            "positions",
+            "because"
+          ],
+          "properties": {
+            "value": {
+              "type": "string"
+            },
+            "positions": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/role"
+                  },
+                  {
+                    "enum": [
+                      "header",
+                      "sticky"
+                    ]
+                  }
+                ]
+              }
+            },
+            "because": {
+              "type": "string"
+            },
+            "evidence": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "order": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "role",
+              "because"
+            ],
+            "properties": {
+              "role": {
+                "$ref": "#/$defs/role"
+              },
+              "because": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": false
+          },
+          "minItems": 2
+        },
+        "lead": {
+          "type": "object",
+          "required": [
+            "value",
+            "because"
+          ],
+          "properties": {
+            "value": {
+              "type": "string"
+            },
+            "subordinate": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "because": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "journey": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "stage",
+              "because"
+            ],
+            "properties": {
+              "stage": {
+                "type": "string"
+              },
+              "because": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": false
+          },
+          "minItems": 2
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "oneOf": [
+    {
+      "properties": {
+        "version": {
+          "const": 1
+        }
+      }
+    },
+    {
+      "properties": {
+        "version": {
+          "const": 2
+        }
+      },
+      "required": [
+        "job",
+        "hierarchy"
+      ]
+    }
+  ]
 }

package/dist/{audit-6WHR7ZTV.js → audit-UJCUWORL.js}

@@ -9,9 +9,9 @@ import {
   snapshotPage,
   snapshotUrl,
   snapshotUrls
-} from "./chunk-Q7ILL2HV.js";
+} from "./chunk-YK2FFL6Z.js";
 import "./chunk-JYNXGCYZ.js";
-import "./chunk-GQVEYTBY.js";
+import "./chunk-B2MJLGF6.js";
 import "./chunk-QYBAVU3P.js";
 export {
   PROVENANCE_BUDGET_MS,

package/dist/audit.cjs

@@ -3365,6 +3365,11 @@ function fingerprint(s) {
     } : {}
   };
 }
+var ACCENT_SCALE = 0.3;
+var GROUND_SCALE = 0.15;
+var SHARED_PART = 0.2;
+var ACCENT_SHARED = ACCENT_SCALE * SHARED_PART;
+var GROUND_SHARED = GROUND_SCALE * SHARED_PART;
 
 // src/fingerprint/component.ts
 var PROMO_BADGE = /\b(?:most popular|popular|recommended|best value|best seller|bestseller|most chosen)\b/i;

package/dist/audit.js

@@ -3330,6 +3330,11 @@ function fingerprint(s) {
     } : {}
   };
 }
+var ACCENT_SCALE = 0.3;
+var GROUND_SCALE = 0.15;
+var SHARED_PART = 0.2;
+var ACCENT_SHARED = ACCENT_SCALE * SHARED_PART;
+var GROUND_SHARED = GROUND_SCALE * SHARED_PART;
 
 // src/fingerprint/component.ts
 var PROMO_BADGE = /\b(?:most popular|popular|recommended|best value|best seller|bestseller|most chosen)\b/i;

package/dist/{chunk-GQVEYTBY.js → chunk-B2MJLGF6.js}

@@ -660,9 +660,14 @@ function faceDistance(a, b) {
   if (a.family.toLowerCase() === b.family.toLowerCase()) return 0;
   return a.class === b.class ? 0.5 : 1;
 }
+var ACCENT_SCALE = 0.3;
+var GROUND_SCALE = 0.15;
+var SHARED_PART = 0.2;
+var ACCENT_SHARED = ACCENT_SCALE * SHARED_PART;
+var GROUND_SHARED = GROUND_SCALE * SHARED_PART;
 function fingerprintDistance(a, b) {
-  const accent = a.accent && b.accent ? clamp(deltaEOk(a.accent, b.accent) / 0.3) : a.accent || b.accent ? 1 : 0;
-  const ground = clamp(deltaEOk(a.ground, b.ground) / 0.15);
+  const accent = a.accent && b.accent ? clamp(deltaEOk(a.accent, b.accent) / ACCENT_SCALE) : a.accent || b.accent ? 1 : 0;
+  const ground = clamp(deltaEOk(a.ground, b.ground) / GROUND_SCALE);
   const type = 0.6 * faceDistance(a.display, b.display) + 0.4 * faceDistance(a.body, b.body);
   const shape = a.roundness === null || b.roundness === null ? a.roundness === b.roundness ? 0 : 0.5 : clamp(Math.abs(a.roundness - b.roundness) / 0.5);
   const motion = clamp(Math.abs(a.motion - b.motion));
@@ -1854,7 +1859,7 @@ function closestComponents(a, b, role) {
 }
 function estateComponentPairs(register, role) {
   const out = [];
-  const s = register.sites;
+  const s = register.sites.filter((site) => site.fingerprint);
   for (let i = 0; i < s.length; i += 1) {
     for (let j = i + 1; j < s.length; j += 1) {
       const c = closestComponents(s[i].fingerprint, s[j].fingerprint, role);
@@ -4611,6 +4616,7 @@ export {
   protectedFacts,
   compareFacts,
   formatComparison,
+  TRADE_NOUNS,
   pageCopy,
   compareCompetitor,
   formatCompetitor,
@@ -4619,10 +4625,15 @@ export {
   holdHouseBlocks,
   normaliseFamily,
   fingerprint,
+  levenshtein,
+  SHARED_PART,
+  ACCENT_SHARED,
+  GROUND_SHARED,
   fingerprintDistance,
   NULL_VERSION,
   nullPrompt,
   extractHtml,
+  MIN_RUNS,
   typicality,
   hueName,
   groundName,