@domandigital/craft 0.16.0 → 0.18.0

package/dist/index.d.cts

@@ -159,6 +159,90 @@ interface ContrastCheck {
 /** Measure one text-on-background pair against both models. */
 declare function checkPair(text: string, background: string): ContrastCheck;
 
+/**
+ * Contrast against a CSS gradient: the case automated tools do not score.
+ *
+ * axe-core and Lighthouse mark text on a gradient "incomplete", and it never
+ * reaches the result, so a page can report no contrast violations while its
+ * body copy fails AA. This was first found on two client sites (4.14:1 to
+ * 4.44:1, reported clean by every tool in CI). This walks the gradient's
+ * stops, composites each over what sits beneath, and scores the text against
+ * the worst one: the backdrop the text has to clear everywhere.
+ *
+ * WCAG 2.2 defines no method for gradient or translucent backdrops, so the
+ * worst point is this package's own rule, not a conformance claim.
+ *
+ * Folded in from dd-drift-guards (guards/contrast-math.mjs) on 3 October 2026,
+ * on craft's own colour parsing and contrast models, with one fix: the guard
+ * scored the stops only. The worst point can sit between two stops, wherever
+ * the backdrop's luminance comes closest to the text's: mid-grey text on a
+ * black-to-white gradient clears 4.5:1 against both ends and about 1:1 in the
+ * middle. So each segment is sampled, interpolated as browsers paint legacy
+ * colours (sRGB, premultiplied alpha). Pure.
+ */
+/** Samples per segment between two stops: under 1/255 of a channel apart for any pair. */
+declare const SAMPLES_PER_SEGMENT = 256;
+/**
+ * The colour stops of a CSS gradient, in order, as written. Splits on
+ * top-level commas only, so `rgba(1, 2, 3, 0.4)` survives, and drops the
+ * direction or shape argument (`to bottom`, `135deg`, `circle at top`).
+ * Throws on a stop it cannot read: a skipped stop could be the worst one.
+ */
+declare function gradientStops(gradient: string): string[];
+interface GradientContrast {
+    text: string;
+    gradient: string;
+    beneath: string;
+    /** Every stop composited over `beneath`, as hex. */
+    stops: string[];
+    /** The point of the gradient, stop or between stops, the text contrasts least with. */
+    worst: string;
+    /** WCAG 2.x ratio against the worst point. */
+    wcag: number;
+    /** APCA Lc against the worst point, signed. */
+    lc: number;
+    passesAA: boolean;
+    passesAALarge: boolean;
+    note: string;
+}
+/**
+ * Text on a gradient that sits on `beneath` (an opaque colour; default white).
+ * The text colour must be opaque: a translucent text colour depends on the
+ * backdrop at each pixel, which is a rendered measurement, not this one.
+ */
+declare function gradientContrast(text: string, gradient: string, beneath?: string): GradientContrast;
+
+/**
+ * The photo-review gate: reads the report `halide review --json` wrote and
+ * fails a build whose photography is under the bar.
+ *
+ * It takes the report's text, not a path, and never runs halide. A check that
+ * spawns a binary cannot run where the binary is absent (a CI image, a fresh
+ * clone), turns a fast check slow, and depends on a tool version nobody
+ * pinned. The pipeline writes the report; the build reads it and hands it here.
+ *
+ * Folded in from dd-drift-guards (guards/photo-review.mjs) on 3 October 2026,
+ * unchanged in what it passes and fails. Pure.
+ */
+interface PhotoReviewOptions {
+    /** Lowest acceptable score, overall and per image. Default 0.7. */
+    minScore?: number;
+    /**
+     * When false, no report is a pass: for a site with no photography at all.
+     * Default true, because a missing report on a site that has photos is the
+     * review not having run.
+     */
+    required?: boolean;
+}
+interface PhotoReviewResult {
+    ok: boolean;
+    failures: string[];
+    /** One line per thing checked, passed or not. */
+    report: string[];
+}
+/** `text` is the report's contents, or null when there is no report. */
+declare function checkPhotoReview(text: string | null, options?: PhotoReviewOptions): PhotoReviewResult;
+
 /**
  * Semantic tokens derived from a small set of anchors, with a contrast report.
  *
@@ -925,6 +1009,13 @@ interface Snapshot {
      * claim, not its menu or its calls to action.
      */
     firstScreenText?: string[];
+    /**
+     * Whether this is a site's home page, set by whoever knows: `craft
+     * calibrate` from its labels, and `craft null build` and `null import`,
+     * which ask for a home page. Absent, the URL decides (`HOME_URL`), and a
+     * local file such as `pages/01.html` never reads as one.
+     */
+    home?: boolean;
     /** 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. */
@@ -1600,6 +1691,159 @@ interface LexicalFeatures {
 declare const LEXICAL_FEATURES: readonly (keyof LexicalFeatures)[];
 declare function lexicalOf(text: string, brief?: string): LexicalFeatures;
 
+/**
+ * Register features: the measures a writer steers by when choosing a register.
+ *
+ * The shape and lexical features ask whether copy reads as generated. These
+ * ask something simpler: how long are the sentences, how often does the
+ * writer say "you", contract a verb or use the passive. Plain writing, a
+ * customer email and a literary paragraph differ on exactly these.
+ *
+ * Pure and zero-dependency, like `shape.ts`, whose sentence splitter and word
+ * counter they share. The calibration readers call the same function, so a
+ * published band describes the measure that ships.
+ *
+ * `passiveShare` is a heuristic: a form of "be" (optionally one adverb) then a
+ * participle, with common adjectival participles ("tired", "interested")
+ * excluded. It misses "get" passives and catches some predicative adjectives.
+ * It is measured, not assumed, before anything relies on it.
+ */
+interface RegisterFeatures {
+    /** Words per sentence. */
+    meanSentenceWords: number;
+    /** Contracted forms per 100 words: you'll, it's, don't, we're. */
+    contractionsPer100: number;
+    /** you, your, yours, yourself, yourselves per 100 words. */
+    youPer100: number;
+    /** I, me, my, mine, we, us, our, ours per 100 words. */
+    firstPersonPer100: number;
+    /** Share of sentences with a passive construction. */
+    passiveShare: number;
+    /** Letters per word. */
+    meanWordLength: number;
+}
+declare const REGISTER_FEATURES: readonly (keyof RegisterFeatures)[];
+declare function registerOf(text: string): RegisterFeatures;
+
+/**
+ * Register briefs: how to write in a chosen register, read before drafting.
+ *
+ * `COPY.md` says what every piece of house copy avoids. A register says what a
+ * draft reaches for: plain for a form or a policy, persuasive for a landing
+ * page, warm for a customer email, literary for a premium brand. The brief is
+ * read before drafting and `craft copy` runs afterwards, the order `COPY.md`
+ * sets for its own writing directives.
+ *
+ * Directives are positive ("do this"), never a list of phrases to avoid:
+ * naming a phrase puts it in the writer's head. Each one names its source, and
+ * a directive with no public authority behind it says "house judgement".
+ *
+ * Nothing here measures or grades. `REGISTERS.md` carries the generated text
+ * of this file, bound by a test.
+ */
+type RegisterId = "plain" | "persuasive" | "warm" | "literary";
+interface RegisterSource {
+    name: string;
+    url?: string;
+    /** What this register takes from it, and anything it does not. */
+    note: string;
+}
+interface Directive {
+    text: string;
+    /** Short source key: a `RegisterSource.name`, `COPY.md`, or "house judgement". */
+    from: string;
+}
+interface Register {
+    id: RegisterId;
+    name: string;
+    useFor: string;
+    directives: Directive[];
+    example: {
+        before: string;
+        after: string;
+        why: string;
+    };
+    sources: RegisterSource[];
+}
+declare const REGISTERS: readonly Register[];
+declare const REGISTER_IDS: readonly RegisterId[];
+declare function getRegister(id: string): Register | undefined;
+/** The brief as plain text, for reading before a draft or pasting into a prompt. */
+declare function registerBrief(id: RegisterId): string;
+/** The generated block of REGISTERS.md. */
+declare function registersDoc(): string;
+
+/**
+ * `craft register check`: where a draft sits against the human baselines.
+ *
+ * A single short passage cannot be placed: at blurb length the registers
+ * overlap too much (calibration/copy-shape/report-registers.md). Averaged over
+ * five paragraphs, every register pair separates on several features. So the
+ * check reads documents only, measures each blurb-sized paragraph with the
+ * same functions the baselines used, averages them, and compares the average
+ * with the document-level bands in `profile.ts`.
+ *
+ * It reports, never grades: which features fall outside the chosen
+ * register's usual range, and which baseline the draft reads closest to.
+ * `COPY.md` "Style is not evidence" applies: no score, no verdict.
+ */
+
+interface Band {
+    p10: number;
+    p50: number;
+    p90: number;
+    sd: number;
+    /** Baseline registers this feature separates this one from, at document level. */
+    separates: string[];
+}
+/** Baseline register -> feature -> band. */
+type RegisterProfile = Readonly<Record<string, Readonly<Record<string, Band>>>>;
+/** Which baseline each brief is compared with, and what that baseline is not. */
+declare const REGISTER_BASELINE: Readonly<Record<RegisterId, {
+    baseline: string;
+    note: string;
+}>>;
+declare const MIN_PARAGRAPHS = 5;
+/**
+ * Features that measure what a text is about, not how it is written. Enron is
+ * dense with deal names and figures because of its subject, not its register,
+ * so these stay in the separation report but out of the check: a warm email
+ * about a kitchen refit should not be told it names too few people.
+ */
+declare const CONTENT_FEATURES: ReadonlySet<string>;
+interface Outside {
+    feature: string;
+    value: number;
+    band: [number, number];
+    direction: "higher" | "lower";
+    sentence: string;
+}
+interface RegisterCheck {
+    register: RegisterId;
+    baseline: string;
+    /** Blurb-sized paragraphs measured. */
+    paragraphs: number;
+    /** False under MIN_PARAGRAPHS: nothing is compared. */
+    measured: boolean;
+    means: Record<string, number>;
+    outside: Outside[];
+    /** Standardised distance to each baseline's median, closest first. */
+    nearest: {
+        register: string;
+        distance: number;
+    }[];
+    note: string;
+    summary: string;
+}
+declare const featureLabel: (f: string) => string;
+/** Paragraphs as the baselines read them: blank lines split, headings dropped. */
+declare function documentParagraphs(text: string): string[];
+declare function checkRegister(text: string, id: RegisterId, profile: RegisterProfile): RegisterCheck;
+
+declare const PROFILE_PARAGRAPHS = 5;
+declare const PROFILE_MEASURED = "2026-09-30";
+declare const PROFILE: RegisterProfile;
+
 /**
  * Specificity tells: a page that could belong to anyone.
  *
@@ -2993,6 +3237,8 @@ interface LabelSummary {
 }
 interface TellRate {
     tell: string;
+    /** The catalogue generation it belongs to; null for a tell the catalogue no longer holds. */
+    generation: number | null;
     hits: Record<Label, number>;
     /** Hits on `ai` and `ai-looking` pages over all hits. */
     precision: number;
@@ -3098,4 +3344,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 Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, COMPONENT_ROLES, CONSIDERATION, 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, 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_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, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PageHierarchy, type PageResult, type PageType, 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 ReasonInput, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, 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, checkReason, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, globToRegExp, 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, 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 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 };

package/dist/index.d.ts

@@ -159,6 +159,90 @@ interface ContrastCheck {
 /** Measure one text-on-background pair against both models. */
 declare function checkPair(text: string, background: string): ContrastCheck;
 
+/**
+ * Contrast against a CSS gradient: the case automated tools do not score.
+ *
+ * axe-core and Lighthouse mark text on a gradient "incomplete", and it never
+ * reaches the result, so a page can report no contrast violations while its
+ * body copy fails AA. This was first found on two client sites (4.14:1 to
+ * 4.44:1, reported clean by every tool in CI). This walks the gradient's
+ * stops, composites each over what sits beneath, and scores the text against
+ * the worst one: the backdrop the text has to clear everywhere.
+ *
+ * WCAG 2.2 defines no method for gradient or translucent backdrops, so the
+ * worst point is this package's own rule, not a conformance claim.
+ *
+ * Folded in from dd-drift-guards (guards/contrast-math.mjs) on 3 October 2026,
+ * on craft's own colour parsing and contrast models, with one fix: the guard
+ * scored the stops only. The worst point can sit between two stops, wherever
+ * the backdrop's luminance comes closest to the text's: mid-grey text on a
+ * black-to-white gradient clears 4.5:1 against both ends and about 1:1 in the
+ * middle. So each segment is sampled, interpolated as browsers paint legacy
+ * colours (sRGB, premultiplied alpha). Pure.
+ */
+/** Samples per segment between two stops: under 1/255 of a channel apart for any pair. */
+declare const SAMPLES_PER_SEGMENT = 256;
+/**
+ * The colour stops of a CSS gradient, in order, as written. Splits on
+ * top-level commas only, so `rgba(1, 2, 3, 0.4)` survives, and drops the
+ * direction or shape argument (`to bottom`, `135deg`, `circle at top`).
+ * Throws on a stop it cannot read: a skipped stop could be the worst one.
+ */
+declare function gradientStops(gradient: string): string[];
+interface GradientContrast {
+    text: string;
+    gradient: string;
+    beneath: string;
+    /** Every stop composited over `beneath`, as hex. */
+    stops: string[];
+    /** The point of the gradient, stop or between stops, the text contrasts least with. */
+    worst: string;
+    /** WCAG 2.x ratio against the worst point. */
+    wcag: number;
+    /** APCA Lc against the worst point, signed. */
+    lc: number;
+    passesAA: boolean;
+    passesAALarge: boolean;
+    note: string;
+}
+/**
+ * Text on a gradient that sits on `beneath` (an opaque colour; default white).
+ * The text colour must be opaque: a translucent text colour depends on the
+ * backdrop at each pixel, which is a rendered measurement, not this one.
+ */
+declare function gradientContrast(text: string, gradient: string, beneath?: string): GradientContrast;
+
+/**
+ * The photo-review gate: reads the report `halide review --json` wrote and
+ * fails a build whose photography is under the bar.
+ *
+ * It takes the report's text, not a path, and never runs halide. A check that
+ * spawns a binary cannot run where the binary is absent (a CI image, a fresh
+ * clone), turns a fast check slow, and depends on a tool version nobody
+ * pinned. The pipeline writes the report; the build reads it and hands it here.
+ *
+ * Folded in from dd-drift-guards (guards/photo-review.mjs) on 3 October 2026,
+ * unchanged in what it passes and fails. Pure.
+ */
+interface PhotoReviewOptions {
+    /** Lowest acceptable score, overall and per image. Default 0.7. */
+    minScore?: number;
+    /**
+     * When false, no report is a pass: for a site with no photography at all.
+     * Default true, because a missing report on a site that has photos is the
+     * review not having run.
+     */
+    required?: boolean;
+}
+interface PhotoReviewResult {
+    ok: boolean;
+    failures: string[];
+    /** One line per thing checked, passed or not. */
+    report: string[];
+}
+/** `text` is the report's contents, or null when there is no report. */
+declare function checkPhotoReview(text: string | null, options?: PhotoReviewOptions): PhotoReviewResult;
+
 /**
  * Semantic tokens derived from a small set of anchors, with a contrast report.
  *
@@ -925,6 +1009,13 @@ interface Snapshot {
      * claim, not its menu or its calls to action.
      */
     firstScreenText?: string[];
+    /**
+     * Whether this is a site's home page, set by whoever knows: `craft
+     * calibrate` from its labels, and `craft null build` and `null import`,
+     * which ask for a home page. Absent, the URL decides (`HOME_URL`), and a
+     * local file such as `pages/01.html` never reads as one.
+     */
+    home?: boolean;
     /** 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. */
@@ -1600,6 +1691,159 @@ interface LexicalFeatures {
 declare const LEXICAL_FEATURES: readonly (keyof LexicalFeatures)[];
 declare function lexicalOf(text: string, brief?: string): LexicalFeatures;
 
+/**
+ * Register features: the measures a writer steers by when choosing a register.
+ *
+ * The shape and lexical features ask whether copy reads as generated. These
+ * ask something simpler: how long are the sentences, how often does the
+ * writer say "you", contract a verb or use the passive. Plain writing, a
+ * customer email and a literary paragraph differ on exactly these.
+ *
+ * Pure and zero-dependency, like `shape.ts`, whose sentence splitter and word
+ * counter they share. The calibration readers call the same function, so a
+ * published band describes the measure that ships.
+ *
+ * `passiveShare` is a heuristic: a form of "be" (optionally one adverb) then a
+ * participle, with common adjectival participles ("tired", "interested")
+ * excluded. It misses "get" passives and catches some predicative adjectives.
+ * It is measured, not assumed, before anything relies on it.
+ */
+interface RegisterFeatures {
+    /** Words per sentence. */
+    meanSentenceWords: number;
+    /** Contracted forms per 100 words: you'll, it's, don't, we're. */
+    contractionsPer100: number;
+    /** you, your, yours, yourself, yourselves per 100 words. */
+    youPer100: number;
+    /** I, me, my, mine, we, us, our, ours per 100 words. */
+    firstPersonPer100: number;
+    /** Share of sentences with a passive construction. */
+    passiveShare: number;
+    /** Letters per word. */
+    meanWordLength: number;
+}
+declare const REGISTER_FEATURES: readonly (keyof RegisterFeatures)[];
+declare function registerOf(text: string): RegisterFeatures;
+
+/**
+ * Register briefs: how to write in a chosen register, read before drafting.
+ *
+ * `COPY.md` says what every piece of house copy avoids. A register says what a
+ * draft reaches for: plain for a form or a policy, persuasive for a landing
+ * page, warm for a customer email, literary for a premium brand. The brief is
+ * read before drafting and `craft copy` runs afterwards, the order `COPY.md`
+ * sets for its own writing directives.
+ *
+ * Directives are positive ("do this"), never a list of phrases to avoid:
+ * naming a phrase puts it in the writer's head. Each one names its source, and
+ * a directive with no public authority behind it says "house judgement".
+ *
+ * Nothing here measures or grades. `REGISTERS.md` carries the generated text
+ * of this file, bound by a test.
+ */
+type RegisterId = "plain" | "persuasive" | "warm" | "literary";
+interface RegisterSource {
+    name: string;
+    url?: string;
+    /** What this register takes from it, and anything it does not. */
+    note: string;
+}
+interface Directive {
+    text: string;
+    /** Short source key: a `RegisterSource.name`, `COPY.md`, or "house judgement". */
+    from: string;
+}
+interface Register {
+    id: RegisterId;
+    name: string;
+    useFor: string;
+    directives: Directive[];
+    example: {
+        before: string;
+        after: string;
+        why: string;
+    };
+    sources: RegisterSource[];
+}
+declare const REGISTERS: readonly Register[];
+declare const REGISTER_IDS: readonly RegisterId[];
+declare function getRegister(id: string): Register | undefined;
+/** The brief as plain text, for reading before a draft or pasting into a prompt. */
+declare function registerBrief(id: RegisterId): string;
+/** The generated block of REGISTERS.md. */
+declare function registersDoc(): string;
+
+/**
+ * `craft register check`: where a draft sits against the human baselines.
+ *
+ * A single short passage cannot be placed: at blurb length the registers
+ * overlap too much (calibration/copy-shape/report-registers.md). Averaged over
+ * five paragraphs, every register pair separates on several features. So the
+ * check reads documents only, measures each blurb-sized paragraph with the
+ * same functions the baselines used, averages them, and compares the average
+ * with the document-level bands in `profile.ts`.
+ *
+ * It reports, never grades: which features fall outside the chosen
+ * register's usual range, and which baseline the draft reads closest to.
+ * `COPY.md` "Style is not evidence" applies: no score, no verdict.
+ */
+
+interface Band {
+    p10: number;
+    p50: number;
+    p90: number;
+    sd: number;
+    /** Baseline registers this feature separates this one from, at document level. */
+    separates: string[];
+}
+/** Baseline register -> feature -> band. */
+type RegisterProfile = Readonly<Record<string, Readonly<Record<string, Band>>>>;
+/** Which baseline each brief is compared with, and what that baseline is not. */
+declare const REGISTER_BASELINE: Readonly<Record<RegisterId, {
+    baseline: string;
+    note: string;
+}>>;
+declare const MIN_PARAGRAPHS = 5;
+/**
+ * Features that measure what a text is about, not how it is written. Enron is
+ * dense with deal names and figures because of its subject, not its register,
+ * so these stay in the separation report but out of the check: a warm email
+ * about a kitchen refit should not be told it names too few people.
+ */
+declare const CONTENT_FEATURES: ReadonlySet<string>;
+interface Outside {
+    feature: string;
+    value: number;
+    band: [number, number];
+    direction: "higher" | "lower";
+    sentence: string;
+}
+interface RegisterCheck {
+    register: RegisterId;
+    baseline: string;
+    /** Blurb-sized paragraphs measured. */
+    paragraphs: number;
+    /** False under MIN_PARAGRAPHS: nothing is compared. */
+    measured: boolean;
+    means: Record<string, number>;
+    outside: Outside[];
+    /** Standardised distance to each baseline's median, closest first. */
+    nearest: {
+        register: string;
+        distance: number;
+    }[];
+    note: string;
+    summary: string;
+}
+declare const featureLabel: (f: string) => string;
+/** Paragraphs as the baselines read them: blank lines split, headings dropped. */
+declare function documentParagraphs(text: string): string[];
+declare function checkRegister(text: string, id: RegisterId, profile: RegisterProfile): RegisterCheck;
+
+declare const PROFILE_PARAGRAPHS = 5;
+declare const PROFILE_MEASURED = "2026-09-30";
+declare const PROFILE: RegisterProfile;
+
 /**
  * Specificity tells: a page that could belong to anyone.
  *
@@ -2993,6 +3237,8 @@ interface LabelSummary {
 }
 interface TellRate {
     tell: string;
+    /** The catalogue generation it belongs to; null for a tell the catalogue no longer holds. */
+    generation: number | null;
     hits: Record<Label, number>;
     /** Hits on `ai` and `ai-looking` pages over all hits. */
     precision: number;
@@ -3098,4 +3344,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 Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, COMPONENT_ROLES, CONSIDERATION, 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, 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_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, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PageHierarchy, type PageResult, type PageType, 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 ReasonInput, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, 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, checkReason, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, globToRegExp, 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, 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 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 };