@domandigital/craft 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -788,6 +788,57 @@ interface SnapshotSection {
     role?: SectionRole;
     /** Version 2. */
     geometry?: SectionGeometry;
+    /** Version 2: short pill or label texts in the section ("Most popular", "New"), at most 5. */
+    badges?: string[];
+    /** Version 2: small round portraits (at most 96px, roughly square, radius 40% or more). */
+    avatars?: number;
+    /** Version 2: a horizontal scroller, snap track or prev/next control holds the content. */
+    carousel?: boolean;
+    /** Version 2: large standalone figures ("500+", "98%", "4.9/5") at 24px or more. */
+    figures?: number;
+    /**
+     * Version 2, craft 0.13 and later: the section's visible text, one block per
+     * heading, paragraph, list item or quote, each at most 300 characters, at
+     * most 40. Navigation, buttons and footers are left out. What the
+     * specificity and proof tells read.
+     */
+    text?: string[];
+}
+type ImageRole = "photo" | "illustration" | "icon" | "avatar" | "logo";
+/**
+ * What the image's own bytes say about where it came from. Only a positive
+ * is evidence: most images carry no metadata at all, and a re-encode strips
+ * it, so no marker proves nothing.
+ */
+interface ImageProvenance {
+    /** The IPTC digital source type found, if any: "trainedAlgorithmicMedia" or "compositeWithTrainedAlgorithmicMedia". */
+    digitalSourceType: string | null;
+    /** Where the marker sat: an XMP packet, a C2PA manifest, or somewhere else in the file. */
+    source: "xmp" | "c2pa" | "other" | null;
+    /** The file carries a C2PA manifest (Content Credentials), whatever it says. */
+    c2pa: boolean;
+    /** Bytes read, from the start of the file. */
+    bytes: number;
+}
+/** One image as the visitor sees it: an `img`, or a CSS background large enough to be a picture. */
+interface SnapshotImage {
+    /** The URL the browser loaded, unwrapped from an image optimiser (`/_next/image?url=`), or a `data:` URI cut to 64 characters. */
+    src: string;
+    /** Host of `src`, or null for a `data:` URI. */
+    host: string | null;
+    width: number;
+    height: number;
+    top: number;
+    role: ImageRole;
+    alt: string | null;
+    /** Empty alt, `aria-hidden` or `role="presentation"`. */
+    decorative: boolean;
+    /** Index into `sections`, or null when the image sits outside them. */
+    section: number | null;
+    /** A CSS `background-image`, not an `img`. */
+    background: boolean;
+    /** Present when the bytes were read. */
+    provenance?: ImageProvenance;
 }
 /**
  * Measures of the rendered pixels, from a full-page screenshot (capped at
@@ -862,6 +913,18 @@ interface Snapshot {
     rhythmVariance?: number | null;
     /** Version 2: absent when the page could not be screenshotted. */
     visual?: SnapshotVisual;
+    /**
+     * Version 2, craft 0.13 and later: every image on the page, largest first, at
+     * most 60. Absent in older snapshots, which the imagery tells never judge.
+     */
+    images?: SnapshotImage[];
+    /**
+     * Version 2, craft 0.13 and later: the text a visitor reads before
+     * scrolling, at most 12 blocks. Navigation, a header without the headline,
+     * and the words on buttons and links are left out: this is the page's
+     * claim, not its menu or its calls to action.
+     */
+    firstScreenText?: string[];
     /** 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. */
