@domandigital/craft 0.18.1 → 0.19.0

package/dist/index.d.ts

@@ -914,6 +914,8 @@ interface SnapshotImage {
     width: number;
     height: number;
     top: number;
+    /** Version 2, craft 0.19 and later: distance from the viewport's left edge, so a hero can say which side its picture sits. */
+    left?: number;
     role: ImageRole;
     alt: string | null;
     /** Empty alt, `aria-hidden` or `role="presentation"`. */
@@ -2228,8 +2230,14 @@ declare function visualMeasures(img: RgbaImage, maxSamples?: number): SnapshotVi
  * comparison involving it uses `layout` exactly as version 1 did, so the null
  * models and the estate register compare as they were calibrated until they
  * are re-snapshotted.
+ *
+ * 3 adds `hero` (the headline's size and where the hero's picture sits).
+ * Rhythm, the sequence of light and dark bands, is read from the version 2
+ * `sections`, so a version 2 fingerprint measures it without a fresh
+ * snapshot. A part neither side carries is left out of the distance rather
+ * than counted as different (see `fingerprintDistance`).
  */
-declare const FINGERPRINT_VERSION = 2;
+declare const FINGERPRINT_VERSION = 3;
 /** One section as layout comparison sees it. */
 interface FingerprintSection {
     role: SectionRole;
@@ -2253,8 +2261,26 @@ interface FingerprintSection {
     /** Large standalone figures. */
     figures?: number;
 }
+/** Where the hero's largest picture sits, relative to the headline. */
+type HeroImage = "left" | "right" | "full" | "none";
+/** The hero's composition: the first thing two sites are compared on by eye. */
+interface FingerprintHero {
+    /** The headline (the first h1 inside the hero), or null when the hero has none. */
+    headline: {
+        sizePx: number;
+        weight: number;
+        class: FontClass;
+        italic: boolean;
+    } | null;
+    /**
+     * The largest photo or illustration in the hero: beside the text (left or
+     * right of the viewport's centre line), `full` when it spans the width,
+     * `none` without one. Absent when the snapshot predates image positions.
+     */
+    image?: HeroImage;
+}
 interface Fingerprint {
-    version: 1 | 2;
+    version: 1 | 2 | 3;
     /** The most prominent chromatic colour: button fills first, then painted area, then text. */
     accent: Oklch | null;
     ground: Oklch;
@@ -2276,10 +2302,29 @@ interface Fingerprint {
     layout: SectionKind[];
     /** Version 2: present when every section carries a role and geometry. */
     sections?: FingerprintSection[];
+    /** Version 3: present when the page has a hero section. */
+    hero?: FingerprintHero;
 }
 declare function fingerprint(s: Snapshot): Fingerprint;
+/**
+ * Chroma at which a ground's tint is unmistakable. RMP's cream sits at 0.010
+ * and Bellerose's stone at 0.007, both plainly warm paper; Bellerose's
+ * porcelain (#F1F3F4) at 0.003 is a cool hint. A page ground is the largest
+ * area on the page and the eye adapts to it, so a tint far below what reads
+ * as a difference between two buttons still reads as warm or cool paper.
+ */
+declare const TEMPERATURE_FULL = 0.006;
+/** A ground is named warm or cool from this temperature, about chroma 0.0024. Below it, the name stays neutral. */
+declare const TEMPERATURE_NAMED = 0.4;
+/**
+ * How warm or cool a colour reads, -1 (fully cool) through 0 (neutral) to 1
+ * (fully warm): the chroma over `TEMPERATURE_FULL`, signed by the hue.
+ */
+declare function groundTemperature(o: Oklch): number;
+type Temperature = "warm" | "neutral" | "cool";
+declare function temperatureName(o: Oklch): Temperature;
 interface FingerprintDistance {
-    /** 0 identical, 1 nothing in common. A weighted mean of the parts. */
+    /** 0 identical, 1 nothing in common. A weighted mean of the parts both sides measure. */
     total: number;
     parts: {
         accent: number;
@@ -2289,34 +2334,78 @@ interface FingerprintDistance {
         motion: number;
         effects: number;
         layout: number;
+        /** Null when either side has no sections (version 1). */
+        rhythm: number | null;
+        /** Null when either side has no hero. */
+        hero: number | null;
     };
 }
 /**
  * How much each part counts. Accent and type are where a model's defaults
  * show first and where a real business has something of its own, so they
- * carry half the weight between them.
+ * carry the most. Structure (the running order, the rhythm of light and dark
+ * bands, and the hero's composition) carries a quarter between its three
+ * parts: two sites that open the same way read as the same site before any
+ * colour is compared. A part only one side measures is left out and the
+ * rest are weighed over what remains.
  */
 declare const DISTANCE_WEIGHTS: {
-    readonly accent: 0.25;
-    readonly type: 0.25;
+    readonly accent: 0.2;
+    readonly type: 0.2;
     readonly ground: 0.1;
     readonly shape: 0.1;
-    readonly motion: 0.1;
+    readonly motion: 0.05;
     readonly effects: 0.1;
     readonly layout: 0.1;
+    readonly rhythm: 0.1;
+    readonly hero: 0.05;
 };
 /** Layout distance, 0 to 1: by role and geometry when both have them, else by kind as in version 1. */
 declare function layoutDistance(a: Fingerprint, b: Fingerprint): number;
+/** A section's band by the lightness of what it is painted on. */
+type LightnessBand = "light" | "mid" | "dark";
+declare function bandOf(l: number): LightnessBand;
+/**
+ * The page's rhythm: its bands of light and dark in running order, each run
+ * of same-lightness sections merged into one. "Light hero, white logo strip,
+ * near-black band, light features" is light, dark, light: the strip is part
+ * of the light opening, which is how a visitor sees it. Null for a version 1
+ * fingerprint, which has no section backgrounds.
+ */
+declare function rhythmOf(fp: Fingerprint): LightnessBand[] | null;
+/** The first bands count double: the opening is what two sites are compared on before anyone scrolls. */
+declare const OPENING_BANDS = 3;
+/**
+ * Rhythm distance, 0 to 1: the edit distance over the opening bands and over
+ * the whole sequence, averaged. Null when either side has no sections.
+ */
+declare function rhythmDistance(a: Fingerprint, b: Fingerprint): number | null;
+/**
+ * Hero distance, 0 to 1, over the parts both sides measure: where the text
+ * sits (centred or left), how wide it runs, the headline's class and size,
+ * and which side the picture is on. Null when either side has no hero.
+ */
+declare function heroDistance(a: Fingerprint, b: Fingerprint): number | null;
 /** ΔE in OKLab. 0.02 is barely visible; by 0.3 two accents read as different colours. */
 declare const ACCENT_SCALE = 0.3;
 /** Grounds sit near white, where a smaller step already reads as a different paper. */
 declare const GROUND_SCALE = 0.15;
+/**
+ * How much a difference in temperature adds to the ground distance, on top
+ * of ΔE. Cream against porcelain is ΔE 0.013, a tenth of `GROUND_SCALE`, and
+ * nobody takes them for the same paper: the temperature carries what ΔE
+ * cannot at this chroma. Warm against cool adds 0.6; warm against neutral
+ * white adds 0.3; two warm papers add nothing.
+ */
+declare const TEMPERATURE_WEIGHT = 0.6;
 /** A part at or below this distance counts as shared between two sites. */
 declare const SHARED_PART = 0.2;
 /** Two accents within this ΔE_OK read as the same colour family: about 6 on the familiar ΔE scale. */
 declare const ACCENT_SHARED: number;
 /** Two grounds within this ΔE_OK read as the same paper. */
 declare const GROUND_SHARED: number;
+/** Ground distance, 0 to 1: ΔE over `GROUND_SCALE`, plus the temperature gap. */
+declare function groundDistance(a: Oklch, b: Oklch): number;
 declare function fingerprintDistance(a: Fingerprint, b: Fingerprint): FingerprintDistance;
 /**
  * The nearest neighbours of a fingerprint in a set, closest first. Typicality
@@ -2582,8 +2671,9 @@ declare function emptyEstate(): EstateRegister;
 declare function addSite(register: EstateRegister, site: EstateSite): EstateRegister;
 /**
  * What two fingerprints effectively share, named the way a person would see
- * it: "Fraunces headline", "no accent", "pill buttons". A part counts when its
- * distance is `SHARED_PART` or less.
+ * it: "Fraunces headline", "no accent", "pill buttons", "cream ground",
+ * "light hero then dark band". A part counts when its distance is
+ * `SHARED_PART` or less; a part neither side measures never counts.
  */
 declare function sharedParts(a: Fingerprint, b: Fingerprint, d?: FingerprintDistance): string[];
 interface EstateMatch {
@@ -2703,7 +2793,18 @@ interface Typicality {
  */
 declare function typicality(target: Fingerprint, runs: NullRun[], k?: number): Typicality;
 declare function hueName(o: Oklch | null): string;
+/**
+ * The coarse name the null's choice counts use ("white", "cream"), kept
+ * stable so a harvest compares with earlier runs. `groundLabel` is the one a
+ * person reads.
+ */
 declare function groundName(o: Oklch): string;
+/**
+ * The ground as a person would name it, with its temperature: "cream",
+ * "cool grey", "warm white", "cool dark". Every light neutral page used to be
+ * "grey", which put RMP's cream and Bellerose's porcelain under one word.
+ */
+declare function groundLabel(o: Oklch): string;
 declare function shapeName(roundness: number | null): string;
 /** The discrete choices a fingerprint makes, as part → value. What a person would name. */
 declare function choicesOf(fp: Fingerprint): Record<string, string[]>;
@@ -3345,4 +3446,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { ACCENT_SCALE, ACCENT_SHARED, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Band, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, COMPONENT_ROLES, CONSIDERATION, CONTENT_FEATURES, CONVENTION, CUSTOMER_KINDS, type Calibration, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type Consideration, type ContrastCheck, type ContrastReport, type CopySide, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, type CustomerKind, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DIRECTION_VERSIONS, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, FLAGGED_TARGET, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, type GradientContrast, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, HUMAN_TYPICAL_TARGET, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, type ImageProvenance, type ImageRole, JSON_SCHEMA_VERSION, type JobContext, type JobMap, type JobPart, LABELS, LEXICAL_FEATURES, LICENCES, LIGHTNESS_CURVE, type Label, type LabelSummary, type LexicalFeatures, type LicenceEntry, type LicenceSubject, MIN_DECIDED, MIN_PARAGRAPHS, MIN_RUNS, MOOD, type MeasuredPage, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROFILE, PROFILE_MEASURED, PROFILE_PARAGRAPHS, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type PhotoReviewOptions, type PhotoReviewResult, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, REGISTERS, REGISTER_BASELINE, REGISTER_FEATURES, REGISTER_IDS, RENDERED_PATHS, RENDERED_TELLS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type Register, type RegisterCheck, type RegisterFeatures, type RegisterId, type RegisterProfile, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, SAMPLES_PER_SEGMENT, SCALE, SECTION_ROLES, SHADCN_LIMIT, SHADCN_PRIMITIVES, SHARED_PART, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPECIFICITY_COPY_TELLS, SPECIFICITY_RENDERED_TELLS, SPRING, STANDING_CLAIM, STOCK_AVATAR_HOSTS, STOCK_FIGURES, STOCK_PHOTO_HOSTS, STOCK_PHRASES, STUDY_WORDS, type SarifOptions, type SarifTell, type SectionGeometry, type SectionKind, type SectionRhythmOptions, type SectionRole, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShapeFeatures, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotImage, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Specific, type SpecificKind, type Specificity, type StudyWord, type Surface, TELL_HEAVY, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type TargetCheck, type Tell, type TellException, type TellRate, type Tricolon, type TypeStep, type Typicality, type UnmeasuredPage, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, briefTerms, calibrate, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkPhotoReview, checkReason, checkRegister, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, documentParagraphs, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, featureLabel, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, getRegister, globToRegExp, gradientContrast, gradientStops, groundName, harvest, hedgeCount, hedgedClose, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, isFlagged, jobWords, layoutDistance, lexicalOf, licencesJson, makeSnapshot, motionTokens, namedSources, nearest, nominalisations, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, pageCopy, paletteFromPixels, paragraphUniformity, parseBaseline, parseColour, parseCraftConfig, parseHex, participialClauses, phrasalCoordinations, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, registerBrief, registerOf, registersDoc, renderedOrder, researchPrompt, retrofitPlan, runTell, scanProvenance, scanSource, sectionRhythm, semantic, sentencesOf, severityExceptions, shapeMoves, shapeName, shapeOf, words as shapeWords, sharedParts, shouldAnimate, siblingLine, skeleton, skeletonRepeat, specificity, specifics, splitSentences, stackedConditional, stockAvatarSource, stockSource, summariseDirection, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateDirection, validateHierarchy, validateJob, visibleText, visualMeasures, vocabulary, vocabularyCounts, wcagContrast, wordListsJson };
+export { ACCENT_SCALE, ACCENT_SHARED, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Band, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, COMPONENT_ROLES, CONSIDERATION, CONTENT_FEATURES, CONVENTION, CUSTOMER_KINDS, type Calibration, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type Consideration, type ContrastCheck, type ContrastReport, type CopySide, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, type CustomerKind, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DIRECTION_VERSIONS, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, FLAGGED_TARGET, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintHero, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, type GradientContrast, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, HUMAN_TYPICAL_TARGET, type HarvestCandidate, type HarvestOptions, type HeroImage, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, type ImageProvenance, type ImageRole, JSON_SCHEMA_VERSION, type JobContext, type JobMap, type JobPart, LABELS, LEXICAL_FEATURES, LICENCES, LIGHTNESS_CURVE, type Label, type LabelSummary, type LexicalFeatures, type LicenceEntry, type LicenceSubject, type LightnessBand, MIN_DECIDED, MIN_PARAGRAPHS, MIN_RUNS, MOOD, type MeasuredPage, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, OPENING_BANDS, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROFILE, PROFILE_MEASURED, PROFILE_PARAGRAPHS, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type PhotoReviewOptions, type PhotoReviewResult, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, REGISTERS, REGISTER_BASELINE, REGISTER_FEATURES, REGISTER_IDS, RENDERED_PATHS, RENDERED_TELLS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type Register, type RegisterCheck, type RegisterFeatures, type RegisterId, type RegisterProfile, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, SAMPLES_PER_SEGMENT, SCALE, SECTION_ROLES, SHADCN_LIMIT, SHADCN_PRIMITIVES, SHARED_PART, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPECIFICITY_COPY_TELLS, SPECIFICITY_RENDERED_TELLS, SPRING, STANDING_CLAIM, STOCK_AVATAR_HOSTS, STOCK_FIGURES, STOCK_PHOTO_HOSTS, STOCK_PHRASES, STUDY_WORDS, type SarifOptions, type SarifTell, type SectionGeometry, type SectionKind, type SectionRhythmOptions, type SectionRole, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShapeFeatures, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotImage, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Specific, type SpecificKind, type Specificity, type StudyWord, type Surface, TELL_HEAVY, TEMPERATURE_FULL, TEMPERATURE_NAMED, TEMPERATURE_WEIGHT, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type TargetCheck, type Tell, type TellException, type TellRate, type Temperature, type Tricolon, type TypeStep, type Typicality, type UnmeasuredPage, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, bandOf, briefTerms, calibrate, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkPhotoReview, checkReason, checkRegister, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, documentParagraphs, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, featureLabel, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, getRegister, globToRegExp, gradientContrast, gradientStops, groundDistance, groundLabel, groundName, groundTemperature, harvest, hedgeCount, hedgedClose, heroDistance, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, isFlagged, jobWords, layoutDistance, lexicalOf, licencesJson, makeSnapshot, motionTokens, namedSources, nearest, nominalisations, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, pageCopy, paletteFromPixels, paragraphUniformity, parseBaseline, parseColour, parseCraftConfig, parseHex, participialClauses, phrasalCoordinations, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, registerBrief, registerOf, registersDoc, renderedOrder, researchPrompt, retrofitPlan, rhythmDistance, rhythmOf, runTell, scanProvenance, scanSource, sectionRhythm, semantic, sentencesOf, severityExceptions, shapeMoves, shapeName, shapeOf, words as shapeWords, sharedParts, shouldAnimate, siblingLine, skeleton, skeletonRepeat, specificity, specifics, splitSentences, stackedConditional, stockAvatarSource, stockSource, summariseDirection, tailwindV3Preset, tailwindV4Theme, tellById, temperatureName, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateDirection, validateHierarchy, validateJob, visibleText, visualMeasures, vocabulary, vocabularyCounts, wcagContrast, wordListsJson };

package/dist/index.js

@@ -5031,7 +5031,7 @@ var RENDERED_PATHS = {
 };
 
 // src/fingerprint/index.ts
-var FINGERPRINT_VERSION = 2;
+var FINGERPRINT_VERSION = 3;
 var CHROMATIC = 0.03;
 var MIN_ACCENT_AREA = 2e4;
 var oklch = (value) => {
@@ -5067,6 +5067,24 @@ function median(values) {
   const mid = Math.floor(sorted.length / 2);
   return sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
 }
+var FULL_WIDTH_IMAGE = 0.8;
+function heroOf(s) {
+  const h1 = s.headings.find((h) => h.level === 1);
+  const inside = (top, x) => top >= x.top && top < x.top + x.height;
+  const index = (() => {
+    const withH1 = h1 ? s.sections.findIndex((x) => x.kind === "hero" && inside(h1.top, x)) : -1;
+    return withH1 >= 0 ? withH1 : s.sections.findIndex((x) => x.kind === "hero");
+  })();
+  if (index < 0) return void 0;
+  const section = s.sections[index];
+  const headline = h1 && inside(h1.top, section) ? { sizePx: h1.sizePx, weight: h1.weight, class: fontClass(normaliseFamily(h1.family)), italic: h1.italic || h1.italicPart } : null;
+  if (!s.images) return { headline };
+  const picture2 = s.images.filter((i) => (i.role === "photo" || i.role === "illustration") && (i.section === index || i.section === null && inside(i.top, section))).sort((a, b) => b.width * b.height - a.width * a.height)[0];
+  if (!picture2) return { headline, image: "none" };
+  if (picture2.left === void 0) return { headline };
+  const image = picture2.width >= FULL_WIDTH_IMAGE * s.viewport.width ? "full" : picture2.left + picture2.width / 2 < s.viewport.width / 2 ? "left" : "right";
+  return { headline, image };
+}
 function fingerprint(s) {
   const effects = [];
   if (s.effects.glass > 0) effects.push("glass-panel");
@@ -5078,6 +5096,7 @@ function fingerprint(s) {
   if (s.effects.eyebrowChip) effects.push("hero-eyebrow-chip");
   if (s.motion.introOverlay) effects.push("intro-cinematic");
   const below = s.sections.filter((x) => x.top > s.viewport.height).length;
+  const hero = heroOf(s);
   return {
     version: FINGERPRINT_VERSION,
     accent: accentOf(s),
@@ -5101,10 +5120,28 @@ function fingerprint(s) {
         carousel: x.carousel ?? false,
         figures: x.figures ?? 0
       }))
-    } : {}
+    } : {},
+    ...hero ? { hero } : {}
   };
 }
-var DISTANCE_WEIGHTS = { accent: 0.25, type: 0.25, ground: 0.1, shape: 0.1, motion: 0.1, effects: 0.1, layout: 0.1 };
+var WARM_HUE = [
+  [330, 360],
+  [0, 130]
+];
+var COOL_HUE = [[160, 310]];
+var TEMPERATURE_FULL = 6e-3;
+var TEMPERATURE_NAMED = 0.4;
+function groundTemperature(o) {
+  const h = (o.h % 360 + 360) % 360;
+  const within = (bands) => bands.some(([lo, hi]) => h >= lo && h < hi);
+  const strength = Math.min(1, o.c / TEMPERATURE_FULL);
+  return within(WARM_HUE) ? strength : within(COOL_HUE) ? -strength : 0;
+}
+function temperatureName(o) {
+  const t = groundTemperature(o);
+  return t >= TEMPERATURE_NAMED ? "warm" : t <= -TEMPERATURE_NAMED ? "cool" : "neutral";
+}
+var DISTANCE_WEIGHTS = { accent: 0.2, type: 0.2, ground: 0.1, shape: 0.1, motion: 0.05, effects: 0.1, layout: 0.1, rhythm: 0.1, hero: 0.05 };
 function levenshtein(a, b, cost = (x, y) => x === y ? 0 : 1) {
   const row = Array.from({ length: b.length + 1 }, (_, i) => i);
   for (let i = 1; i <= a.length; i += 1) {
@@ -5131,18 +5168,62 @@ function layoutDistance(a, b) {
   return longest === 0 ? 0 : levenshtein(a.layout, b.layout) / longest;
 }
 var clamp = (n) => Math.max(0, Math.min(1, n));
+function bandOf(l) {
+  return l < 0.4 ? "dark" : l >= 0.75 ? "light" : "mid";
+}
+function rhythmOf(fp) {
+  if (!fp.sections) return null;
+  const out = [];
+  for (const s of fp.sections) {
+    if (s.background === void 0) return null;
+    const band = bandOf((s.background ?? fp.ground).l);
+    if (out[out.length - 1] !== band) out.push(band);
+  }
+  return out;
+}
+var OPENING_BANDS = 3;
+function rhythmDistance(a, b) {
+  const ra = rhythmOf(a);
+  const rb = rhythmOf(b);
+  if (!ra || !rb) return null;
+  const over = (x, y) => {
+    const longest = Math.max(x.length, y.length);
+    return longest === 0 ? 0 : levenshtein(x, y) / longest;
+  };
+  return (over(ra.slice(0, OPENING_BANDS), rb.slice(0, OPENING_BANDS)) + over(ra, rb)) / 2;
+}
+var HEADLINE_OCTAVES = 1;
+function heroSection(fp) {
+  return fp.sections?.find((s) => s.role === "hero");
+}
+function heroDistance(a, b) {
+  const sa = heroSection(a);
+  const sb = heroSection(b);
+  if (!sa || !sb) return null;
+  const parts2 = [Math.abs(sa.centred - sb.centred), clamp(Math.abs(sa.width - sb.width) / 0.5)];
+  const ha = a.hero?.headline;
+  const hb = b.hero?.headline;
+  if (ha && hb) parts2.push(0.5 * (ha.class === hb.class ? 0 : 1) + 0.5 * clamp(Math.abs(Math.log2(ha.sizePx / hb.sizePx)) / HEADLINE_OCTAVES));
+  else if (a.hero && b.hero && (ha || hb)) parts2.push(1);
+  if (a.hero?.image && b.hero?.image) parts2.push(a.hero.image === b.hero.image ? 0 : 1);
+  return parts2.reduce((s, p) => s + p, 0) / parts2.length;
+}
 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 TEMPERATURE_WEIGHT = 0.6;
 var SHARED_PART = 0.2;
 var ACCENT_SHARED = ACCENT_SCALE * SHARED_PART;
 var GROUND_SHARED = GROUND_SCALE * SHARED_PART;
+function groundDistance(a, b) {
+  return clamp(deltaEOk(a, b) / GROUND_SCALE + TEMPERATURE_WEIGHT * Math.abs(groundTemperature(a) - groundTemperature(b)) / 2);
+}
 function fingerprintDistance(a, b) {
   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 ground = groundDistance(a.ground, b.ground);
   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));
@@ -5150,9 +5231,18 @@ function fingerprintDistance(a, b) {
   const shared = a.effects.filter((e) => b.effects.includes(e)).length;
   const effects = union.size === 0 ? 0 : 1 - shared / union.size;
   const layout = layoutDistance(a, b);
-  const parts2 = { accent, ground, type, shape, motion, effects, layout };
-  const total = Object.keys(DISTANCE_WEIGHTS).reduce((sum, k) => sum + DISTANCE_WEIGHTS[k] * parts2[k], 0);
-  return { total: Math.round(total * 1e3) / 1e3, parts: parts2 };
+  const rhythm = rhythmDistance(a, b);
+  const hero = heroDistance(a, b);
+  const parts2 = { accent, ground, type, shape, motion, effects, layout, rhythm, hero };
+  let sum = 0;
+  let weight = 0;
+  for (const k of Object.keys(DISTANCE_WEIGHTS)) {
+    const p = parts2[k];
+    if (p === null) continue;
+    sum += DISTANCE_WEIGHTS[k] * p;
+    weight += DISTANCE_WEIGHTS[k];
+  }
+  return { total: Math.round(sum / weight * 1e3) / 1e3, parts: parts2 };
 }
 function nearest(target2, set, k = set.length) {
   return set.map((item) => ({ id: item.id, distance: fingerprintDistance(target2, item.fingerprint) })).sort((x, y) => x.distance.total - y.distance.total).slice(0, k);
@@ -5230,6 +5320,12 @@ function groundName(o) {
   if (o.l >= 0.97 && o.c < 0.012) return "white";
   return o.c < 0.02 ? "grey" : "tinted";
 }
+function groundLabel(o) {
+  const name = groundName(o);
+  if (name === "cream" || name === "tinted") return name;
+  const temperature = temperatureName(o);
+  return temperature === "neutral" ? name : `${temperature} ${name}`;
+}
 function shapeName(roundness) {
   if (roundness === null) return "no buttons";
   if (roundness >= 0.45) return "pill";
@@ -8504,6 +8600,33 @@ var LICENCES = [
     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."
+  },
+  {
+    name: "Saira Semi Condensed",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-10-09",
+    source: "https://github.com/google/fonts/blob/main/ofl/sairasemicondensed/OFL.txt",
+    note: "Copyright 2016 The Saira Project Authors (omnibus.type@gmail.com), reserved font name Saira. Keep the OFL notice with the font files; a modified build may not be called Saira. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
+  },
+  {
+    name: "Public Sans",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-10-09",
+    source: "https://github.com/google/fonts/blob/main/ofl/publicsans/OFL.txt",
+    note: "Copyright 2015 The Public Sans Project Authors (https://github.com/uswds/public-sans). Keep the OFL notice with the font files. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
+  },
+  {
+    name: "Martian Mono",
+    subject: "face",
+    licence: "OFL-1.1",
+    multiClient: "yes",
+    checked: "2026-10-09",
+    source: "https://github.com/google/fonts/blob/main/ofl/martianmono/OFL.txt",
+    note: "Copyright 2021 The Martian Mono Project Authors (https://github.com/evilmartians/mono). Keep the OFL notice with the font files. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
   }
 ];
 function faceLicence(family) {
@@ -8870,7 +8993,7 @@ var PART_AREA = {
   effects: { area: "effects", choice: "motif" },
   motion: { area: "motion", choice: "signature" }
 };
-var DEFAULTS = /^(?:ground )?(?:white|grey)(?: ground)?$|no scroll reveals|no reveals|accent (?:none|neutral)|^no buttons|shape no buttons/;
+var DEFAULTS = /^(?:ground )?(?:white|grey|light)(?: ground)?$|no scroll reveals|no reveals|accent (?:none|neutral)|^no buttons|shape no buttons|^light page throughout$/;
 function designFindings(findings, copyTells) {
   return (findings?.findings ?? []).filter((f4) => !copyTells.has(f4.tell));
 }
@@ -8977,7 +9100,7 @@ function areaOfShared(part) {
   if (/accent|ground/.test(part)) return "colour";
   if (/buttons/.test(part)) return "shape";
   if (/reveal/.test(part)) return "motion";
-  if (/running order/.test(part)) return "layout";
+  if (/running order|hero|page throughout/.test(part)) return "layout";
   return "effects";
 }
 function choiceOfShared(part) {
@@ -8987,7 +9110,7 @@ function choiceOfShared(part) {
   if (/ground/.test(part)) return "ground";
   if (/buttons/.test(part)) return "shape";
   if (/reveal/.test(part)) return "signature";
-  return /running order/.test(part) ? void 0 : "motif";
+  return /running order|hero|page throughout/.test(part) ? void 0 : "motif";
 }
 
 // src/calibrate/index.ts
@@ -9094,19 +9217,45 @@ function addSite(register, site) {
   const sites = [...register.sites.filter((s) => s.id !== site.id), site].sort((a, b) => a.id.localeCompare(b.id));
   return { version: ESTATE_VERSION, sites };
 }
+function sharedGround(a, b) {
+  const [x, y] = [groundLabel(a.ground), groundLabel(b.ground)];
+  if (x === y) return `${x} ground`;
+  const temperature = temperatureName(a.ground);
+  if (temperature !== "neutral" && temperature === temperatureName(b.ground)) return `${temperature} ground`;
+  return `${a.ground.l < 0.3 ? "dark" : "light"} ground`;
+}
+function sharedRhythm(a, b) {
+  const bands = rhythmOf(a) ?? [];
+  const word = (band) => band;
+  if (bands.length <= 1) return `${bands[0] ? word(bands[0]) : "light"} page throughout`;
+  const second = bands[1] === "mid" ? "mid-tone band" : `${word(bands[1])} band`;
+  return `${word(bands[0])} hero then ${second}`;
+}
+function sharedHero(a, b) {
+  const hero = a.sections?.find((s) => s.role === "hero");
+  const placement = hero && hero.centred >= 0.5 ? "centred" : "left-aligned";
+  const headline = a.hero?.headline && b.hero?.headline && a.hero.headline.class === b.hero.headline.class ? `${a.hero.headline.class} ` : "";
+  const image = a.hero?.image && a.hero.image === b.hero?.image && a.hero.image !== "none" ? `, ${a.hero.image === "full" ? "full-width picture" : `photo ${a.hero.image}`}` : "";
+  return `${placement} ${headline}hero${image}`;
+}
 function sharedParts(a, b, d = fingerprintDistance(a, b)) {
   const out = [];
-  const close = (k) => d.parts[k] <= SHARED_PART;
+  const close = (k) => {
+    const p = d.parts[k];
+    return p !== null && p <= SHARED_PART;
+  };
   if (close("accent")) out.push(a.accent || b.accent ? `${hueName(a.accent)} accent` : "no accent");
   if (close("type")) {
     if (a.display.family === b.display.family) out.push(`${a.display.family} headline`);
     if (a.body.family === b.body.family) out.push(`${a.body.family} body`);
   }
-  if (close("ground")) out.push(`${groundName(a.ground)} ground`);
+  if (close("ground")) out.push(sharedGround(a, b));
   if (close("shape")) out.push(`${shapeName(a.roundness)} buttons`);
   if (close("motion")) out.push(a.motion > 0 || b.motion > 0 ? "scroll reveals" : "no reveals");
   if (close("effects") && a.effects.length) out.push(a.effects.filter((e) => b.effects.includes(e)).join(", "));
-  if (close("layout")) out.push("running order");
+  if (close("hero")) out.push(sharedHero(a, b));
+  if (close("rhythm")) out.push(sharedRhythm(a, b));
+  if (close("layout")) out.push("same running order");
   return out;
 }
 function compareToEstate(target2, register, options = {}) {
@@ -9245,6 +9394,7 @@ export {
   MOOD,
   NEGATIVE_REASSURANCE,
   NULL_VERSION,
+  OPENING_BANDS,
   PAGE_TYPES,
   PILL_LIMIT,
   PLAINER_WORDS,
@@ -9288,6 +9438,9 @@ export {
   STOCK_PHRASES,
   STUDY_WORDS,
   TELL_HEAVY,
+  TEMPERATURE_FULL,
+  TEMPERATURE_NAMED,
+  TEMPERATURE_WEIGHT,
   TRADE_NOUNS,
   TYPE_STEPS,
   TYPICAL_AT,
@@ -9299,6 +9452,7 @@ export {
   applyHouseGate,
   applySeverity,
   auditSnapshot,
+  bandOf,
   briefTerms,
   calibrate,
   catalogueTable,
@@ -9362,10 +9516,14 @@ export {
   globToRegExp,
   gradientContrast,
   gradientStops,
+  groundDistance,
+  groundLabel,
   groundName,
+  groundTemperature,
   harvest,
   hedgeCount,
   hedgedClose,
+  heroDistance,
   hexToOklch,
   holdHouseBlocks,
   houseRule,
@@ -9413,6 +9571,8 @@ export {
   renderedOrder,
   researchPrompt,
   retrofitPlan,
+  rhythmDistance,
+  rhythmOf,
   runTell,
   scanProvenance,
   scanSource,
@@ -9439,6 +9599,7 @@ export {
   tailwindV3Preset,
   tailwindV4Theme,
   tellById,
+  temperatureName,
   toGamut,
   toJson,
   toSarif,

package/licences.json

@@ -99,6 +99,33 @@
       "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."
+    },
+    {
+      "name": "Saira Semi Condensed",
+      "subject": "face",
+      "licence": "OFL-1.1",
+      "multiClient": "yes",
+      "checked": "2026-10-09",
+      "source": "https://github.com/google/fonts/blob/main/ofl/sairasemicondensed/OFL.txt",
+      "note": "Copyright 2016 The Saira Project Authors (omnibus.type@gmail.com), reserved font name Saira. Keep the OFL notice with the font files; a modified build may not be called Saira. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
+    },
+    {
+      "name": "Public Sans",
+      "subject": "face",
+      "licence": "OFL-1.1",
+      "multiClient": "yes",
+      "checked": "2026-10-09",
+      "source": "https://github.com/google/fonts/blob/main/ofl/publicsans/OFL.txt",
+      "note": "Copyright 2015 The Public Sans Project Authors (https://github.com/uswds/public-sans). Keep the OFL notice with the font files. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
+    },
+    {
+      "name": "Martian Mono",
+      "subject": "face",
+      "licence": "OFL-1.1",
+      "multiClient": "yes",
+      "checked": "2026-10-09",
+      "source": "https://github.com/google/fonts/blob/main/ofl/martianmono/OFL.txt",
+      "note": "Copyright 2021 The Martian Mono Project Authors (https://github.com/evilmartians/mono). Keep the OFL notice with the font files. Chosen for Doman Digital's own site (DOM-397, 9 October 2026)."
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.18.1",
+  "version": "0.19.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",
@@ -56,9 +56,10 @@
     "dist"
   ],
   "devDependencies": {
+    "@types/node": "^20.19.43",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3",
-    "vitest": "^2.1.9"
+    "vitest": "^4.0.0"
   },
   "engines": {
     "node": ">=22.12"