@mieweb/ui 0.10.0-dev.15 → 0.10.0-dev.16

package/dist/templates.d.ts

@@ -0,0 +1,560 @@
+import * as React from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as lucide_react from 'lucide-react';
+
+/** A navigational call to action. Always rendered as a real anchor so it is crawlable. */
+interface TemplateLink {
+    label: string;
+    href: string;
+    /** Rendered as `data-track` for the site's analytics to pick up. */
+    trackingId?: string;
+}
+interface TemplateImage {
+    src: string;
+    alt: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * Surface a section sits on. `brand` is a saturated primary band with light
+ * text in both colour modes; the others follow the active theme.
+ */
+type SectionTone = 'default' | 'muted' | 'brand';
+type SectionAlign = 'start' | 'center';
+/** Props a site's image component receives, e.g. an adapter around `next/image`. */
+interface TemplateImageProps extends TemplateImage {
+    className?: string;
+    /** True for the likely LCP image (the hero); load it eagerly at high priority. */
+    priority?: boolean;
+}
+/** Props a site's link component receives, e.g. `next/link`. */
+interface TemplateLinkProps {
+    href: string;
+    className?: string;
+    children?: React.ReactNode;
+    tabIndex?: number;
+    'aria-current'?: 'page';
+    'data-slot'?: string;
+    'data-track'?: string;
+}
+/**
+ * Swap the plain `<img>` and `<a>` the sections render for the site's own,
+ * so pages get optimized images and client-side navigation.
+ */
+interface TemplateComponents {
+    Image?: React.ComponentType<TemplateImageProps>;
+    Link?: React.ComponentType<TemplateLinkProps>;
+}
+/** Fields every landing section shares. Everything except `components` is JSON-serializable. */
+interface SectionBaseProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title' | 'children'> {
+    /** Anchor id for in-page links (`#faq`). */
+    id?: string;
+    /** Short label above the heading. */
+    eyebrow?: string;
+    /** Section heading, rendered as an `<h2>`. */
+    title?: string;
+    /** Supporting paragraph under the heading. */
+    description?: string;
+    tone?: SectionTone;
+    align?: SectionAlign;
+    /** Site image and link components; `LandingPage` passes its own to every section. */
+    components?: TemplateComponents;
+}
+
+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>>;
+
+type TemplateIconComponent = React.ComponentType<{
+    className?: string;
+    strokeWidth?: number;
+    'aria-hidden'?: boolean | 'true' | 'false';
+}>;
+/** Extra icon tokens a site maps to its own components; merged over the built-ins. */
+type TemplateIconRegistry = Record<string, TemplateIconComponent>;
+/**
+ * Built-in icon tokens. Page data names an icon by token (`"shield-check"`)
+ * rather than holding a component, so it stays JSON-serializable.
+ */
+declare const templateIcons: {
+    activity: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    award: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'badge-check': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    bell: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    briefcase: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    building: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    calendar: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'calendar-check': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'chart-column': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'chart-line': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'circle-check': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'clipboard-check': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    clock: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    cloud: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    database: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'dollar-sign': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    factory: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'file-text': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    flask: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    globe: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'graduation-cap': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    handshake: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'hard-hat': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    headset: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'heart-pulse': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    hospital: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    layers: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    leaf: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    lightbulb: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    lock: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    mail: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'map-pin': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'message-square': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    microscope: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    phone: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    plane: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    plug: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    rocket: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    scale: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    search: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    settings: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    shield: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'shield-check': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    smartphone: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    sparkles: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    stethoscope: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    syringe: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    target: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    timer: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'trending-up': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    truck: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    'user-check': React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    users: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    workflow: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    wrench: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    zap: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+};
+type TemplateIconName = keyof typeof templateIcons;
+interface TemplateIconProps {
+    /** A built-in token, a token from `icons`, or a lettermark of up to four characters. */
+    name: string;
+    icons?: TemplateIconRegistry;
+    className?: string;
+}
+declare function TemplateIcon({ name, icons, className }: TemplateIconProps): react_jsx_runtime.JSX.Element | null;
+
+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[];
+    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';
+}
+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>>;
+
+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[];
+    variant?: 'plain' | 'cards';
+    /** BCP 47 locale for number formatting. */
+    locale?: string;
+}
+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>>;
+
+/** 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>) | 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" | "process" | "resources" | "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")[];
+    };
+};
+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';
+    /** 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 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, LogoCloudSection, type LogoCloudSectionProps, type LogoItem, type PricingPlan, PricingSection, type PricingSectionProps, type ProcessStep, ProcessStepsSection, type ProcessStepsSectionProps, ResourceCardsSection, type ResourceCardsSectionProps, type ResourceItem, type SectionAlign, type SectionBaseProps, SectionHeading, type SectionHeadingProps, SectionShell, type SectionShellProps, type SectionTone, SplitContentSection, type SplitContentSectionProps, type StatItem, StatsSection, type StatsSectionProps, type TemplateComponents, TemplateIcon, type TemplateIconComponent, type TemplateIconName, type TemplateIconProps, type TemplateIconRegistry, type TemplateImage, type TemplateImageProps, type TemplateLink, type TemplateLinkProps, type TestimonialItem, TestimonialSection, type TestimonialSectionLabels, type TestimonialSectionProps, VideoSection, type VideoSectionProps, type VideoSource, defaultLeadFormFields, landingPresets, templateIcons, validateLandingPage };

package/dist/templates.js

@@ -0,0 +1,10 @@
+export { ComparisonSection, CtaSection, FaqSection, FeatureGridSection, HeroSection, LandingPage, LeadFormSection, LogoCloudSection, PricingSection, ProcessStepsSection, ResourceCardsSection, SectionHeading, SectionShell, SplitContentSection, StatsSection, TemplateIcon, TestimonialSection, VideoSection, defaultLeadFormFields, landingPresets, templateIcons, validateLandingPage } from './chunk-VNCIIXGO.js';
+import './chunk-IQ4KQJAO.js';
+import './chunk-6NZXWKUE.js';
+import './chunk-3IMM2PM4.js';
+import './chunk-BMSG4NBH.js';
+import './chunk-AXRRBEER.js';
+import './chunk-TQONQSJO.js';
+import './chunk-PX6F3LHL.js';
+//# sourceMappingURL=templates.js.map
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"templates.js"}

package/dist/{types-DsdZvEI1.d.cts → types-C3HQe74F.d.cts}

@@ -25,12 +25,6 @@ type ViewId = 'overview' | 'list' | 'board' | 'calendar' | 'gantt' | 'roadmap' |
  * hardcode a palette that breaks under another brand or in dark mode.
  */
 type Accent = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
