@mieweb/ui 0.10.0-dev.4 → 0.10.0-dev.40

package/dist/templates.d.cts

@@ -0,0 +1,734 @@
+import * as React from 'react';
+import { S as SectionBaseProps, T as TemplateLink, a as TemplateIconRegistry, b as TemplateImage, c as TemplateComponents, d as SectionAlign, e as SectionTone } from './icons-wBacj6BW.cjs';
+export { f as TemplateIcon, g as TemplateIconComponent, h as TemplateIconName, i as TemplateIconProps, j as TemplateImageProps, k as TemplateLinkProps, t as templateIcons } from './icons-wBacj6BW.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import 'lucide-react';
+
+interface ComparisonRow {
+    feature: string;
+    /** One value per column: `true`/`false` render as included/not included, strings render as text. */
+    values: (boolean | string)[];
+}
+interface ComparisonSectionLabels {
+    /** Header of the first column. */
+    feature?: string;
+    /** Screen-reader text for a `true` cell. */
+    included?: string;
+    /** Screen-reader text for a `false` cell. */
+    notIncluded?: string;
+}
+interface ComparisonSectionProps extends SectionBaseProps {
+    /** Value column headers, e.g. `["Without BlueHive", "With BlueHive"]`. */
+    columns: string[];
+    rows: ComparisonRow[];
+    /** Index into `columns` to emphasise — usually your product. */
+    highlightColumn?: number;
+    labels?: ComparisonSectionLabels;
+}
+declare const ComparisonSection: React.ForwardRefExoticComponent<ComparisonSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface CtaSectionProps extends SectionBaseProps {
+    title: string;
+    primaryCta?: TemplateLink;
+    secondaryCta?: TemplateLink;
+    /** Small print under the buttons ("Setup takes about 10 minutes"). */
+    note?: string;
+    /** `band` fills the section with `tone`; `panel` floats a rounded card of `tone` on the page background. */
+    layout?: 'band' | 'panel';
+}
+declare const CtaSection: React.ForwardRefExoticComponent<CtaSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface FaqItem {
+    question: string;
+    /** Plain text; line breaks are preserved. */
+    answer: string;
+    /** Anchor id so a link can open straight to this answer. */
+    id?: string;
+}
+interface FaqSectionProps extends SectionBaseProps {
+    items: FaqItem[];
+}
+declare const FaqSection: React.ForwardRefExoticComponent<FaqSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface FeatureItem {
+    title: string;
+    description: string;
+    /** Icon token (see `templateIcons`) or a lettermark such as `"EHR"`. */
+    icon?: string;
+    /** Small label above the title. */
+    tag?: string;
+    link?: TemplateLink;
+}
+interface FeatureGridSectionProps extends SectionBaseProps {
+    features: FeatureItem[];
+    columns?: 2 | 3 | 4;
+    /** `cards` frames each item; `plain` sets them straight on the section. */
+    variant?: 'cards' | 'plain';
+    icons?: TemplateIconRegistry;
+}
+declare const FeatureGridSection: React.ForwardRefExoticComponent<FeatureGridSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface HeroSectionLabels {
+    /** Accessible name of the breadcrumb `<nav>`. */
+    breadcrumb?: string;
+}
+interface HeroSectionProps extends Omit<SectionBaseProps, 'align'> {
+    title: string;
+    /** `split` puts copy beside `image`; `centered` stacks everything. */
+    variant?: 'centered' | 'split';
+    primaryCta?: TemplateLink;
+    secondaryCta?: TemplateLink;
+    /** Reassurance line under the calls to action ("No credit card required"). */
+    ctaNote?: string;
+    /** Short trust points rendered as a checked list. */
+    highlights?: string[];
+    /** Dateline items under the heading, e.g. `['Benchmark report', '2027 edition']`. */
+    meta?: string[];
+    /** Brand mark above the heading. */
+    logo?: TemplateImage;
+    image?: TemplateImage;
+    /** Trail ending in the current page, which renders unlinked. */
+    breadcrumbs?: TemplateLink[];
+    /** A page has one `h1`; set `h2` when the page already renders its own. */
+    headingLevel?: 'h1' | 'h2';
+    labels?: HeroSectionLabels;
+}
+declare const HeroSection: React.ForwardRefExoticComponent<HeroSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface LeadFormField {
+    name: string;
+    label: string;
+    type?: 'text' | 'email' | 'tel' | 'textarea' | 'select';
+    required?: boolean;
+    autoComplete?: string;
+    placeholder?: string;
+    /** Choices for `type: 'select'`. */
+    options?: string[];
+    /** `half` pairs two fields on one row from the `sm` breakpoint. */
+    width?: 'full' | 'half';
+}
+interface LeadFormSectionProps extends Omit<SectionBaseProps, 'align' | 'onSubmit'> {
+    title: string;
+    /**
+     * A URL, or a React form action such as a Next.js Server Action. A URL is
+     * page data: if its scheme is not http(s), mailto or tel the section
+     * renders nothing, so an executable action never reaches the form.
+     */
+    action: string | ((formData: FormData) => void | Promise<void>);
+    /** Only used with a URL `action`. */
+    method?: 'post' | 'get';
+    fields?: LeadFormField[];
+    /** Posted with the form, e.g. `{ source: 'industry-construction' }`. */
+    hiddenFields?: Record<string, string>;
+    submitLabel?: string;
+    /** Privacy or consent line under the button. */
+    note?: string;
+    /** Rendered as `data-track` on the submit button. */
+    submitTrackingId?: string;
+    /** `split` puts the heading beside the form; `stacked` centres it above. */
+    layout?: 'split' | 'stacked';
+    /** What the visitor gets, as a checked list under the heading — e.g. a gated report's contents. */
+    highlights?: string[];
+}
+declare const defaultLeadFormFields: LeadFormField[];
+declare const LeadFormSection: React.ForwardRefExoticComponent<LeadFormSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface LogoItem {
+    name: string;
+    /** Logo image; without it the name renders as a wordmark. */
+    src?: string;
+    href?: string;
+    trackingId?: string;
+}
+interface LogoCloudSectionProps extends SectionBaseProps {
+    logos: LogoItem[];
+    /** `marquee` loops the row horizontally; it holds still under reduced motion. */
+    variant?: 'grid' | 'marquee';
+    speed?: 'slow' | 'normal' | 'fast';
+}
+declare const LogoCloudSection: React.ForwardRefExoticComponent<LogoCloudSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface PricingPlan {
+    name: string;
+    /** Display price as written, e.g. "$49", "Custom" or "Free". */
+    price: string;
+    /** Billing unit after the price, e.g. "per employee / month". */
+    period?: string;
+    description?: string;
+    features: string[];
+    cta?: TemplateLink;
+    /** Emphasise this plan and show `badge`. */
+    highlighted?: boolean;
+    badge?: string;
+}
+interface PricingSectionProps extends SectionBaseProps {
+    plans: PricingPlan[];
+    /** Small print under the plans (taxes, contract terms). */
+    note?: string;
+}
+declare const PricingSection: React.ForwardRefExoticComponent<PricingSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface ProcessStep {
+    title: string;
+    description: string;
+    /** Icon token shown in the step marker instead of its number. */
+    icon?: string;
+}
+interface ProcessStepsSectionProps extends SectionBaseProps {
+    steps: ProcessStep[];
+    icons?: TemplateIconRegistry;
+}
+declare const ProcessStepsSection: React.ForwardRefExoticComponent<ProcessStepsSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface ResourceItem {
+    title: string;
+    href: string;
+    excerpt?: string;
+    image?: TemplateImage;
+    /** Content type label, e.g. "Guide" or "Case study". */
+    kind?: string;
+    /** Free-text detail line the caller formats, e.g. "8 min read". */
+    meta?: string;
+    trackingId?: string;
+}
+interface ResourceCardsSectionProps extends SectionBaseProps {
+    items: ResourceItem[];
+    columns?: 2 | 3 | 4;
+    /** Link to the full index, shown under the cards. */
+    viewAll?: TemplateLink;
+}
+declare const ResourceCardsSection: React.ForwardRefExoticComponent<ResourceCardsSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface SplitContentSectionProps extends Omit<SectionBaseProps, 'align'> {
+    title: string;
+    image: TemplateImage;
+    /** Caption under the image. */
+    caption?: string;
+    /** Proof points rendered as a checked list under the description. */
+    bullets?: string[];
+    primaryCta?: TemplateLink;
+    secondaryCta?: TemplateLink;
+    /** Which side the image sits on at desktop widths (follows reading direction). */
+    mediaPosition?: 'start' | 'end';
+}
+declare const SplitContentSection: React.ForwardRefExoticComponent<SplitContentSectionProps & React.RefAttributes<HTMLElement>>;
+
+/** Where a figure comes from: measured, estimated, or still being instrumented. */
+type MetricStatus = 'live' | 'modeled' | 'maturing';
+/** Translated badge text, per status. */
+type MetricStatusLabels = Partial<Record<MetricStatus, string>>;
+declare const defaultMetricStatusLabels: Record<MetricStatus, string>;
+interface MetricStatusBadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+    status: MetricStatus;
+    /** Override the visible label, e.g. for translation. */
+    label?: string;
+    /** Set on dark or brand surfaces. */
+    onDark?: boolean;
+}
+/** Labels a figure by provenance so readers can tell measured data from estimates. */
+declare const MetricStatusBadge: React.ForwardRefExoticComponent<MetricStatusBadgeProps & React.RefAttributes<HTMLSpanElement>>;
+
+interface StatItem {
+    /** Numbers are locale-formatted; strings render as written. */
+    value: number | string;
+    prefix?: string;
+    suffix?: string;
+    label: string;
+    description?: string;
+    /** Decorative arrow. Say the direction in `label` too — the arrow is hidden from screen readers. */
+    trend?: 'up' | 'down';
+}
+interface StatsSectionProps extends SectionBaseProps {
+    stats: StatItem[];
+    /** `ruled` sets an accent rule beside each figure — a report's key-findings band. */
+    variant?: 'plain' | 'cards' | 'ruled';
+    /** BCP 47 locale for number formatting. */
+    locale?: string;
+    /** Provenance badge under the heading. */
+    status?: MetricStatus;
+    /** Translated text for the `status` badge. */
+    statusLabels?: MetricStatusLabels;
+}
+declare const StatsSection: React.ForwardRefExoticComponent<StatsSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface TestimonialItem {
+    quote: string;
+    author: string;
+    role?: string;
+    company?: string;
+    /** Headshot URL; decorative, since the author is named beside it. */
+    avatar?: string;
+    /** Whole stars out of five. */
+    rating?: 1 | 2 | 3 | 4 | 5;
+}
+interface TestimonialSectionLabels {
+    /** Screen-reader rating text; `{rating}` is replaced with the number. */
+    rating?: string;
+}
+interface TestimonialSectionProps extends SectionBaseProps {
+    testimonials: TestimonialItem[];
+    /** `featured` gives the first testimonial the whole section; `cards` lays them out in a grid. */
+    variant?: 'cards' | 'featured';
+    labels?: TestimonialSectionLabels;
+}
+declare const TestimonialSection: React.ForwardRefExoticComponent<TestimonialSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface VideoBase {
+    /** Accessible name of the player, e.g. "Product tour (3 min)". */
+    title: string;
+}
+type VideoSource = (VideoBase & {
+    /** Embeds `youtube-nocookie.com`, which sets no cookies until playback. Captions come from YouTube. */
+    youtubeId: string;
+}) | (VideoBase & {
+    /** A self-hosted file, played with the native `<video>` element. */
+    src: string;
+    /** Still frame shown before playback. */
+    poster?: string;
+    /** WebVTT captions — required, because prerecorded speech needs captions (WCAG 1.2.2). */
+    captions: {
+        src: string;
+        srcLang: string;
+        label: string;
+    };
+});
+interface VideoSectionProps extends SectionBaseProps {
+    video: VideoSource;
+    /** Caption under the player. */
+    caption?: string;
+}
+declare const VideoSection: React.ForwardRefExoticComponent<VideoSectionProps & React.RefAttributes<HTMLElement>>;
+
+type BenchmarkValue = number | string | null;
+interface BenchmarkColumn {
+    /** Key into each row's `values`. */
+    key: string;
+    label: string;
+    /** Number formatting, e.g. `{ style: 'currency', currency: 'USD', maximumFractionDigits: 0 }`. */
+    format?: Intl.NumberFormatOptions;
+    /** Draw a bar scaled to the column's largest value beside the number. */
+    bar?: boolean;
+    /** Tint the column \u2014 the figure readers should compare first. */
+    emphasis?: boolean;
+}
+interface BenchmarkRow {
+    label: string;
+    /** Second line under the label, e.g. a category. */
+    sublabel?: string;
+    href?: string;
+    /** Numbers are formatted by the column; strings render as written; `null` shows a dash. */
+    values: Record<string, BenchmarkValue>;
+}
+interface BenchmarkTableSectionProps extends Omit<SectionBaseProps, 'align'> {
+    columns: BenchmarkColumn[];
+    rows: BenchmarkRow[];
+    /** Header of the row-label column. */
+    rowHeader: string;
+    /** Visually hidden table caption; defaults to `title`. */
+    caption?: string;
+    /** Method note under the table. */
+    footnote?: string;
+    status?: MetricStatus;
+    /** Translated text for the `status` badge. */
+    statusLabels?: MetricStatusLabels;
+    /** BCP 47 locale for number formatting. */
+    locale?: string;
+}
+/**
+ * A benchmark table: labelled rows, formatted numeric columns, optional inline
+ * bars, and a sticky label column so wide tables scroll sideways on phones.
+ */
+declare const BenchmarkTableSection: React.ForwardRefExoticComponent<BenchmarkTableSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface LinkGroup {
+    title: string;
+    description?: string;
+    links: TemplateLink[];
+}
+interface LinkGroupsSectionProps extends SectionBaseProps {
+    groups: LinkGroup[];
+    columns?: 2 | 3;
+}
+/** Grouped lists of internal links — "explore the pages behind these numbers". */
+declare const LinkGroupsSection: React.ForwardRefExoticComponent<LinkGroupsSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface MetricDefinition {
+    label: string;
+    /** Unit chip, e.g. `hours` or `%`. */
+    unit?: string;
+    /** How the figure is (or will be) measured. */
+    description: string;
+    /** Leave unset until the figure is measured; the section then reads as a roadmap preview. */
+    value?: string;
+}
+interface MetricListSectionLabels {
+    preview?: string;
+}
+interface MetricListSectionProps extends Omit<SectionBaseProps, 'align'> {
+    metrics: MetricDefinition[];
+    /** Plain-language headline for the result. */
+    takeaway?: string;
+    /** Mark measured values as good news with a success rule. */
+    positive?: boolean;
+    /** Translated text for the derived live / maturing badge. */
+    statusLabels?: MetricStatusLabels;
+    labels?: MetricListSectionLabels;
+}
+/**
+ * Metric definitions with or without values. Publishing the definitions before
+ * the data lands is honest about what isn't measured yet; values drop in later
+ * with no layout change, and the badge flips from "maturing" to "live".
+ */
+declare const MetricListSection: React.ForwardRefExoticComponent<MetricListSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface PdfEmbedSectionLabels {
+    download?: string;
+    open?: string;
+    /** Shown where the browser can't display PDFs inline. */
+    fallback?: string;
+}
+interface PdfEmbedSectionProps extends SectionBaseProps {
+    title: string;
+    /** Root-relative or absolute URL of the PDF. */
+    src: string;
+    /** Suggested filename for the download link. */
+    downloadAs?: string;
+    /** Viewer height ÷ width. US Letter portrait is ~1.29; 16:9 slides are 0.5625. */
+    aspectRatio?: number;
+    /** Callout above the viewer, e.g. "embedded videos only play in Acrobat". */
+    notice?: string;
+    labels?: PdfEmbedSectionLabels;
+}
+/**
+ * An inline PDF viewer with download and open-in-new-tab links. Uses
+ * `<object>`, whose fallback content (a link) shows where inline PDF isn't
+ * supported, so it needs no client JavaScript.
+ */
+declare const PdfEmbedSection: React.ForwardRefExoticComponent<PdfEmbedSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface RankedItem {
+    label: string;
+    /** Sets the bar length, relative to the list's largest value. */
+    value: number;
+    /** Text shown for the value; defaults to the locale-formatted number. */
+    display?: string;
+    href?: string;
+    /** Small context to the side, e.g. `12 industries`. */
+    note?: string;
+}
+interface RankedList {
+    title?: string;
+    items: RankedItem[];
+}
+interface RankedListSectionProps extends Omit<SectionBaseProps, 'align'> {
+    /** One list, or several side by side (e.g. best- and worst-served). */
+    lists: RankedList[];
+    /** Prefix each item with its rank. */
+    numbered?: boolean;
+    /** `stacked` gives each item a card with the bar underneath; `inline` puts label, bar and value on one row. */
+    layout?: 'stacked' | 'inline';
+    bar?: 'primary' | 'accent' | 'success';
+    status?: MetricStatus;
+    /** Translated text for the `status` badge. */
+    statusLabels?: MetricStatusLabels;
+    /** BCP 47 locale for number formatting. */
+    locale?: string;
+}
+/** Ranked horizontal bars \u2014 top services, most-searched terms, best- and worst-served regions. */
+declare const RankedListSection: React.ForwardRefExoticComponent<RankedListSectionProps & React.RefAttributes<HTMLElement>>;
+
+interface ReportAuthor {
+    name: string;
+    /** Job title or credentials. */
+    role?: string;
+    /** Author page; the name links here. */
+    href?: string;
+    avatar?: TemplateImage;
+    /** External profiles, e.g. `{ label: 'LinkedIn', href }`. */
+    profiles?: TemplateLink[];
+}
+interface ReportBylineLabels {
+    /** Visually hidden section heading. */
+    heading?: string;
+    by?: string;
+    published?: string;
+    updated?: string;
+}
+interface ReportBylineProps extends Omit<SectionBaseProps, 'title' | 'eyebrow' | 'description' | 'align'> {
+    authors: ReportAuthor[];
+    /** Display date, formatted by the site. */
+    published?: string;
+    updated?: string;
+    labels?: ReportBylineLabels;
+}
+/** Who wrote a report and when, with links to author pages and profiles. */
+declare const ReportByline: React.ForwardRefExoticComponent<ReportBylineProps & React.RefAttributes<HTMLElement>>;
+
+interface ReportLegendEntry {
+    status: MetricStatus;
+    /** What this label means in this report. */
+    description: string;
+    /** Override the badge text, e.g. for translation. */
+    label?: string;
+}
+interface ReportLegendProps extends SectionBaseProps {
+    entries: ReportLegendEntry[];
+}
+/** The key to a report's provenance badges, set near the top so readers know how to weigh every figure. */
+declare const ReportLegend: React.ForwardRefExoticComponent<ReportLegendProps & React.RefAttributes<HTMLElement>>;
+
+interface MethodologySource {
+    label: string;
+    description: string;
+    /** Link to the dataset or document itself. */
+    href?: string;
+}
+interface MethodologyNote {
+    title: string;
+    body: string;
+}
+interface ReportMethodologyLabels {
+    citation?: string;
+    sourceLink?: string;
+}
+interface ReportMethodologyProps extends SectionBaseProps {
+    sources: MethodologySource[];
+    /** Suggested citation, shown selectable in a monospace block. */
+    citation?: string;
+    /** Short notes such as the publishing cadence or known limitations. */
+    notes?: MethodologyNote[];
+    /** A closing panel of links, e.g. the API or dataset downloads. */
+    resources?: {
+        title: string;
+        description?: string;
+        links: TemplateLink[];
+    };
+    labels?: ReportMethodologyLabels;
+}
+/** Sources, how to cite, and caveats — the section that makes a report's figures checkable. */
+declare const ReportMethodology: React.ForwardRefExoticComponent<ReportMethodologyProps & React.RefAttributes<HTMLElement>>;
+
+interface TilePosition {
+    code: string;
+    name: string;
+    /** Zero-based grid row. */
+    row: number;
+    /** Zero-based grid column. */
+    col: number;
+}
+/** US states and DC on an 11-column tile grid, every state the same size. */
+declare const usStateTiles: TilePosition[];
+type TileBucket = 0 | 1 | 2 | 3 | 4;
+/**
+ * Quartile buckets for a set of values: 1 (lowest) to 4 (highest), and 0 for
+ * a missing value. Run it in the data layer; pass the result to `TileCartogramSection`.
+ */
+declare function quartileBuckets(values: Record<string, number | null | undefined>): Record<string, TileBucket>;
+
+interface TileValue {
+    bucket: TileBucket;
+    /** Read out with the tile's name, e.g. `12.4 providers per 100k`. */
+    detail?: string;
+}
+interface TileLegendEntry {
+    bucket: TileBucket;
+    label: string;
+}
+interface TileCartogramSectionProps extends Omit<SectionBaseProps, 'align'> {
+    /** Values keyed by tile code. Tiles with no entry render as bucket 0. */
+    values: Record<string, TileValue>;
+    legend: TileLegendEntry[];
+    /** Tile positions; defaults to `usStateTiles`. */
+    layout?: TilePosition[];
+    /** Heading of the map card. */
+    mapTitle?: string;
+    mapDescription?: string;
+    status?: MetricStatus;
+    /** Translated text for the `status` badge. */
+    statusLabels?: MetricStatusLabels;
+}
+/**
+ * A tile-grid map: every region the same size, shaded by bucket, so small
+ * states are as visible as large ones. Each tile is a list item that reads its
+ * full name and detail to screen readers.
+ */
+declare const TileCartogramSection: React.ForwardRefExoticComponent<TileCartogramSectionProps & React.RefAttributes<HTMLElement>>;
+
+/** A section the site renders itself, looked up by name in `LandingPage`'s `custom` map. */
+interface CustomBlock {
+    type: 'custom';
+    component: string;
+    props?: Record<string, unknown>;
+    id?: string;
+}
+/** Section props as page data: no event handlers, children or components, so a block survives JSON. */
+type BlockData<P> = Omit<P, keyof React.DOMAttributes<HTMLElement> | 'components' | 'icons'>;
+/** One entry of a page's `blocks` array: a section's props tagged with its `type`. */
+type LandingBlock = ({
+    type: 'hero';
+} & BlockData<HeroSectionProps>) | ({
+    type: 'logos';
+} & BlockData<LogoCloudSectionProps>) | ({
+    type: 'features';
+} & BlockData<FeatureGridSectionProps>) | ({
+    type: 'split';
+} & BlockData<SplitContentSectionProps>) | ({
+    type: 'process';
+} & BlockData<ProcessStepsSectionProps>) | ({
+    type: 'stats';
+} & BlockData<StatsSectionProps>) | ({
+    type: 'comparison';
+} & BlockData<ComparisonSectionProps>) | ({
+    type: 'pricing';
+} & BlockData<PricingSectionProps>) | ({
+    type: 'video';
+} & BlockData<VideoSectionProps>) | ({
+    type: 'testimonials';
+} & BlockData<TestimonialSectionProps>) | ({
+    type: 'resources';
+} & BlockData<ResourceCardsSectionProps>) | ({
+    type: 'faq';
+} & BlockData<FaqSectionProps>) | ({
+    type: 'lead-form';
+} & Omit<BlockData<LeadFormSectionProps>, 'action'> & {
+    /** A URL, or the name of a function in `LandingPage`'s `actions` map. */
+    action: string;
+}) | ({
+    type: 'cta';
+} & BlockData<CtaSectionProps>) | ({
+    type: 'report-legend';
+} & BlockData<ReportLegendProps>) | ({
+    type: 'benchmark-table';
+} & BlockData<BenchmarkTableSectionProps>) | ({
+    type: 'ranked-list';
+} & BlockData<RankedListSectionProps>) | ({
+    type: 'tile-cartogram';
+} & BlockData<TileCartogramSectionProps>) | ({
+    type: 'metric-list';
+} & BlockData<MetricListSectionProps>) | ({
+    type: 'methodology';
+} & BlockData<ReportMethodologyProps>) | ({
+    type: 'byline';
+} & BlockData<ReportBylineProps>) | ({
+    type: 'link-groups';
+} & BlockData<LinkGroupsSectionProps>) | ({
+    type: 'pdf-embed';
+} & BlockData<PdfEmbedSectionProps>) | CustomBlock;
+type LandingBlockType = LandingBlock['type'];
+interface LandingPageProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** The page, top to bottom. Plain data — import it from a content file or a CMS. */
+    blocks: LandingBlock[];
+    /** Site icon tokens, passed to every section that renders icons. */
+    icons?: TemplateIconRegistry;
+    /** Site image and link components (e.g. `next/image`, `next/link`), passed to every section. */
+    components?: TemplateComponents;
+    /** Site-owned sections for `{ type: 'custom', component }` blocks. */
+    custom?: Record<string, React.ComponentType<any>>;
+    /** Form actions (e.g. Server Actions, React 19) that `lead-form` blocks name in `action`. */
+    actions?: Record<string, (formData: FormData) => void | Promise<void>>;
+}
+declare const LandingPage: React.ForwardRefExoticComponent<LandingPageProps & React.RefAttributes<HTMLDivElement>>;
+
+interface LandingPreset {
+    label: string;
+    description: string;
+    /** Recommended order, top to bottom. Blocks not listed may sit anywhere. */
+    sequence: LandingBlockType[];
+    /** Blocks the page is incomplete without. */
+    required: LandingBlockType[];
+}
+/** Page archetypes shared by the BlueHive and Enterprise Health marketing sites. */
+declare const landingPresets: {
+    'vertical-hub': {
+        label: string;
+        description: string;
+        sequence: ("split" | "hero" | "features" | "logos" | "stats" | "testimonials" | "resources" | "process" | "faq" | "cta")[];
+        required: ("hero" | "features" | "faq" | "cta")[];
+    };
+    'service-detail': {
+        label: string;
+        description: string;
+        sequence: ("hero" | "features" | "stats" | "testimonials" | "video" | "process" | "comparison" | "pricing" | "faq" | "cta")[];
+        required: ("hero" | "features" | "cta")[];
+    };
+    campaign: {
+        label: string;
+        description: string;
+        sequence: ("hero" | "features" | "logos" | "stats" | "testimonials" | "faq" | "lead-form")[];
+        required: ("hero" | "lead-form")[];
+    };
+    comparison: {
+        label: string;
+        description: string;
+        sequence: ("hero" | "features" | "testimonials" | "comparison" | "faq" | "cta")[];
+        required: ("hero" | "comparison" | "cta")[];
+    };
+    resource: {
+        label: string;
+        description: string;
+        sequence: ("split" | "hero" | "resources" | "faq" | "lead-form")[];
+        required: ("hero" | "lead-form")[];
+    };
+    pricing: {
+        label: string;
+        description: string;
+        sequence: ("hero" | "stats" | "testimonials" | "comparison" | "pricing" | "faq" | "cta")[];
+        required: ("hero" | "pricing" | "faq")[];
+    };
+    'benchmark-report': {
+        label: string;
+        description: string;
+        sequence: ("hero" | "features" | "stats" | "report-legend" | "lead-form" | "cta" | "benchmark-table" | "ranked-list" | "tile-cartogram" | "metric-list" | "methodology" | "byline" | "link-groups" | "pdf-embed")[];
+        required: ("hero" | "methodology")[];
+    };
+};
+type LandingPresetId = keyof typeof landingPresets;
+interface LandingPageIssue {
+    severity: 'error' | 'warning';
+    message: string;
+    /** Index into `blocks`, when the issue belongs to one block. */
+    index?: number;
+}
+/**
+ * Checks a page against the heading contract (exactly one `h1` hero, first)
+ * and, when given, a preset's required blocks and order. Run it in a build
+ * step or test; `LandingPage` itself renders whatever it is given.
+ */
+declare function validateLandingPage(blocks: LandingBlock[], preset?: LandingPresetId | LandingPreset): LandingPageIssue[];
+
+interface SectionHeadingProps {
+    eyebrow?: string;
+    title?: string;
+    description?: string;
+    /** Heading element. Sections use `h2`; only a page's hero is `h1`. */
+    as?: 'h1' | 'h2' | 'h3';
+    size?: 'section' | 'hero';
+    align?: SectionAlign;
+    tone?: SectionTone;
+    titleId?: string;
+    className?: string;
+}
+/** Eyebrow, heading and supporting text — the opener every landing section shares. */
+declare function SectionHeading({ eyebrow, title, description, as: Heading, size, align, tone, titleId, className, }: SectionHeadingProps): react_jsx_runtime.JSX.Element | null;
+interface SectionShellProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    eyebrow?: string;
+    title?: string;
+    description?: string;
+    tone?: SectionTone;
+    align?: SectionAlign;
+    width?: 'wide' | 'narrow';
+    spacing?: 'default' | 'compact';
+    /** Provenance badge under the heading, for sections that report figures. */
+    status?: MetricStatus;
+    /** Translated text for the `status` badge. */
+    statusLabels?: MetricStatusLabels;
+    /** Accepted so sections can forward their props; the shell renders no links or images. */
+    components?: TemplateComponents;
+}
+/**
+ * The `<section>` + container + heading frame every landing section renders.
+ * Exported so a site can build its own section that sits flush with the rest.
+ */
+declare const SectionShell: React.ForwardRefExoticComponent<SectionShellProps & React.RefAttributes<HTMLElement>>;
+
+export { type BenchmarkColumn, type BenchmarkRow, BenchmarkTableSection, type BenchmarkTableSectionProps, type BenchmarkValue, type ComparisonRow, ComparisonSection, type ComparisonSectionLabels, type ComparisonSectionProps, CtaSection, type CtaSectionProps, type CustomBlock, type FaqItem, FaqSection, type FaqSectionProps, FeatureGridSection, type FeatureGridSectionProps, type FeatureItem, HeroSection, type HeroSectionLabels, type HeroSectionProps, type LandingBlock, type LandingBlockType, LandingPage, type LandingPageIssue, type LandingPageProps, type LandingPreset, type LandingPresetId, type LeadFormField, LeadFormSection, type LeadFormSectionProps, type LinkGroup, LinkGroupsSection, type LinkGroupsSectionProps, LogoCloudSection, type LogoCloudSectionProps, type LogoItem, type MethodologyNote, type MethodologySource, type MetricDefinition, MetricListSection, type MetricListSectionLabels, type MetricListSectionProps, type MetricStatus, MetricStatusBadge, type MetricStatusBadgeProps, type MetricStatusLabels, PdfEmbedSection, type PdfEmbedSectionLabels, type PdfEmbedSectionProps, type PricingPlan, PricingSection, type PricingSectionProps, type ProcessStep, ProcessStepsSection, type ProcessStepsSectionProps, type RankedItem, type RankedList, RankedListSection, type RankedListSectionProps, type ReportAuthor, ReportByline, type ReportBylineLabels, type ReportBylineProps, ReportLegend, type ReportLegendEntry, type ReportLegendProps, ReportMethodology, type ReportMethodologyLabels, type ReportMethodologyProps, ResourceCardsSection, type ResourceCardsSectionProps, type ResourceItem, SectionAlign, SectionBaseProps, SectionHeading, type SectionHeadingProps, SectionShell, type SectionShellProps, SectionTone, SplitContentSection, type SplitContentSectionProps, type StatItem, StatsSection, type StatsSectionProps, TemplateComponents, TemplateIconRegistry, TemplateImage, TemplateLink, type TestimonialItem, TestimonialSection, type TestimonialSectionLabels, type TestimonialSectionProps, type TileBucket, TileCartogramSection, type TileCartogramSectionProps, type TileLegendEntry, type TilePosition, type TileValue, VideoSection, type VideoSectionProps, type VideoSource, defaultLeadFormFields, defaultMetricStatusLabels, landingPresets, quartileBuckets, usStateTiles, validateLandingPage };