@domandigital/craft 0.13.0 → 0.14.0

package/dist/index.d.cts

@@ -796,6 +796,13 @@ interface SnapshotSection {
     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";
 /**
@@ -907,10 +914,17 @@ interface Snapshot {
     /** Version 2: absent when the page could not be screenshotted. */
     visual?: SnapshotVisual;
     /**
-     * Version 2, craft 0.14 and later: every image on the page, largest first, at
+     * 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. */
@@ -1144,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.11";
+declare const CATALOGUE_VERSION = "2026.09.12";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -1326,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.
@@ -2390,4 +2552,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-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 ComponentPair, type ComponentTypicality, 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, 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, PROPOSED, PROVENANCE_SCAN_BYTES, 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, SPRING, STOCK_AVATAR_HOSTS, 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 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, closestComponents, compareFacts, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, craftTokens, createBaseline, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estateComponentPairs, 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, scanProvenance, scanSource, sectionRhythm, semantic, severityExceptions, shapeName, sharedParts, shouldAnimate, siblingLine, stockAvatarSource, stockSource, 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 };

package/dist/index.d.ts

@@ -796,6 +796,13 @@ interface SnapshotSection {
     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";
 /**
@@ -907,10 +914,17 @@ interface Snapshot {
     /** Version 2: absent when the page could not be screenshotted. */
     visual?: SnapshotVisual;
     /**
-     * Version 2, craft 0.14 and later: every image on the page, largest first, at
+     * 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. */
@@ -1144,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.11";
+declare const CATALOGUE_VERSION = "2026.09.12";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -1326,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.
@@ -2390,4 +2552,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-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 ComponentPair, type ComponentTypicality, 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, 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, PROPOSED, PROVENANCE_SCAN_BYTES, 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, SPRING, STOCK_AVATAR_HOSTS, 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 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, closestComponents, compareFacts, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, craftTokens, createBaseline, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estateComponentPairs, 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, scanProvenance, scanSource, sectionRhythm, semantic, severityExceptions, shapeName, sharedParts, shouldAnimate, siblingLine, stockAvatarSource, stockSource, 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 };