-/** A named stage: a board column, and the segments of a stage bar. */
-interface Stage {
-    id: string;
-    label: string;
-    accent?: Accent;
-}
 /**
  * How a view reads one item. Only `getId` and `getTitle` are always required;
  * each view documents which of the rest it needs (a board needs `getStatus`, a
@@ -89,4 +83,4 @@ interface ViewBaseProps<T> {
     className?: string;
 }
 
-export type { Stage as S, ViewLabels as V, ViewBaseProps as a };
+export type { ViewLabels as V, ViewBaseProps as a };

package/dist/{types-DsdZvEI1.d.ts → types-C3HQe74F.d.ts}

@@ -25,12 +25,6 @@ type ViewId = 'overview' | 'list' | 'board' | 'calendar' | 'gantt' | 'roadmap' |
  * hardcode a palette that breaks under another brand or in dark mode.
  */
 type Accent = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
-/** A named stage: a board column, and the segments of a stage bar. */
-interface Stage {
-    id: string;
-    label: string;
-    accent?: Accent;
-}
 /**
  * How a view reads one item. Only `getId` and `getTitle` are always required;
  * each view documents which of the rest it needs (a board needs `getStatus`, a
@@ -89,4 +83,4 @@ interface ViewBaseProps<T> {
     className?: string;
 }
 
-export type { Stage as S, ViewLabels as V, ViewBaseProps as a };
+export type { ViewLabels as V, ViewBaseProps as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mieweb/ui",
-  "version": "0.10.0-dev.15",
+  "version": "0.10.0-dev.16",
   "description": "A themeable, accessible React component library built with Tailwind CSS",
   "author": "Medical Informatics Engineering, Inc.",
   "license": "SEE LICENSE IN LICENSE",
@@ -151,6 +151,16 @@
         "default": "./dist/globe.cjs"
       }
     },
+    "./templates": {
+      "import": {
+        "types": "./dist/templates.d.ts",
+        "default": "./dist/templates.js"
+      },
+      "require": {
+        "types": "./dist/templates.d.cts",
+        "default": "./dist/templates.cjs"
+      }
+    },
     "./datavis": {
       "import": {
         "types": "./dist/datavis.d.ts",
@@ -254,6 +264,7 @@
     "lint": "eslint \"src/**/*.{ts,tsx}\"",
     "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix",
     "rtl:scan": "node scripts/rtl-scan.mjs",
+    "check:templates-rsc": "node --conditions=react-server scripts/check-templates-rsc.mjs",
     "rtl:scan:update": "node scripts/rtl-scan.mjs --update",
     "condensed:scan": "node scripts/condensed-scan.mjs",
     "catalog:check": "node scripts/catalog-check.mjs",

package/dist/CsvBlock-ROJCKJDP.cjs

@@ -1,16 +0,0 @@
-'use strict';
-
-var chunkIX6KFB3K_cjs = require('./chunk-IX6KFB3K.cjs');
-require('./chunk-UV2FVNWT.cjs');
-require('./chunk-VNYW4C4J.cjs');
-require('./chunk-S5RVSXDV.cjs');
-require('./chunk-EUAMEVVI.cjs');
-
-
-
-Object.defineProperty(exports, "CsvBlock", {
-  enumerable: true,
-  get: function () { return chunkIX6KFB3K_cjs.CsvBlock; }
-});
-//# sourceMappingURL=CsvBlock-ROJCKJDP.cjs.map
-//# sourceMappingURL=CsvBlock-ROJCKJDP.cjs.map