@domandigital/craft 0.18.2 → 0.19.1

package/dist/index.d.cts

@@ -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.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 };