@@ -899,7 +962,13 @@ interface Snapshot {
  */
 type Generation = 1 | 2 | 3;
 /** Where a tell is detected first. A source tell may also carry a rendered path. */
-type Surface = "source" | "copy";
+/**
+ * Where a tell is detected first. `rendered` tells exist only on a rendered
+ * page (a pricing trio, a centred CTA band): source code cannot show them
+ * reliably, so they have no source detector and no source fixtures, only a
+ * rendered path with its own flag and pass snapshots.
+ */
+type Surface = "source" | "copy" | "rendered";
 /**
  * `warn` is reported and never fails a run unless `--strict` is passed.
  * `block` fails a run.
@@ -1019,7 +1088,12 @@ interface CopyTell extends TellBase {
     surface: "copy";
     detect(ctx: CopyContext): Hit[];
 }
-type Tell = SourceTell | CopyTell;
+/** A tell with a rendered path only. See `Surface`. */
+interface RenderedTell extends Omit<TellBase, "fixtures" | "rendered"> {
+    surface: "rendered";
+    rendered: RenderedPath;
+}
+type Tell = SourceTell | CopyTell | RenderedTell;
 /**
  * A declared reason to keep a tell. Lives in the site's `art-direction.json`.
  *
@@ -1084,7 +1158,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.9";
+declare const CATALOGUE_VERSION = "2026.09.12";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -1266,6 +1340,154 @@ declare function namedSources(sentence: string): string[];
 declare function findClaims(files: SourceFile[]): ClaimsReport;
 declare function formatClaims(report: ClaimsReport, label?: string): string;
 
+/**
+ * Specificity: how much of a page only this business could have written.
+ *
+ * "Quality you can trust" fits every site in every trade. "Boilers fixed the
+ * same day in Brackley, from £85" fits one. The difference is countable: names,
+ * places, numbers, prices, dates, and the nouns of the trade. A page built
+ * from no brief has almost none, because the model had none to give.
+ *
+ * Pure over text. Two things keep the count honest:
+ *
+ * - A Title Case or all-capitals line carries no capital-letter information,
+ *   so its capitals are not read as names ("Quality You Can Trust" is not a
+ *   proper noun). Its numbers, trade nouns and brief terms still count.
+ * - The stock figures every site uses ("24/7", "100%", "5-star", "No. 1") are
+ *   masked before counting. They are numbers, not specifics.
+ *
+ * A brief (from `--brief`, `art-direction.json` or a null model) adds its own
+ * terms: the business's name, its town and its trade, recognised wherever
+ * they appear, even at the start of a sentence or in a shouted heading.
+ */
+
+type SpecificKind = FactKind | "trade" | "brief";
+interface Specific {
+    kind: SpecificKind;
+    /** As written. */
+    value: string;
+    /** Lower case, for comparing across pages. */
+    key: string;
+}
+interface Specificity {
+    words: number;
+    /** Each distinct specific once: repeating a town ten times does not make a page ten times more particular. */
+    specifics: Specific[];
+    /** Specifics that are not trade nouns: a name, place, number, price, date, contact detail or brief term. */
+    hard: number;
+    /** Distinct trade nouns. */
+    trade: number;
+    /** Distinct specifics per 100 words, to one decimal place. */
+    perHundred: number;
+    /**
+     * No hard specific and fewer than two trade nouns. One trade noun alone
+     * ("quality plumbing you can trust") is what every competitor in the trade
+     * also says.
+     */
+    generic: boolean;
+}
+/**
+ * Concrete nouns of the work, across the trades and local services the estate
+ * builds for. A seed list, grown from what the null models and client sites
+ * show. Deliberately absent: "services", "solutions", "projects", "work",
+ * "quality", which say nothing about what is done.
+ */
+declare const TRADE_NOUNS: readonly string[];
+/**
+ * Stock figures: numbers every site in every trade uses, masked before
+ * counting so they cannot pass for a fact.
+ */
+declare const STOCK_FIGURES: readonly RegExp[];
+declare const countWords: (text: string) => number;
+/**
+ * The brief's own terms: its names and places (capitalised words, even at the
+ * start of a sentence), its numbers, and its trade nouns.
+ */
+declare function briefTerms(brief: string): string[];
+/** Every distinct specific in the text. Lines are read one at a time: pass blocks separated by newlines. */
+declare function specifics(text: string, brief?: string): Specific[];
+/** How particular a text is. Pure. */
+declare function specificity(text: string, brief?: string): Specificity;
+/** What a page says where it makes its case: the first screen, and the sections that sell the work. */
+interface PageCopy {
+    url: string;
+    hero: string[];
+    services: string[];
+    /** Every line of page text: what the other page is checked against. */
+    all: string[];
+}
+/** Blocks as sentences, short fragments dropped. */
+declare function sentencesOf(blocks: string[]): string[];
+/**
+ * The hero and service copy of a snapshot. Null when the snapshot has no page
+ * text: one taken before craft recorded it.
+ */
+declare function pageCopy(snapshot: Snapshot): PageCopy | null;
+interface CopySide {
+    url: string;
+    /** Hero and service sentences read. */
+    sentences: number;
+    /** Of those, how many hold nothing the other page does not also say. */
+    interchangeable: string[];
+    /** interchangeable / sentences, or null with no sentences. */
+    share: number | null;
+    /** Specificity of the hero and service copy together. */
+    perHundred: number;
+}
+interface CompetitorComparison {
+    ours: CopySide;
+    competitor: CopySide;
+    /** A brief's terms were recognised on both pages. */
+    brief: boolean;
+}
+/**
+ * Which hero and service sentences either page could swap with the other:
+ * each holds no specific the other page lacks. A shared town or trade noun is
+ * not unique; the business's own name, its prices and its jobs are. Pure.
+ */
+declare function compareCompetitor(ours: PageCopy, competitor: PageCopy, brief?: string): CompetitorComparison;
+declare function formatCompetitor(result: CompetitorComparison): string;
+
+/**
+ * Specificity tells: a page that could belong to anyone.
+ *
+ * A model given no brief writes the claim every site makes, because it has
+ * nothing particular to say: "Quality you can trust", "Your vision, our
+ * expertise". And it asserts standing ("trusted", "fully qualified",
+ * "award-winning") with nothing next to the assertion to back it, because it
+ * has no reviews and no registration number to put there.
+ *
+ * Both are read from what the page says, not how it looks: `specificity.ts`
+ * counts the particulars.
+ */
+
+/**
+ * The home page's source, where the first claim is made: a root route file
+ * (`app/page.tsx`, `pages/index.tsx`, `src/pages/index.astro`, SvelteKit's
+ * root `+page.svelte`), a top-level `index.html`, or a hero or home component.
+ * Every other page's headline is a label ("Privacy policy", "Boiler
+ * repairs"), not a claim, and is not judged.
+ */
+declare const HOME_FILE: RegExp;
+/** A home page URL: the site root, `index.html`, or a locale root such as `/en-gb/`. */
+declare const HOME_URL: RegExp;
+/**
+ * A claim of standing: what a visitor has to take on trust unless something
+ * next to it backs it. Numbers of years are left out: those are checkable
+ * facts, and `craft copy claims` lists them.
+ */
+declare const STANDING_CLAIM: RegExp;
+/** Accreditation bodies, trade registers and review platforms, by the names they trade under. */
+declare const PROOF_NAMES: readonly string[];
+/** Every claim of standing with no review or accreditation in its section or the one either side. */
+declare function unprovenClaims(s: Snapshot): {
+    claim: string;
+    sentence: string;
+    section: string;
+}[];
+declare const SPECIFICITY_COPY_TELLS: CopyTell[];
+declare const SPECIFICITY_RENDERED_TELLS: RenderedTell[];
+
 /**
  * Baselines: adopt craft on a repo that already has findings, and fail only
  * on new ones.
@@ -1463,6 +1685,71 @@ declare function toJson(data: object): string;
 
 declare const RENDERED_PATHS: Record<string, RenderedPath>;
 
+/**
+ * Tells that exist only on a rendered page: the stock components.
+ *
+ * A pricing trio with a "Most popular" badge, a centred band with one button,
+ * an avatar carousel of testimonials: none of these is visible in one source
+ * file, and all of them are visible on the page. They read the version 2
+ * snapshot's `role`, `geometry` and section parts, so a version 1 snapshot
+ * never trips them.
+ *
+ * Each changes the look, never the page grammar. The fix for a stock pricing
+ * trio keeps the prices; the fix for a stock band keeps the call to action.
+ */
+
+declare const RENDERED_TELLS: RenderedTell[];
+
+/**
+ * Imagery and provenance: what the pictures on a rendered page say about
+ * where they came from.
+ *
+ * A page built with no assets reaches for three things: a stock library, a
+ * generator, or no pictures at all and a grid of icons where the work should
+ * be. Each is visible in the snapshot's `images`. A snapshot taken before
+ * craft recorded images has none, and none of these tells judges it.
+ *
+ * Each fix keeps the page's job and changes the evidence: a photo of the
+ * client's own work in place of a library one.
+ */
+
+/** Stock libraries and placeholder services, by the domain they serve images from. */
+declare const STOCK_PHOTO_HOSTS: Readonly<Record<string, string>>;
+/** Services that hand out a face on request: placeholder portraits and generated people. */
+declare const STOCK_AVATAR_HOSTS: Readonly<Record<string, string>>;
+/** Where a stock picture came from, by host or by file name, or null. */
+declare function stockSource(image: Pick<SnapshotImage, "src" | "host">): string | null;
+/** The placeholder-face service an avatar came from, or a stock library, or null. */
+declare function stockAvatarSource(image: Pick<SnapshotImage, "src" | "host">): string | null;
+declare const IMAGERY_TELLS: RenderedTell[];
+
+/**
+ * Where an image came from, as far as its own bytes say.
+ *
+ * Generators that label their output do it in one of two places: an XMP
+ * packet (Adobe's metadata format, in JPEG, PNG, WebP and AVIF) or a C2PA
+ * manifest (Content Credentials, a JUMBF box). Both name the IPTC digital
+ * source type, and two of its values mean a trained model made the picture:
+ *
+ *   http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia
+ *   http://cv.iptc.org/newscodes/digitalsourcetype/compositeWithTrainedAlgorithmicMedia
+ *
+ * This is a byte scan with no parser and no dependency: the IRI is plain text
+ * in XMP and a CBOR text string in C2PA, so it reads the same either way.
+ *
+ * Only a positive is evidence. Most images carry no metadata, every CMS and
+ * image optimiser that re-encodes strips it, and a PNG can keep its metadata
+ * after the pixels, beyond what is read. No marker proves nothing, and this
+ * never says an image is real.
+ */
+
+/** Bytes read from the start of a file. JPEG and WebP metadata sit well inside it. */
+declare const PROVENANCE_SCAN_BYTES: number;
+/** The IPTC digital source types that mean a trained model made the image, most specific first. */
+declare const AI_SOURCE_TYPES: readonly ["compositeWithTrainedAlgorithmicMedia", "trainedAlgorithmicMedia"];
+/** Read an image's leading bytes for an AI digital source type. Pure. */
+declare function scanProvenance(bytes: Uint8Array): ImageProvenance;
+
 /**
  * A plain, decided-looking page as a snapshot, for fixtures.
  *
@@ -1553,6 +1840,21 @@ interface FingerprintSection {
     centred: number;
     /** Content width over viewport width, 0 to 1. */
     width: number;
+    /** Left-right balance of the content, 0 to 1. Component comparison only. */
+    symmetry?: number;
+    /** Buttons in the section. */
+    controls?: number;
+    /** Cards side by side. */
+    cards?: number;
+    /** The section's own background, or null when it is the page ground. */
+    background?: Oklch | null;
+    /** Badge texts ("Most popular"), lower-cased. */
+    badges?: string[];
+    /** Small round portraits. */
+    avatars?: number;
+    carousel?: boolean;
+    /** Large standalone figures. */
+    figures?: number;
 }
 interface Fingerprint {
     version: 1 | 2;
@@ -1621,6 +1923,270 @@ declare function nearest<T>(target: Fingerprint, set: {
     distance: FingerprintDistance;
 }[];
 
+/**
+ * The estate register: every site the agency has shipped, fingerprinted, so a
+ * new one can be checked against its siblings. Signal 3 of CHARACTER.md.
+ *
+ * An agency's biggest tell is its clients looking like each other. No single
+ * site shows it; only the set does. So the register holds one fingerprint per
+ * site, and `compareToEstate` says which sites a page sits nearest and what
+ * it shares with them.
+ *
+ * The line for "siblings" is not a number picked here. Two different
+ * businesses are siblings when they sit closer together than two pages Claude
+ * builds for the same brief usually do: if a barber and an electrician look
+ * more alike than two drafts of one barber, nobody chose either look. The
+ * median comes from null models when they are given, and from the 2026-09-23
+ * calibration when they are not.
+ *
+ * Pure. The CLI reads and writes the register file.
+ */
+
+declare const ESTATE_VERSION = 1;
+/**
+ * Median fingerprint distance between two null pages built from the same
+ * brief, across seven briefs and 1,330 pairs (calibration/null, 2026-09-23).
+ */
+declare const SIBLING_AT = 0.31;
+interface EstateSite {
+    /** Short kebab-case id: "rmp", "chair-and-blade". */
+    id: string;
+    client: string;
+    url: string;
+    /** Where the site's source lives, if known: "rmp474/RMP-Electrical". */
+    repo?: string;
+    fingerprint: Fingerprint;
+    /** Rendered tells found when it was added, for the record. */
+    tells: string[];
+    addedAt: string;
+}
+interface EstateRegister {
+    version: typeof ESTATE_VERSION;
+    sites: EstateSite[];
+}
+declare function emptyEstate(): EstateRegister;
+/** Add a site, or replace the one with the same id. Sorted by id so the file diffs cleanly. */
+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 0.2 or less.
+ */
+declare function sharedParts(a: Fingerprint, b: Fingerprint, d?: FingerprintDistance): string[];
+interface EstateMatch {
+    id: string;
+    distance: number;
+    sibling: boolean;
+    shared: string[];
+}
+/** The sites nearest a fingerprint, closest first, leaving out `exclude` (the site itself). */
+declare function compareToEstate(target: Fingerprint, register: EstateRegister, options?: {
+    exclude?: string;
+    siblingAt?: number;
+}): EstateMatch[];
+interface EstatePair {
+    a: string;
+    b: string;
+    distance: number;
+    sibling: boolean;
+    shared: string[];
+}
+/** Every pair in the register, closest first. */
+declare function estatePairs(register: EstateRegister, siblingAt?: number): EstatePair[];
+/**
+ * The sibling line from null models: the median distance between two pages
+ * built from the same brief. Each inner array is one brief's fingerprints.
+ */
+declare function siblingLine(briefs: Fingerprint[][]): number;
+
+/**
+ * The counterfactual: what a model builds for this brief when nobody tells it
+ * anything else. Signal 2 of CHARACTER.md.
+ *
+ * A null model is about twenty pages generated from one brief, each reduced to
+ * a fingerprint. A site is typical when it sits as close to those pages as they
+ * sit to each other. That question keeps working when model defaults move,
+ * which a fixed list of tells cannot: ban Inter and the null model moves with
+ * the model, so the comparison moves too.
+ *
+ * `harvest` reads the same pages the other way round: which choices recur
+ * across them that the catalogue does not know yet. Those are the candidates
+ * for the next generation of tells. A person decides; nothing is added here.
+ *
+ * Pure. Generating pages and snapshotting them lives in the CLI.
+ */
+
+declare const NULL_VERSION = 1;
+/**
+ * The prompt a null run gets: the brief, and nothing about how it should look.
+ * Changing this changes every null model built after it, so it is versioned
+ * by being recorded in each one.
+ */
+declare function nullPrompt(brief: string): string;
+interface NullRun {
+    /** The page's file name without extension: "01". */
+    id: string;
+    fingerprint: Fingerprint;
+    /** Catalogue tells found on the page, source and rendered, each once. */
+    tells: string[];
+    /** Every visible string on the page, for the phrase harvest. */
+    copy: string[];
+}
+interface NullModel {
+    version: typeof NULL_VERSION;
+    brief: string;
+    prompt: string;
+    /** What was asked for with --model, or "default". */
+    model: string;
+    catalogueVersion: string;
+    builtAt: string;
+    runs: NullRun[];
+}
+/** The HTML document in a model's reply, without code fences or commentary. */
+declare function extractHtml(reply: string): string | null;
+/** Fewer runs than this and the spread of the null is noise, so nothing is judged. */
+declare const MIN_RUNS = 5;
+/** Typical when at least this share of the null's own pages sit further out. */
+declare const TYPICAL_AT = 0.1;
+interface Typicality {
+    /**
+     * 0 to 1: the share of the null's own pages that sit further from the rest
+     * than this page sits from them. 1 is more typical than anything the model
+     * built; 0 is further out than every one of them.
+     */
+    score: number;
+    typical: boolean;
+    /** Mean distance to the k nearest null pages. */
+    distance: number;
+    /** The same measure for each null page against the others, median. */
+    baseline: number;
+    nearest: {
+        id: string;
+        distance: number;
+    }[];
+    /** The choices this page shares with most of the null: why it reads as typical. */
+    shared: {
+        part: string;
+        value: string;
+        runs: number;
+        of: number;
+    }[];
+}
+/**
+ * How typical a page is against one or more null models (pooled). Every null
+ * page is scored against the others the same way, leaving itself out, so the
+ * threshold comes from the model's own spread and not from a number picked
+ * here: a page drawn from the null is flagged nine times in ten by
+ * construction, and the calibration checks whether real sites are not.
+ */
+declare function typicality(target: Fingerprint, runs: NullRun[], k?: number): Typicality;
+declare function hueName(o: Oklch | null): string;
+declare function groundName(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[]>;
+type CandidateKind = "face" | "accent" | "ground" | "shape" | "motion" | "opening" | "tell" | "phrase";
+interface HarvestCandidate {
+    kind: CandidateKind;
+    value: string;
+    /** Null pages that make this choice, across every model given. */
+    runs: number;
+    of: number;
+    /** Distinct briefs it turned up for. A habit shows across briefs; a brief's own words do not. */
+    briefs: number;
+    /** The catalogue tell that already catches it, or null when nothing does. */
+    known: string | null;
+    /** An example, for a phrase: the string it came from. */
+    example?: string;
+}
+interface HarvestOptions {
+    /** Report a choice made by at least this share of pages. Default 0.25. */
+    minShare?: number;
+    /** Which copy tell, if any, already catches a phrase. The CLI passes the catalogue's. */
+    copyTell?: (phrase: string) => string | null;
+}
+/**
+ * Choices that recur across null pages, with the tell that already catches
+ * each, if any. The ones with `known: null` are the next generation's
+ * candidates. Nothing here decides: a person reads them, and a candidate only
+ * becomes a tell with a flag case and a pass case like every other.
+ */
+declare function harvest(models: Pick<NullModel, "brief" | "runs">[], options?: HarvestOptions): HarvestCandidate[];
+/** A representative colour for a hue family, for a report. */
+declare function hueSwatch(runs: NullRun[], hue: string): string | null;
+
+/**
+ * Component-level sameness: the CTA band, the pricing table, the testimonial
+ * strip, compared one kind at a time.
+ *
+ * The page fingerprint can say two sites look alike overall. It cannot say
+ * "every site in the estate ends on the same centred band with one orange
+ * button". That is the sameness a client notices when they put two of the
+ * agency's sites side by side, and it lives in the components.
+ *
+ * Pure, over the `sections` of version 2 fingerprints. A version 1
+ * fingerprint has none, so it simply has no components to compare.
+ */
+
+/** Badge texts that promote one option over the others. */
+declare const PROMO_BADGE: RegExp;
+/** The sections of one role in a fingerprint, in running order. */
+declare function componentsOf(fp: Fingerprint, role: SectionRole): FingerprintSection[];
+/**
+ * 0 (the same recipe) to 1 (nothing in common), over the parts both
+ * components carry: layout (centring, width, balance), furniture (buttons,
+ * cards, figures, avatars, carousel, a promo badge) and colour (its own
+ * ground or the page's). Different roles are 1: a pricing table and an FAQ
+ * are not the same component however they are laid out.
+ */
+declare function componentDistance(a: FingerprintSection, b: FingerprintSection): number;
+/** What two components share, as a person would name it. */
+declare function componentShared(a: FingerprintSection, b: FingerprintSection): string[];
+/** The closest pair of components of one role between two fingerprints. */
+declare function closestComponents(a: Fingerprint, b: Fingerprint, role: SectionRole): {
+    distance: number;
+    shared: string[];
+} | null;
+interface ComponentPair {
+    a: string;
+    b: string;
+    distance: number;
+    shared: string[];
+}
+/**
+ * Every pair of estate sites that both have a component of this role, closest
+ * first. No sibling line yet: that needs a calibration set of real
+ * components, so this ranks and names, and judges nothing.
+ */
+declare function estateComponentPairs(register: EstateRegister, role: SectionRole): ComponentPair[];
+interface ComponentTypicality {
+    role: SectionRole;
+    score: number;
+    typical: boolean;
+    distance: number;
+    baseline: number;
+    /** How many null pages had a component of this role to compare with. */
+    runs: number;
+}
+/**
+ * How typical one component is against the same role in a null model, by
+ * the method `typicality` uses for whole pages: each null component is scored
+ * against the others leaving itself out, and the page's component is placed
+ * in that spread. Null when fewer than `MIN_RUNS` null pages have the role.
+ */
+declare function componentTypicality(target: FingerprintSection, runs: NullRun[], k?: number): ComponentTypicality | null;
+/**
+ * The roles that name a component rather than a generic block: what
+ * `--component` accepts and what `craft audit --null` scores one by one.
+ */
+declare const COMPONENT_ROLES: readonly SectionRole[];
+/**
+ * Typicality for each component on a page that the null model can speak to:
+ * the first section of each component role, skipping roles too few null
+ * pages have.
+ */
+declare function componentTypicalities(fp: Fingerprint, runs: NullRun[], k?: number): ComponentTypicality[];
+
 /**
  * Every colour syntax the estate actually writes, read into OKLCh.
  *
@@ -1911,198 +2477,6 @@ declare function propose(input: ProposeInput): {
     direction: ArtDirection;
 };
 
-/**
- * The counterfactual: what a model builds for this brief when nobody tells it
- * anything else. Signal 2 of CHARACTER.md.
- *
- * A null model is about twenty pages generated from one brief, each reduced to
- * a fingerprint. A site is typical when it sits as close to those pages as they
- * sit to each other. That question keeps working when model defaults move,
- * which a fixed list of tells cannot: ban Inter and the null model moves with
- * the model, so the comparison moves too.
- *
- * `harvest` reads the same pages the other way round: which choices recur
- * across them that the catalogue does not know yet. Those are the candidates
- * for the next generation of tells. A person decides; nothing is added here.
- *
- * Pure. Generating pages and snapshotting them lives in the CLI.
- */
-
-declare const NULL_VERSION = 1;
-/**
- * The prompt a null run gets: the brief, and nothing about how it should look.
- * Changing this changes every null model built after it, so it is versioned
- * by being recorded in each one.
- */
-declare function nullPrompt(brief: string): string;
-interface NullRun {
-    /** The page's file name without extension: "01". */
-    id: string;
-    fingerprint: Fingerprint;
-    /** Catalogue tells found on the page, source and rendered, each once. */
-    tells: string[];
-    /** Every visible string on the page, for the phrase harvest. */
-    copy: string[];
-}
-interface NullModel {
-    version: typeof NULL_VERSION;
-    brief: string;
-    prompt: string;
-    /** What was asked for with --model, or "default". */
-    model: string;
-    catalogueVersion: string;
-    builtAt: string;
-    runs: NullRun[];
-}
-/** The HTML document in a model's reply, without code fences or commentary. */
-declare function extractHtml(reply: string): string | null;
-/** Fewer runs than this and the spread of the null is noise, so nothing is judged. */
-declare const MIN_RUNS = 5;
-/** Typical when at least this share of the null's own pages sit further out. */
-declare const TYPICAL_AT = 0.1;
-interface Typicality {
-    /**
-     * 0 to 1: the share of the null's own pages that sit further from the rest
-     * than this page sits from them. 1 is more typical than anything the model
-     * built; 0 is further out than every one of them.
-     */
-    score: number;
-    typical: boolean;
-    /** Mean distance to the k nearest null pages. */
-    distance: number;
-    /** The same measure for each null page against the others, median. */
-    baseline: number;
-    nearest: {
-        id: string;
-        distance: number;
-    }[];
-    /** The choices this page shares with most of the null: why it reads as typical. */
-    shared: {
-        part: string;
-        value: string;
-        runs: number;
-        of: number;
-    }[];
-}
-/**
- * How typical a page is against one or more null models (pooled). Every null
- * page is scored against the others the same way, leaving itself out, so the
- * threshold comes from the model's own spread and not from a number picked
- * here: a page drawn from the null is flagged nine times in ten by
- * construction, and the calibration checks whether real sites are not.
- */
-declare function typicality(target: Fingerprint, runs: NullRun[], k?: number): Typicality;
-declare function hueName(o: Oklch | null): string;
-declare function groundName(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[]>;
-type CandidateKind = "face" | "accent" | "ground" | "shape" | "motion" | "opening" | "tell" | "phrase";
-interface HarvestCandidate {
-    kind: CandidateKind;
-    value: string;
-    /** Null pages that make this choice, across every model given. */
-    runs: number;
-    of: number;
-    /** Distinct briefs it turned up for. A habit shows across briefs; a brief's own words do not. */
-    briefs: number;
-    /** The catalogue tell that already catches it, or null when nothing does. */
-    known: string | null;
-    /** An example, for a phrase: the string it came from. */
-    example?: string;
-}
-interface HarvestOptions {
-    /** Report a choice made by at least this share of pages. Default 0.25. */
-    minShare?: number;
-    /** Which copy tell, if any, already catches a phrase. The CLI passes the catalogue's. */
-    copyTell?: (phrase: string) => string | null;
-}
-/**
- * Choices that recur across null pages, with the tell that already catches
- * each, if any. The ones with `known: null` are the next generation's
- * candidates. Nothing here decides: a person reads them, and a candidate only
- * becomes a tell with a flag case and a pass case like every other.
- */
-declare function harvest(models: Pick<NullModel, "brief" | "runs">[], options?: HarvestOptions): HarvestCandidate[];
-/** A representative colour for a hue family, for a report. */
-declare function hueSwatch(runs: NullRun[], hue: string): string | null;
-
-/**
- * The estate register: every site the agency has shipped, fingerprinted, so a
- * new one can be checked against its siblings. Signal 3 of CHARACTER.md.
- *
- * An agency's biggest tell is its clients looking like each other. No single
- * site shows it; only the set does. So the register holds one fingerprint per
- * site, and `compareToEstate` says which sites a page sits nearest and what
- * it shares with them.
- *
- * The line for "siblings" is not a number picked here. Two different
- * businesses are siblings when they sit closer together than two pages Claude
- * builds for the same brief usually do: if a barber and an electrician look
- * more alike than two drafts of one barber, nobody chose either look. The
- * median comes from null models when they are given, and from the 2026-09-23
- * calibration when they are not.
- *
- * Pure. The CLI reads and writes the register file.
- */
-
-declare const ESTATE_VERSION = 1;
-/**
- * Median fingerprint distance between two null pages built from the same
- * brief, across seven briefs and 1,330 pairs (calibration/null, 2026-09-23).
- */
-declare const SIBLING_AT = 0.31;
-interface EstateSite {
-    /** Short kebab-case id: "rmp", "chair-and-blade". */
-    id: string;
-    client: string;
-    url: string;
-    /** Where the site's source lives, if known: "rmp474/RMP-Electrical". */
-    repo?: string;
-    fingerprint: Fingerprint;
-    /** Rendered tells found when it was added, for the record. */
-    tells: string[];
-    addedAt: string;
-}
-interface EstateRegister {
-    version: typeof ESTATE_VERSION;
-    sites: EstateSite[];
-}
-declare function emptyEstate(): EstateRegister;
-/** Add a site, or replace the one with the same id. Sorted by id so the file diffs cleanly. */
-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 0.2 or less.
- */
-declare function sharedParts(a: Fingerprint, b: Fingerprint, d?: FingerprintDistance): string[];
-interface EstateMatch {
-    id: string;
-    distance: number;
-    sibling: boolean;
-    shared: string[];
-}
-/** The sites nearest a fingerprint, closest first, leaving out `exclude` (the site itself). */
-declare function compareToEstate(target: Fingerprint, register: EstateRegister, options?: {
-    exclude?: string;
-    siblingAt?: number;
-}): EstateMatch[];
-interface EstatePair {
-    a: string;
-    b: string;
-    distance: number;
-    sibling: boolean;
-    shared: string[];
-}
-/** Every pair in the register, closest first. */
-declare function estatePairs(register: EstateRegister, siblingAt?: number): EstatePair[];
-/**
- * The sibling line from null models: the median distance between two pages
- * built from the same brief. Each inner array is one brief's fingerprints.
- */
-declare function siblingLine(briefs: Fingerprint[][]): number;
-
 /**
  * The character report: the three signals and the reason rule, read together.
  *
@@ -2178,4 +2552,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, 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 };
+export { AI_PHRASES, AI_SOURCE_TYPES, 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, COMPONENT_ROLES, 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 ContrastCheck, type ContrastReport, type CopySide, 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, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, type ImageProvenance, type ImageRole, 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, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, RENDERED_TELLS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RenderedTell, 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, SPECIFICITY_COPY_TELLS, SPECIFICITY_RENDERED_TELLS, SPRING, STANDING_CLAIM, STOCK_AVATAR_HOSTS, STOCK_FIGURES, STOCK_PHOTO_HOSTS, 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 SnapshotImage, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Specific, type SpecificKind, type Specificity, type Surface, TELL_HEAVY, TRADE_NOUNS, 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, briefTerms, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, closestComponents, compareCompetitor, compareFacts, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, countWords, craftTokens, createBaseline, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatCompetitor, 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, pageCopy, paletteFromPixels, parseBaseline, parseColour, parseCraftConfig, parseHex, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, retrofitPlan, runTell, scanProvenance, scanSource, sectionRhythm, semantic, sentencesOf, severityExceptions, shapeName, sharedParts, shouldAnimate, siblingLine, specificity, specifics, stockAvatarSource, stockSource, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, typeFeatureTokens, typicality, unprovenClaims, validateDirection, visibleText, visualMeasures, wcagContrast, wordListsJson };