@domandigital/craft 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -706,7 +706,13 @@ declare const DENSITY_NAMES: DensityName[];
  * to a report and judged again later without a browser. Capturing one needs a
  * browser (see `@domandigital/craft/audit`); judging one does not.
  */
-declare const SNAPSHOT_VERSION = 1;
+/**
+ * 2 adds `role` and `geometry` per section, `rhythmVariance` for the page and
+ * the screenshot measures in `visual`. All four are optional: a version 1
+ * snapshot reads as version 2 without them (see `readSnapshot`), and nothing
+ * that judged a v1 snapshot judges it differently.
+ */
+declare const SNAPSHOT_VERSION = 2;
 interface SnapshotColour {
     /** `rgb(r, g, b)` or `rgba(r, g, b, a)`, as the browser computed it. */
     value: string;
@@ -745,6 +751,27 @@ interface SnapshotControl {
     text: string;
 }
 type SectionKind = "hero" | "logos" | "stats" | "cards" | "marquee" | "text" | "other";
+/**
+ * What a section is for, finer than `kind`. `kind` keeps its version 1
+ * meaning because the rendered tells, the null models and the estate were
+ * calibrated on it; `role` is what component-level comparison reads.
+ */
+type SectionRole = SectionKind | "cta-band" | "footer-cta" | "pricing" | "testimonials" | "faq" | "process" | "features" | "team" | "contact";
+/** How a section is laid out, measured, not judged. */
+interface SectionGeometry {
+    /** Share of the section's text blocks that are centred, 0 to 1. */
+    centredShare: number;
+    /** Content area balance about the vertical centre line: 1 mirror-even, 0 all on one side. */
+    mirrorSymmetry: number;
+    /** Share of the section's area with no text, image or control in it, 0 to 1. */
+    whitespaceRatio: number;
+    /** Width the content spans, over the viewport width. */
+    contentWidthRatio: number;
+    /** The painted background behind the section, as computed. */
+    background: string;
+    /** Buttons and button-styled links in the section. */
+    controls: number;
+}
 interface SnapshotSection {
     top: number;
     height: number;
@@ -757,6 +784,26 @@ interface SnapshotSection {
     iconCards: number;
     /** Hidden at load, waiting for a scroll to reveal it. */
     hiddenAtLoad: boolean;
+    /** Version 2. */
+    role?: SectionRole;
+    /** Version 2. */
+    geometry?: SectionGeometry;
+}
+/**
+ * Measures of the rendered pixels, from a full-page screenshot (capped at
+ * `height`). None of them passes or fails anything: they describe.
+ */
+interface SnapshotVisual {
+    /** Hasler and Süsstrunk (2003) colourfulness, M = σ_rgyb + 0.3 μ_rgyb, on 0-255 channels. Grey is 0. */
+    colourfulness: number;
+    /** Share of sampled pixels on a luminance edge: a complexity proxy, 0 to 1. */
+    edgeDensity: number;
+    /** 1 minus the mean luminance difference between each pixel and its left-right mirror, 0 to 1. */
+    symmetry: number;
+    width: number;
+    height: number;
+    /** Pixels actually read: large pages are sampled on a grid. */
+    sampled: number;
 }
 interface SnapshotGradient {
     /** Colour stops, as computed. */
@@ -811,6 +858,12 @@ interface Snapshot {
     sections: SnapshotSection[];
     effects: SnapshotEffects;
     motion: SnapshotMotion;
+    /** Version 2: coefficient of variation of the section heights. Null with fewer than two sections. */
+    rhythmVariance?: number | null;
+    /** Version 2: absent when the page could not be screenshotted. */
+    visual?: SnapshotVisual;
+    /** Set when a version 1 snapshot was read and upgraded in memory. */
+    migratedFrom?: 1;
     /** The design-system measures trawl has collected since v7, kept so it can switch to this. */
     metrics: {
         fontSizes: number[];
@@ -1031,7 +1084,7 @@ interface CheckReport {
  * Bumped whenever an entry is added, removed or its detection changes, so a
  * report can say which list it was judged against.
  */
-declare const CATALOGUE_VERSION = "2026.09.8";
+declare const CATALOGUE_VERSION = "2026.09.9";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -1112,6 +1165,31 @@ interface HouseRule {
 declare const HOUSE: Readonly<Record<string, HouseRule>>;
 /** The house rule for a copy tell. Unknown ids are review, so a new tell never blocks. */
 declare function houseRule(id: string, name?: string): HouseRule;
+/**
+ * What a repo may and may not do to the house gate.
+ *
+ * A repo can raise a tell's severity in `craft.config.json`, or except a
+ * design tell in `art-direction.json`. It cannot lower the blocking tier: a
+ * `warn` or `off` there, or an exception naming a blocking tell, would let one
+ * line and one sentence switch off a rule COPY.md calls not a judgment call,
+ * in every commit that repo makes. `chatbot-residue` is the sharpest case: it
+ * is evidence of a paste, and no client reason makes a paste acceptable.
+ *
+ * A genuine one-off (a style guide quoting an em dash, a testimonial) takes
+ * `copy-ok` on its line: local, in the diff a reviewer reads, and listed in
+ * every report. A rule that is wrong for everyone is changed here.
+ */
+declare const HOUSE_LOCKED = "the house blocking tier cannot be lowered by a repo. A genuine one-off takes copy-ok on its line; a rule that is wrong is changed in craft's house.ts and COPY.md";
+declare function holdHouseBlocks<E extends {
+    tell: string;
+}, O extends {
+    level: string;
+}>(exceptions: E[], severity: Record<string, O>): {
+    exceptions: E[];
+    severity: Record<string, O>;
+    refused: E[];
+    refusedSeverity: string[];
+};
 
 /**
  * Protected facts: what a rewrite must never lose or invent.
@@ -1411,6 +1489,41 @@ type FontClass = "serif" | "sans" | "mono" | "script" | "system";
 declare function normaliseFamily(raw: string): string;
 declare function fontClass(family: string): FontClass;
 
+/**
+ * Read a saved snapshot of any version this craft understands. Pure.
+ *
+ * Version 2 only added optional fields, so a version 1 snapshot is a valid
+ * version 2 snapshot without them. It is marked `migratedFrom: 1` so a report
+ * can say which measures it lacks, rather than reading their absence as zero.
+ */
+
+declare const READABLE_SNAPSHOT_VERSIONS: readonly [1, 2];
+declare function readSnapshot(data: unknown, source?: string): Snapshot;
+
+/**
+ * Measures of a screenshot's pixels. Pure: RGBA in, numbers out, no decoder
+ * and no browser, so it is tested on synthetic images.
+ *
+ * Only measures that need no model are here, after Miniukovich and De Angeli
+ * (2015, "Computation of interface aesthetics"): colourfulness, an edge-density
+ * complexity proxy, and left-right symmetry. None of them is a verdict. A
+ * sober site and a busy one can both be decided; these say which it is.
+ */
+
+interface RgbaImage {
+    width: number;
+    height: number;
+    /** Row-major, 4 bytes a pixel. */
+    rgba: Uint8Array;
+}
+/** A luminance step, on 0-255, that counts as an edge. About a 12% contrast change. */
+declare const EDGE_STEP = 32;
+/**
+ * Colourfulness, edge density and symmetry. Images over `maxSamples` pixels
+ * are read on a regular grid, and edges are taken between grid neighbours.
+ */
+declare function visualMeasures(img: RgbaImage, maxSamples?: number): SnapshotVisual;
+
 /**
  * A fingerprint: the handful of choices that make a site look like itself,
  * reduced to something two sites can be compared on.
@@ -1425,9 +1538,24 @@ declare function fontClass(family: string): FontClass;
  * Pure. Built from a Snapshot, so it describes what a visitor gets.
  */
 
-declare const FINGERPRINT_VERSION = 1;
+/**
+ * 2 adds `sections` (role and geometry in running order). A version 1
+ * fingerprint, or one from a version 1 snapshot, has none, and every
+ * 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.
+ */
+declare const FINGERPRINT_VERSION = 2;
+/** One section as layout comparison sees it. */
+interface FingerprintSection {
+    role: SectionRole;
+    /** Share of centred text, 0 to 1. */
+    centred: number;
+    /** Content width over viewport width, 0 to 1. */
+    width: number;
+}
 interface Fingerprint {
-    version: typeof FINGERPRINT_VERSION;
+    version: 1 | 2;
     /** The most prominent chromatic colour: button fills first, then painted area, then text. */
     accent: Oklch | null;
     ground: Oklch;
@@ -1447,6 +1575,8 @@ interface Fingerprint {
     effects: string[];
     /** Section kinds in running order, hero first. */
     layout: SectionKind[];
+    /** Version 2: present when every section carries a role and geometry. */
+    sections?: FingerprintSection[];
 }
 declare function fingerprint(s: Snapshot): Fingerprint;
 interface FingerprintDistance {
@@ -1476,6 +1606,8 @@ declare const DISTANCE_WEIGHTS: {
     readonly effects: 0.1;
     readonly layout: 0.1;
 };
+/** 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;
 declare function fingerprintDistance(a: Fingerprint, b: Fingerprint): FingerprintDistance;
 /**
  * The nearest neighbours of a fingerprint in a set, closest first. Typicality
@@ -1545,7 +1677,7 @@ declare function isCream({ l, c, h }: Oklch): boolean;
 /** The faces a model picks when the brief does not name one. */
 declare const REFLEX_FONTS_1: readonly ["Inter", "Roboto", "Open Sans", "Poppins", "Montserrat", "Lato"];
 /** What models moved to once Inter was named and banned. */
-declare const REFLEX_FONTS_2: readonly ["Inter Tight", "DM Sans", "Manrope", "Space Grotesk", "Plus Jakarta Sans", "Outfit", "Geist", "Sora", "Instrument Sans", "Instrument Serif", "Fraunces", "Playfair Display", "Cormorant Garamond", "DM Serif Display"];
+declare const REFLEX_FONTS_2: readonly ["Inter Tight", "DM Sans", "Manrope", "Space Grotesk", "Plus Jakarta Sans", "Outfit", "Geist", "Cal Sans", "Sora", "Instrument Sans", "Instrument Serif", "Fraunces", "Playfair Display", "Cormorant Garamond", "DM Serif Display"];
 /** Above this many scroll reveals in one scan, reveal is the default, not a choice. */
 declare const REVEAL_LIMIT = 12;
 /** Above this many fully rounded shapes in one scan, the pill is the shape language by accident. */
@@ -1688,6 +1820,48 @@ declare function initDirection(input: {
     exceptions?: ArtDirection["exceptions"];
 }): ArtDirection;
 
+/**
+ * What each face and icon set is licensed for, checked against the licensor's
+ * own page. A face a client site ships without a licence covering that site is
+ * a commercial risk the site owner carries, so `craft direction validate` warns
+ * on a display or body face this register does not know, or knows only as
+ * capped or unverified. Unverified is never a pass.
+ *
+ * This is a register of facts, not a shortlist. Nothing here is proposed to a
+ * site: a face chosen because it is on this list is the agency's own reflex
+ * font (CHARACTER.md, "Distance from the estate"). A face enters the register
+ * after a site has chosen it for a reason and someone has read its licence.
+ *
+ * `licences.json` is generated from this file for tools outside the package.
+ * Regenerate it with `pnpm --filter @domandigital/craft run docs`.
+ */
+type LicenceSubject = "face" | "foundry" | "icons";
+/**
+ * Whether one purchase covers the sites Doman Digital builds for unrelated
+ * clients. `yes`: it does. `capped`: up to `cap` sites. `per-site`: each client
+ * site needs its own licence, in the client's name. `unverified`: nobody has
+ * read the licensor's own terms yet.
+ */
+type MultiClient = "yes" | "capped" | "per-site" | "unverified";
+interface LicenceEntry {
+    /** The family name as CSS sets it, or the foundry or icon set's own name. */
+    name: string;
+    subject: LicenceSubject;
+    licence: string;
+    multiClient: MultiClient;
+    /** How many sites one licence covers, when `multiClient` is `capped`. */
+    cap?: number;
+    /** When the licensor's page was read, ISO date. */
+    checked: string;
+    /** The licensor's own page. Never an aggregator. */
+    source: string;
+    note: string;
+}
+declare const LICENCES: readonly LicenceEntry[];
+/** The register entry for a face, by the family name CSS sets. */
+declare function faceLicence(family: string): LicenceEntry | undefined;
+declare function licencesJson(): string;
+
 /**
  * Proposing an art direction from the client's world.
  *
@@ -2004,4 +2178,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type ContrastCheck, type ContrastReport, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE, HOUSE_BUDGET, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, JSON_SCHEMA_VERSION, LIGHTNESS_CURVE, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SarifOptions, type SarifTell, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareFacts, compareToEstate, craftTokens, createBaseline, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatHex, formatReport, globToRegExp, groundName, harvest, hexToOklch, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, namedSources, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseBaseline, parseColour, parseCraftConfig, parseHex, propose, protectedFacts, ramp, rampFromAnchors, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, severityExceptions, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, typeFeatureTokens, typicality, validateDirection, visibleText, wcagContrast, wordListsJson };
+export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type ContrastCheck, type ContrastReport, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, 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, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, JSON_SCHEMA_VERSION, LICENCES, LIGHTNESS_CURVE, type LicenceEntry, type LicenceSubject, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SarifOptions, type SarifTell, type SectionGeometry, type SectionKind, type SectionRhythmOptions, type SectionRole, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareFacts, compareToEstate, craftTokens, createBaseline, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatHex, formatReport, globToRegExp, groundName, harvest, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, layoutDistance, licencesJson, makeSnapshot, motionTokens, namedSources, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseBaseline, parseColour, parseCraftConfig, parseHex, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, severityExceptions, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, typeFeatureTokens, typicality, validateDirection, visibleText, visualMeasures, wcagContrast, wordListsJson };

package/dist/index.d.ts

@@ -706,7 +706,13 @@ declare const DENSITY_NAMES: DensityName[];
  * to a report and judged again later without a browser. Capturing one needs a
  * browser (see `@domandigital/craft/audit`); judging one does not.
  */
-declare const SNAPSHOT_VERSION = 1;
+/**
+ * 2 adds `role` and `geometry` per section, `rhythmVariance` for the page and
+ * the screenshot measures in `visual`. All four are optional: a version 1
+ * snapshot reads as version 2 without them (see `readSnapshot`), and nothing
+ * that judged a v1 snapshot judges it differently.
+ */
+declare const SNAPSHOT_VERSION = 2;
 interface SnapshotColour {
     /** `rgb(r, g, b)` or `rgba(r, g, b, a)`, as the browser computed it. */
     value: string;
@@ -745,6 +751,27 @@ interface SnapshotControl {
     text: string;
 }
 type SectionKind = "hero" | "logos" | "stats" | "cards" | "marquee" | "text" | "other";
+/**
+ * What a section is for, finer than `kind`. `kind` keeps its version 1
+ * meaning because the rendered tells, the null models and the estate were
+ * calibrated on it; `role` is what component-level comparison reads.
+ */
+type SectionRole = SectionKind | "cta-band" | "footer-cta" | "pricing" | "testimonials" | "faq" | "process" | "features" | "team" | "contact";
+/** How a section is laid out, measured, not judged. */
+interface SectionGeometry {
+    /** Share of the section's text blocks that are centred, 0 to 1. */
+    centredShare: number;
+    /** Content area balance about the vertical centre line: 1 mirror-even, 0 all on one side. */
+    mirrorSymmetry: number;
+    /** Share of the section's area with no text, image or control in it, 0 to 1. */
+    whitespaceRatio: number;
+    /** Width the content spans, over the viewport width. */
+    contentWidthRatio: number;
+    /** The painted background behind the section, as computed. */
+    background: string;
+    /** Buttons and button-styled links in the section. */
+    controls: number;
+}
 interface SnapshotSection {
     top: number;
     height: number;
@@ -757,6 +784,26 @@ interface SnapshotSection {
     iconCards: number;
     /** Hidden at load, waiting for a scroll to reveal it. */
     hiddenAtLoad: boolean;
+    /** Version 2. */
+    role?: SectionRole;
+    /** Version 2. */
+    geometry?: SectionGeometry;
+}
+/**
+ * Measures of the rendered pixels, from a full-page screenshot (capped at
+ * `height`). None of them passes or fails anything: they describe.
+ */
+interface SnapshotVisual {
+    /** Hasler and Süsstrunk (2003) colourfulness, M = σ_rgyb + 0.3 μ_rgyb, on 0-255 channels. Grey is 0. */
+    colourfulness: number;
+    /** Share of sampled pixels on a luminance edge: a complexity proxy, 0 to 1. */
+    edgeDensity: number;
+    /** 1 minus the mean luminance difference between each pixel and its left-right mirror, 0 to 1. */
+    symmetry: number;
+    width: number;
+    height: number;
+    /** Pixels actually read: large pages are sampled on a grid. */
+    sampled: number;
 }
 interface SnapshotGradient {
     /** Colour stops, as computed. */
@@ -811,6 +858,12 @@ interface Snapshot {
     sections: SnapshotSection[];
     effects: SnapshotEffects;
     motion: SnapshotMotion;
+    /** Version 2: coefficient of variation of the section heights. Null with fewer than two sections. */
+    rhythmVariance?: number | null;
+    /** Version 2: absent when the page could not be screenshotted. */
+    visual?: SnapshotVisual;
+    /** Set when a version 1 snapshot was read and upgraded in memory. */
+    migratedFrom?: 1;
     /** The design-system measures trawl has collected since v7, kept so it can switch to this. */
     metrics: {
         fontSizes: number[];
@@ -1031,7 +1084,7 @@ interface CheckReport {
  * Bumped whenever an entry is added, removed or its detection changes, so a
  * report can say which list it was judged against.
  */
-declare const CATALOGUE_VERSION = "2026.09.8";
+declare const CATALOGUE_VERSION = "2026.09.9";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -1112,6 +1165,31 @@ interface HouseRule {
 declare const HOUSE: Readonly<Record<string, HouseRule>>;
 /** The house rule for a copy tell. Unknown ids are review, so a new tell never blocks. */
 declare function houseRule(id: string, name?: string): HouseRule;
+/**
+ * What a repo may and may not do to the house gate.
+ *
+ * A repo can raise a tell's severity in `craft.config.json`, or except a
+ * design tell in `art-direction.json`. It cannot lower the blocking tier: a
+ * `warn` or `off` there, or an exception naming a blocking tell, would let one
+ * line and one sentence switch off a rule COPY.md calls not a judgment call,
+ * in every commit that repo makes. `chatbot-residue` is the sharpest case: it
+ * is evidence of a paste, and no client reason makes a paste acceptable.
+ *
+ * A genuine one-off (a style guide quoting an em dash, a testimonial) takes
+ * `copy-ok` on its line: local, in the diff a reviewer reads, and listed in
+ * every report. A rule that is wrong for everyone is changed here.
+ */
+declare const HOUSE_LOCKED = "the house blocking tier cannot be lowered by a repo. A genuine one-off takes copy-ok on its line; a rule that is wrong is changed in craft's house.ts and COPY.md";
+declare function holdHouseBlocks<E extends {
+    tell: string;
+}, O extends {
+    level: string;
+}>(exceptions: E[], severity: Record<string, O>): {
+    exceptions: E[];
+    severity: Record<string, O>;
+    refused: E[];
+    refusedSeverity: string[];
+};
 
 /**
  * Protected facts: what a rewrite must never lose or invent.
@@ -1411,6 +1489,41 @@ type FontClass = "serif" | "sans" | "mono" | "script" | "system";
 declare function normaliseFamily(raw: string): string;
 declare function fontClass(family: string): FontClass;
 
+/**
+ * Read a saved snapshot of any version this craft understands. Pure.
+ *
+ * Version 2 only added optional fields, so a version 1 snapshot is a valid
+ * version 2 snapshot without them. It is marked `migratedFrom: 1` so a report
+ * can say which measures it lacks, rather than reading their absence as zero.
+ */
+
+declare const READABLE_SNAPSHOT_VERSIONS: readonly [1, 2];
+declare function readSnapshot(data: unknown, source?: string): Snapshot;
+
+/**
+ * Measures of a screenshot's pixels. Pure: RGBA in, numbers out, no decoder
+ * and no browser, so it is tested on synthetic images.
+ *
+ * Only measures that need no model are here, after Miniukovich and De Angeli
+ * (2015, "Computation of interface aesthetics"): colourfulness, an edge-density
+ * complexity proxy, and left-right symmetry. None of them is a verdict. A
+ * sober site and a busy one can both be decided; these say which it is.
+ */
+
+interface RgbaImage {
+    width: number;
+    height: number;
+    /** Row-major, 4 bytes a pixel. */
+    rgba: Uint8Array;
+}
+/** A luminance step, on 0-255, that counts as an edge. About a 12% contrast change. */
+declare const EDGE_STEP = 32;
+/**
+ * Colourfulness, edge density and symmetry. Images over `maxSamples` pixels
+ * are read on a regular grid, and edges are taken between grid neighbours.
+ */
+declare function visualMeasures(img: RgbaImage, maxSamples?: number): SnapshotVisual;
+
 /**
  * A fingerprint: the handful of choices that make a site look like itself,
  * reduced to something two sites can be compared on.
@@ -1425,9 +1538,24 @@ declare function fontClass(family: string): FontClass;
  * Pure. Built from a Snapshot, so it describes what a visitor gets.
  */
 
-declare const FINGERPRINT_VERSION = 1;
+/**
+ * 2 adds `sections` (role and geometry in running order). A version 1
+ * fingerprint, or one from a version 1 snapshot, has none, and every
+ * 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.
+ */
+declare const FINGERPRINT_VERSION = 2;
+/** One section as layout comparison sees it. */
+interface FingerprintSection {
+    role: SectionRole;
+    /** Share of centred text, 0 to 1. */
+    centred: number;
+    /** Content width over viewport width, 0 to 1. */
+    width: number;
+}
 interface Fingerprint {
-    version: typeof FINGERPRINT_VERSION;
+    version: 1 | 2;
     /** The most prominent chromatic colour: button fills first, then painted area, then text. */
     accent: Oklch | null;
     ground: Oklch;
@@ -1447,6 +1575,8 @@ interface Fingerprint {
     effects: string[];
     /** Section kinds in running order, hero first. */
     layout: SectionKind[];
+    /** Version 2: present when every section carries a role and geometry. */
+    sections?: FingerprintSection[];
 }
 declare function fingerprint(s: Snapshot): Fingerprint;
 interface FingerprintDistance {
@@ -1476,6 +1606,8 @@ declare const DISTANCE_WEIGHTS: {
     readonly effects: 0.1;
     readonly layout: 0.1;
 };
+/** 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;
 declare function fingerprintDistance(a: Fingerprint, b: Fingerprint): FingerprintDistance;
 /**
  * The nearest neighbours of a fingerprint in a set, closest first. Typicality
@@ -1545,7 +1677,7 @@ declare function isCream({ l, c, h }: Oklch): boolean;
 /** The faces a model picks when the brief does not name one. */
 declare const REFLEX_FONTS_1: readonly ["Inter", "Roboto", "Open Sans", "Poppins", "Montserrat", "Lato"];
 /** What models moved to once Inter was named and banned. */
-declare const REFLEX_FONTS_2: readonly ["Inter Tight", "DM Sans", "Manrope", "Space Grotesk", "Plus Jakarta Sans", "Outfit", "Geist", "Sora", "Instrument Sans", "Instrument Serif", "Fraunces", "Playfair Display", "Cormorant Garamond", "DM Serif Display"];
+declare const REFLEX_FONTS_2: readonly ["Inter Tight", "DM Sans", "Manrope", "Space Grotesk", "Plus Jakarta Sans", "Outfit", "Geist", "Cal Sans", "Sora", "Instrument Sans", "Instrument Serif", "Fraunces", "Playfair Display", "Cormorant Garamond", "DM Serif Display"];
 /** Above this many scroll reveals in one scan, reveal is the default, not a choice. */
 declare const REVEAL_LIMIT = 12;
 /** Above this many fully rounded shapes in one scan, the pill is the shape language by accident. */
@@ -1688,6 +1820,48 @@ declare function initDirection(input: {
     exceptions?: ArtDirection["exceptions"];
 }): ArtDirection;
 
+/**
+ * What each face and icon set is licensed for, checked against the licensor's
+ * own page. A face a client site ships without a licence covering that site is
+ * a commercial risk the site owner carries, so `craft direction validate` warns
+ * on a display or body face this register does not know, or knows only as
+ * capped or unverified. Unverified is never a pass.
+ *
+ * This is a register of facts, not a shortlist. Nothing here is proposed to a
+ * site: a face chosen because it is on this list is the agency's own reflex
+ * font (CHARACTER.md, "Distance from the estate"). A face enters the register
+ * after a site has chosen it for a reason and someone has read its licence.
+ *
+ * `licences.json` is generated from this file for tools outside the package.
+ * Regenerate it with `pnpm --filter @domandigital/craft run docs`.
+ */
+type LicenceSubject = "face" | "foundry" | "icons";
+/**
+ * Whether one purchase covers the sites Doman Digital builds for unrelated
+ * clients. `yes`: it does. `capped`: up to `cap` sites. `per-site`: each client
+ * site needs its own licence, in the client's name. `unverified`: nobody has
+ * read the licensor's own terms yet.
+ */
+type MultiClient = "yes" | "capped" | "per-site" | "unverified";
+interface LicenceEntry {
+    /** The family name as CSS sets it, or the foundry or icon set's own name. */
+    name: string;
+    subject: LicenceSubject;
+    licence: string;
+    multiClient: MultiClient;
+    /** How many sites one licence covers, when `multiClient` is `capped`. */
+    cap?: number;
+    /** When the licensor's page was read, ISO date. */
+    checked: string;
+    /** The licensor's own page. Never an aggregator. */
+    source: string;
+    note: string;
+}
+declare const LICENCES: readonly LicenceEntry[];
+/** The register entry for a face, by the family name CSS sets. */
+declare function faceLicence(family: string): LicenceEntry | undefined;
+declare function licencesJson(): string;
+
 /**
  * Proposing an art direction from the client's world.
  *
@@ -2004,4 +2178,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type ContrastCheck, type ContrastReport, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE, HOUSE_BUDGET, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, JSON_SCHEMA_VERSION, LIGHTNESS_CURVE, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SarifOptions, type SarifTell, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareFacts, compareToEstate, craftTokens, createBaseline, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatHex, formatReport, globToRegExp, groundName, harvest, hexToOklch, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, namedSources, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseBaseline, parseColour, parseCraftConfig, parseHex, propose, protectedFacts, ramp, rampFromAnchors, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, severityExceptions, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, typeFeatureTokens, typicality, validateDirection, visibleText, wcagContrast, wordListsJson };
+export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type ContrastCheck, type ContrastReport, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, 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, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, JSON_SCHEMA_VERSION, LICENCES, LIGHTNESS_CURVE, type LicenceEntry, type LicenceSubject, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SarifOptions, type SarifTell, type SectionGeometry, type SectionKind, type SectionRhythmOptions, type SectionRole, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareFacts, compareToEstate, craftTokens, createBaseline, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatHex, formatReport, globToRegExp, groundName, harvest, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, layoutDistance, licencesJson, makeSnapshot, motionTokens, namedSources, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseBaseline, parseColour, parseCraftConfig, parseHex, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, severityExceptions, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, typeFeatureTokens, typicality, validateDirection, visibleText, visualMeasures, wcagContrast, wordListsJson };