@marktiderman/genesis-sites 0.0.0-stage → 0.2.0

package/dist/registry-D_DCWRTc.d.ts

@@ -0,0 +1,1030 @@
+import { ReactNode } from 'react';
+import { z } from 'zod';
+
+/**
+ * The documents a site is made of, as zod 4 schemas: a `SiteDoc` (theme,
+ * header, navigation, footer, SEO defaults, redirects), one `PageDoc` per
+ * page (its sections and SEO), and the `ReleaseSnapshot` a publish freezes.
+ *
+ * A page's `content` is an array of `{ id, type, v, variant, props }`
+ * section nodes, which is the shape Puck's `content` uses, so the editor
+ * reads and writes these documents unchanged. A section's `props` are
+ * checked by that section's own schema (see `defineSection`), not here.
+ */
+
+/** A link target: a site path, a fragment, or an http(s), mailto or tel URL. */
+declare const Href: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+/** An analytics event name for a link: `data-gs-event` on the page (default `cta` on buttons). */
+declare const LinkEvent: z.ZodString;
+/**
+ * A labelled link: a button, a menu entry, a footer link, an outbound
+ * booking link.
+ *
+ * - `external: true` marks a link that leaves the site (a booking or
+ *   membership system): it must be an `http(s)` URL, and it renders with
+ *   `rel="noopener noreferrer"` and `data-gs-outbound` for analytics.
+ * - `target` (`_blank` for a new tab) applies to http(s) links only;
+ *   `newTab: true` is the older spelling of `target: "_blank"`.
+ * - `event` names the click for the host's analytics (`data-gs-event`).
+ */
+declare const Link: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    newTab: z.ZodOptional<z.ZodBoolean>;
+    target: z.ZodOptional<z.ZodEnum<{
+        _self: "_self";
+        _blank: "_blank";
+    }>>;
+    external: z.ZodOptional<z.ZodBoolean>;
+    event: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Link = z.infer<typeof Link>;
+/** Does this link open in a new tab? Only an http(s) link can. */
+declare const opensInNewTab: (link: Pick<Link, "href" | "newTab" | "target">) => boolean;
+/**
+ * A downloadable file (a PDF timetable, a waiver): a site path (an upload
+ * under `sites/<site_id>/files/`) or an https URL. `bytes` and `mime` say
+ * what the visitor is about to download.
+ */
+declare const FileRef: z.ZodObject<{
+    src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    mime: z.ZodDefault<z.ZodEnum<{
+        "application/pdf": "application/pdf";
+        "image/png": "image/png";
+        "image/jpeg": "image/jpeg";
+        "image/webp": "image/webp";
+        "image/avif": "image/avif";
+        "image/gif": "image/gif";
+    }>>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type FileRef = z.infer<typeof FileRef>;
+/**
+ * An image. `alt` describes it for someone who can't see it; an image that
+ * adds nothing (a texture) is `decorative: true` and gets an empty alt. The
+ * accessibility check refuses to publish an image with neither.
+ */
+declare const Image: z.ZodObject<{
+    src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    alt: z.ZodDefault<z.ZodString>;
+    decorative: z.ZodOptional<z.ZodBoolean>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    focal: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type Image = z.infer<typeof Image>;
+/**
+ * Rich text: the JSON genesis-ui's `RichTextEditor` (TipTap) produces. Only
+ * its outline is checked here; genesis-ui's `RichText` sanitizes it again
+ * when it renders, so a stored document can never carry raw HTML.
+ */
+declare const RichText: z.ZodObject<{
+    type: z.ZodLiteral<"doc">;
+    content: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+type RichText = z.infer<typeof RichText>;
+/** The band a section sits on. */
+declare const Surface: z.ZodEnum<{
+    base: "base";
+    muted: "muted";
+    accent: "accent";
+    inverse: "inverse";
+}>;
+type Surface = z.infer<typeof Surface>;
+/** A short line of copy (a heading, a label). */
+declare const Line: (max?: number) => z.ZodString;
+/** A paragraph of plain copy. */
+declare const Copy: (max?: number) => z.ZodString;
+/** A section's id: stable, letters, digits, `-` and `_` (Shopify's rule). */
+declare const SectionId: z.ZodString;
+declare const SectionNode: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    v: z.ZodNumber;
+    variant: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    hideOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        mobile: "mobile";
+        desktop: "desktop";
+    }>>>;
+    placeholder: z.ZodOptional<z.ZodBoolean>;
+    props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+type SectionNode = z.infer<typeof SectionNode>;
+declare const Seo: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ogImage: z.ZodOptional<z.ZodObject<{
+        src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        alt: z.ZodDefault<z.ZodString>;
+        decorative: z.ZodOptional<z.ZodBoolean>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        focal: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    canonical: z.ZodOptional<z.ZodURL>;
+    noindex: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type Seo = z.infer<typeof Seo>;
+declare const PageDoc: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    root: z.ZodObject<{
+        props: z.ZodObject<{
+            title: z.ZodString;
+            hideSiteChrome: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+    content: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        v: z.ZodNumber;
+        variant: z.ZodOptional<z.ZodString>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+        hideOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            mobile: "mobile";
+            desktop: "desktop";
+        }>>>;
+        placeholder: z.ZodOptional<z.ZodBoolean>;
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+    seo: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ogImage: z.ZodOptional<z.ZodObject<{
+            src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            alt: z.ZodDefault<z.ZodString>;
+            decorative: z.ZodOptional<z.ZodBoolean>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            focal: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        canonical: z.ZodOptional<z.ZodURL>;
+        noindex: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type PageDoc = z.infer<typeof PageDoc>;
+/**
+ * What a page is: an ordinary `page`, a focused `landing` page, or the
+ * `post` page: the template every blog post renders in. A site has at most
+ * one post page; at its own path (`/blog`) it is the blog's index, and at
+ * `/blog/<slug>` it shows that post in its `post-body` section.
+ */
+declare const PageKind: z.ZodEnum<{
+    page: "page";
+    landing: "landing";
+    post: "post";
+}>;
+type PageKind = z.infer<typeof PageKind>;
+declare const PagePath: z.ZodString;
+declare const MenuItem: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+}, z.core.$strip>;
+type MenuItem = z.infer<typeof MenuItem>;
+declare const Redirect: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    status: z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>]>;
+}, z.core.$strip>;
+type Redirect = z.infer<typeof Redirect>;
+/** Fonts a site may choose; see `FONT_CHOICES` in theme.ts for their stacks. */
+declare const FontChoice: z.ZodEnum<{
+    system: "system";
+    inter: "inter";
+    "dm-sans": "dm-sans";
+    "work-sans": "work-sans";
+    montserrat: "montserrat";
+    poppins: "poppins";
+    "space-grotesk": "space-grotesk";
+    "source-serif": "source-serif";
+    merriweather: "merriweather";
+    "playfair-display": "playfair-display";
+    lora: "lora";
+}>;
+type FontChoice = z.infer<typeof FontChoice>;
+/**
+ * A site's theme choices on top of the brand: token choices only, never raw
+ * CSS, so a site stays inside the design system.
+ */
+declare const TokenOverrides: z.ZodObject<{
+    radius: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        full: "full";
+    }>>;
+    headingFont: z.ZodOptional<z.ZodEnum<{
+        system: "system";
+        inter: "inter";
+        "dm-sans": "dm-sans";
+        "work-sans": "work-sans";
+        montserrat: "montserrat";
+        poppins: "poppins";
+        "space-grotesk": "space-grotesk";
+        "source-serif": "source-serif";
+        merriweather: "merriweather";
+        "playfair-display": "playfair-display";
+        lora: "lora";
+    }>>;
+    bodyFont: z.ZodOptional<z.ZodEnum<{
+        system: "system";
+        inter: "inter";
+        "dm-sans": "dm-sans";
+        "work-sans": "work-sans";
+        montserrat: "montserrat";
+        poppins: "poppins";
+        "space-grotesk": "space-grotesk";
+        "source-serif": "source-serif";
+        merriweather: "merriweather";
+        "playfair-display": "playfair-display";
+        lora: "lora";
+    }>>;
+}, z.core.$strip>;
+type TokenOverrides = z.infer<typeof TokenOverrides>;
+declare const SeoDefaults: z.ZodObject<{
+    titleTemplate: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ogImage: z.ZodOptional<z.ZodObject<{
+        src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        alt: z.ZodDefault<z.ZodString>;
+        decorative: z.ZodOptional<z.ZodBoolean>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        focal: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    organization: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        logo: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+        sameAs: z.ZodOptional<z.ZodArray<z.ZodURL>>;
+    }, z.core.$strip>>;
+    noindex: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type SeoDefaults = z.infer<typeof SeoDefaults>;
+declare const SiteDoc: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    name: z.ZodString;
+    lang: z.ZodDefault<z.ZodString>;
+    theme: z.ZodDefault<z.ZodObject<{
+        colorScheme: z.ZodDefault<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            auto: "auto";
+        }>>;
+        overrides: z.ZodOptional<z.ZodObject<{
+            radius: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+                full: "full";
+            }>>;
+            headingFont: z.ZodOptional<z.ZodEnum<{
+                system: "system";
+                inter: "inter";
+                "dm-sans": "dm-sans";
+                "work-sans": "work-sans";
+                montserrat: "montserrat";
+                poppins: "poppins";
+                "space-grotesk": "space-grotesk";
+                "source-serif": "source-serif";
+                merriweather: "merriweather";
+                "playfair-display": "playfair-display";
+                lora: "lora";
+            }>>;
+            bodyFont: z.ZodOptional<z.ZodEnum<{
+                system: "system";
+                inter: "inter";
+                "dm-sans": "dm-sans";
+                "work-sans": "work-sans";
+                montserrat: "montserrat";
+                poppins: "poppins";
+                "space-grotesk": "space-grotesk";
+                "source-serif": "source-serif";
+                merriweather: "merriweather";
+                "playfair-display": "playfair-display";
+                lora: "lora";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    header: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        v: z.ZodNumber;
+        variant: z.ZodOptional<z.ZodString>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+        hideOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            mobile: "mobile";
+            desktop: "desktop";
+        }>>>;
+        placeholder: z.ZodOptional<z.ZodBoolean>;
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    nav: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    }, z.core.$strip>>>;
+    footer: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        v: z.ZodNumber;
+        variant: z.ZodOptional<z.ZodString>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+        hideOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            mobile: "mobile";
+            desktop: "desktop";
+        }>>>;
+        placeholder: z.ZodOptional<z.ZodBoolean>;
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    seo: z.ZodDefault<z.ZodObject<{
+        titleTemplate: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ogImage: z.ZodOptional<z.ZodObject<{
+            src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            alt: z.ZodDefault<z.ZodString>;
+            decorative: z.ZodOptional<z.ZodBoolean>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            focal: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        organization: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            logo: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+            sameAs: z.ZodOptional<z.ZodArray<z.ZodURL>>;
+        }, z.core.$strip>>;
+        noindex: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    redirects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        status: z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>]>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type SiteDoc = z.infer<typeof SiteDoc>;
+/** A `SiteDoc` as written, before defaults. */
+type SiteDocInput = z.input<typeof SiteDoc>;
+declare const ReleasePage: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        page: "page";
+        landing: "landing";
+        post: "post";
+    }>;
+    doc: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        root: z.ZodObject<{
+            props: z.ZodObject<{
+                title: z.ZodString;
+                hideSiteChrome: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$loose>;
+        }, z.core.$strip>;
+        content: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            v: z.ZodNumber;
+            variant: z.ZodOptional<z.ZodString>;
+            hidden: z.ZodOptional<z.ZodBoolean>;
+            hideOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                mobile: "mobile";
+                desktop: "desktop";
+            }>>>;
+            placeholder: z.ZodOptional<z.ZodBoolean>;
+            props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>;
+        seo: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            ogImage: z.ZodOptional<z.ZodObject<{
+                src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+                alt: z.ZodDefault<z.ZodString>;
+                decorative: z.ZodOptional<z.ZodBoolean>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                focal: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            canonical: z.ZodOptional<z.ZodURL>;
+            noindex: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type ReleasePage = z.infer<typeof ReleasePage>;
+/** Everything a published site serves: the site document and every page, frozen at publish. */
+declare const ReleaseSnapshot: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    site: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        name: z.ZodString;
+        lang: z.ZodDefault<z.ZodString>;
+        theme: z.ZodDefault<z.ZodObject<{
+            colorScheme: z.ZodDefault<z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+                auto: "auto";
+            }>>;
+            overrides: z.ZodOptional<z.ZodObject<{
+                radius: z.ZodOptional<z.ZodEnum<{
+                    none: "none";
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                    full: "full";
+                }>>;
+                headingFont: z.ZodOptional<z.ZodEnum<{
+                    system: "system";
+                    inter: "inter";
+                    "dm-sans": "dm-sans";
+                    "work-sans": "work-sans";
+                    montserrat: "montserrat";
+                    poppins: "poppins";
+                    "space-grotesk": "space-grotesk";
+                    "source-serif": "source-serif";
+                    merriweather: "merriweather";
+                    "playfair-display": "playfair-display";
+                    lora: "lora";
+                }>>;
+                bodyFont: z.ZodOptional<z.ZodEnum<{
+                    system: "system";
+                    inter: "inter";
+                    "dm-sans": "dm-sans";
+                    "work-sans": "work-sans";
+                    montserrat: "montserrat";
+                    poppins: "poppins";
+                    "space-grotesk": "space-grotesk";
+                    "source-serif": "source-serif";
+                    merriweather: "merriweather";
+                    "playfair-display": "playfair-display";
+                    lora: "lora";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        header: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            v: z.ZodNumber;
+            variant: z.ZodOptional<z.ZodString>;
+            hidden: z.ZodOptional<z.ZodBoolean>;
+            hideOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                mobile: "mobile";
+                desktop: "desktop";
+            }>>>;
+            placeholder: z.ZodOptional<z.ZodBoolean>;
+            props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>>;
+        nav: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        }, z.core.$strip>>>;
+        footer: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            v: z.ZodNumber;
+            variant: z.ZodOptional<z.ZodString>;
+            hidden: z.ZodOptional<z.ZodBoolean>;
+            hideOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                mobile: "mobile";
+                desktop: "desktop";
+            }>>>;
+            placeholder: z.ZodOptional<z.ZodBoolean>;
+            props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>>;
+        seo: z.ZodDefault<z.ZodObject<{
+            titleTemplate: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            ogImage: z.ZodOptional<z.ZodObject<{
+                src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+                alt: z.ZodDefault<z.ZodString>;
+                decorative: z.ZodOptional<z.ZodBoolean>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                focal: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            organization: z.ZodOptional<z.ZodObject<{
+                name: z.ZodString;
+                logo: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+                sameAs: z.ZodOptional<z.ZodArray<z.ZodURL>>;
+            }, z.core.$strip>>;
+            noindex: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        redirects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            status: z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>]>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    pages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            page: "page";
+            landing: "landing";
+            post: "post";
+        }>;
+        doc: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            root: z.ZodObject<{
+                props: z.ZodObject<{
+                    title: z.ZodString;
+                    hideSiteChrome: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$loose>;
+            }, z.core.$strip>;
+            content: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodString;
+                v: z.ZodNumber;
+                variant: z.ZodOptional<z.ZodString>;
+                hidden: z.ZodOptional<z.ZodBoolean>;
+                hideOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    mobile: "mobile";
+                    desktop: "desktop";
+                }>>>;
+                placeholder: z.ZodOptional<z.ZodBoolean>;
+                props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>;
+            seo: z.ZodOptional<z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                ogImage: z.ZodOptional<z.ZodObject<{
+                    src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+                    alt: z.ZodDefault<z.ZodString>;
+                    decorative: z.ZodOptional<z.ZodBoolean>;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    focal: z.ZodOptional<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                canonical: z.ZodOptional<z.ZodURL>;
+                noindex: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type ReleaseSnapshot = z.infer<typeof ReleaseSnapshot>;
+/**
+ * Read a stored snapshot page by page: a page that no longer parses (a
+ * schema this release tightened, a document written past the checks) is
+ * left out and reported, so one bad page doesn't take the whole site down.
+ * Null only when the site document itself doesn't parse.
+ */
+declare function parseSnapshot(value: unknown, report?: (message: string) => void): ReleaseSnapshot | null;
+interface ReleaseMeta {
+    id: string;
+    siteId: string;
+    number: number;
+    note: string | null;
+    createdAt: string;
+    publishedAt: string | null;
+    /** The brand the release was checked against (`brandHash`), when known. */
+    brandHash: string | null;
+}
+interface Release extends ReleaseMeta {
+    snapshot: ReleaseSnapshot;
+}
+interface PageMeta {
+    id: string;
+    siteId: string;
+    path: string;
+    kind: PageKind;
+    title: string;
+    sort: number;
+    rev: number;
+}
+/** The size limit of one stored document, as the database enforces it (512 KiB of JSON). */
+declare const MAX_DOC_BYTES: number;
+
+/**
+ * The form embed's contract with the host. A `form-embed` section names a
+ * form by its slug; the host says what that slug is, through a resolver
+ * passed to the renderer. This package assumes no forms table.
+ *
+ * - `definition`: a genesis-forms definition, sent to an endpoint. The page
+ *   renders it on the server (a plain HTML form when it needs no engine,
+ *   forms-web's `<Form>` and the form island otherwise), and answers are
+ *   POSTed as JSON (`{ form, answers }`) to `submitUrl`: a site path (the
+ *   host's own endpoint, for example one that runs genesis-forms
+ *   destinations) or an https URL (another service's endpoint).
+ * - `mailto`: no form at all, a button that opens the visitor's email to
+ *   `email`. The fallback for a site with no endpoint yet: nothing is
+ *   stored, and a page never posts a form to `mailto:`.
+ * - `embed`: an https URL the page shows in an iframe (a hosted form).
+ */
+type ResolvedForm = {
+    kind: "definition";
+    /** A canonical genesis-forms definition (`defineForm(...).definition`, or a stored one). */
+    definition: unknown;
+    /** Where the form POSTs `{ form, answers }` (form: the slug): a site path or an https URL. */
+    submitUrl: string;
+    layout?: "classic" | "focus";
+    submitLabel?: string;
+} | {
+    kind: "mailto";
+    /** The address the button writes to. */
+    email: string;
+    /** The email's subject line. */
+    subject?: string;
+    /** The button's label (default "Email us"). */
+    label?: string;
+    /** A line above the button. */
+    note?: string;
+} | {
+    kind: "embed";
+    /** An https URL. */
+    url: string;
+    /** The iframe's accessible name. */
+    title: string;
+    /** The iframe's height in CSS pixels (default 640). */
+    height?: number;
+};
+interface FormsResolverContext {
+    siteId: string;
+    pagePath: string;
+    mode: "live" | "preview";
+}
+/** slug → the form to show, or null when the host has no such form (the section then renders nothing and logs). */
+type FormsResolver = (slug: string, ctx: FormsResolverContext) => ResolvedForm | null | Promise<ResolvedForm | null>;
+/** A plain email address (no display name, no `%` escapes, no header injection): what a `mailto` form may write to. */
+declare function isPlainEmail(value: unknown): value is string;
+/** The `mailto:` link for a mailto form, or null when its address isn't a plain one. */
+declare function mailtoHref(form: Extract<ResolvedForm, {
+    kind: "mailto";
+}>): string | null;
+
+/**
+ * Blog posts: a site's collection of dated articles.
+ *
+ * A post is its own document (`PostDoc`), kept beside the pages rather than
+ * in them, with a draft and a published copy. `publishPost` checks the draft
+ * and copies it to the published copy; that copy is what visitors see, so
+ * a post goes live (and comes down) on its own, without republishing the
+ * site. The site's `post` page is the template every post renders in: at its
+ * own path it is the blog's index, and at `<path>/<slug>` it shows the post.
+ */
+
+/** A post's slug: lowercase letters, digits and single hyphens (`september-testing`). */
+declare const PostSlug: z.ZodString;
+declare const PostAuthor: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+}, z.core.$strip>;
+declare const PostDoc: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    title: z.ZodString;
+    excerpt: z.ZodOptional<z.ZodString>;
+    body: z.ZodObject<{
+        type: z.ZodLiteral<"doc">;
+        content: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>;
+    cover: z.ZodOptional<z.ZodObject<{
+        src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        alt: z.ZodDefault<z.ZodString>;
+        decorative: z.ZodOptional<z.ZodBoolean>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        focal: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    }, z.core.$strip>>;
+    category: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    seo: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ogImage: z.ZodOptional<z.ZodObject<{
+            src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            alt: z.ZodDefault<z.ZodString>;
+            decorative: z.ZodOptional<z.ZodBoolean>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            focal: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        canonical: z.ZodOptional<z.ZodURL>;
+        noindex: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type PostDoc = z.infer<typeof PostDoc>;
+type PostDocInput = z.input<typeof PostDoc>;
+type PostStatus = "draft" | "published";
+/** A post as the editor lists it. */
+interface PostMeta {
+    id: string;
+    siteId: string;
+    slug: string;
+    title: string;
+    status: PostStatus;
+    /** The draft's revision, for compare-and-swap saves. */
+    rev: number;
+    /** When it was first published (kept when it is published again), or null. */
+    publishedAt: string | null;
+    updatedAt: string;
+}
+/** A post's draft, for the editor. */
+interface PostDraft extends PostMeta {
+    doc: PostDoc;
+}
+/** A published post, as visitors see it. */
+interface LivePost {
+    slug: string;
+    publishedAt: string;
+    /** When its published copy last changed. */
+    updatedAt: string;
+    doc: PostDoc;
+}
+/** A published post in a list: everything but the body. */
+interface PostSummary {
+    slug: string;
+    title: string;
+    excerpt?: string;
+    cover?: Image;
+    author?: z.infer<typeof PostAuthor>;
+    category?: string;
+    /** Kept out of the sitemap and the feed (`seo.noindex`, or a canonical elsewhere). */
+    noindex?: boolean;
+    publishedAt: string;
+    updatedAt: string;
+}
+/** A list item as a store returns it, checked: a stored row that skipped the checks is left out. */
+declare const PostSummarySchema: z.ZodObject<{
+    slug: z.ZodString;
+    title: z.ZodString;
+    excerpt: z.ZodOptional<z.ZodString>;
+    cover: z.ZodOptional<z.ZodObject<{
+        src: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        alt: z.ZodDefault<z.ZodString>;
+        decorative: z.ZodOptional<z.ZodBoolean>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        focal: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    }, z.core.$strip>>;
+    category: z.ZodOptional<z.ZodString>;
+    noindex: z.ZodOptional<z.ZodBoolean>;
+    publishedAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+/** The most posts a list reads (the newest first). */
+declare const MAX_LIVE_POSTS = 500;
+/** A save of a post: a new one (no `id`), or a compare-and-swap of an existing one's draft. */
+interface SavePostInput {
+    id?: string;
+    slug: string;
+    /** The draft revision this save started from (required with `id`). */
+    rev?: number;
+    doc: PostDocInput;
+}
+type SavePostResult = {
+    id: string;
+    rev: number;
+} | {
+    id: string;
+    conflict: PostDoc;
+    rev: number;
+};
+/** One post to import (a move from another site): published as of `publishedAt` unless it fails a check. */
+interface ImportPost {
+    slug: string;
+    doc: PostDocInput;
+    /** When it was first published, kept from the old site (default: now). */
+    publishedAt?: string;
+    /** `draft` imports it unpublished. Default `published`. */
+    status?: PostStatus;
+}
+interface ImportPostsResult {
+    /** Imported posts: published, or a draft when asked for or when a check failed (see `issues`). */
+    imported: {
+        slug: string;
+        id: string;
+        status: PostStatus;
+        issues?: string[];
+    }[];
+    /** Posts left out: a slug the site already has, or a document that doesn't parse. */
+    skipped: {
+        slug: string;
+        reason: string;
+    }[];
+}
+/** The most posts one `importPosts` call takes. */
+declare const MAX_IMPORT_POSTS = 500;
+/** A published post as a list item. */
+declare function postSummary(post: LivePost): PostSummary;
+/** Plain text of a rich text document (for a feed's description when a post has no excerpt). */
+declare function richTextPlain(value: unknown, max?: number): string;
+/** Validate a post slug, throwing with a readable message. */
+declare function validatePostSlug(slug: string): string;
+
+/**
+ * Sections: `defineSection` describes one kind of section (its props schema,
+ * variants, presets, migrations and server-safe React renderer), and the
+ * registry holds every kind a site can use.
+ *
+ * Modelled on genesis-forms' `registerContentType`: one registry per process,
+ * kept on a `Symbol.for` global so two copies of this package (a host's and a
+ * dependency's) share it; manifests are frozen; a host adds its own kinds and
+ * replaces a built-in only with `{ replace: true }`.
+ *
+ * Everything the editor needs comes from the definition: `label`,
+ * `category`, `variants`, `presets` and `sectionJsonSchema(type)`
+ * (`z.toJSONSchema` of the props schema) for its fields and for AI output.
+ */
+
+declare const SECTION_CATEGORIES: readonly ["header", "intro", "content", "social-proof", "conversion", "footer"];
+type SectionCategory = (typeof SECTION_CATEGORIES)[number];
+/** Where on a page a section may go: the site header, the page body, or the site footer. */
+type SectionPlacement = "header" | "body" | "footer";
+interface SectionVariant {
+    id: string;
+    label: string;
+}
+interface SectionPreset<P = Record<string, unknown>> {
+    /** Shown in the editor's Add picker. */
+    name: string;
+    variant: string;
+    props: P;
+}
+/** What a section's renderer is told about the page it is on. */
+interface RenderContext {
+    /**
+     * The level of the section's title: 1 for the page's main heading (the
+     * first section that `providesH1`), 2 for every other section. Items in a
+     * section are one level below it.
+     */
+    headingLevel: 1 | 2;
+    site: {
+        name: string;
+        lang: string;
+        nav: readonly MenuItem[];
+        logo?: {
+            src: string;
+            alt: string;
+        } | undefined;
+    };
+    /** The page's own path, such as `/about`. */
+    pagePath: string;
+    /** A stored link as the page should print it: site paths get the host's base path. */
+    href(href: string): string;
+    /** Forms on the page, resolved by slug before rendering (null: the host doesn't know the slug). */
+    forms: ReadonlyMap<string, ResolvedForm | null>;
+    mode: "live" | "preview";
+    /** A prefix that makes ids unique on the page: the section node's id. */
+    idPrefix: string;
+    /**
+     * The site's blog, when it has a post page: its path, the published posts
+     * (newest first, without bodies), the post this page shows (on
+     * `<path>/<slug>`), and the list's page number (`?page=`).
+     */
+    posts?: PostsContext;
+}
+interface PostsContext {
+    /** The post page's path (`/blog`): posts live at `<path>/<slug>`. */
+    path: string;
+    list: readonly PostSummary[];
+    current: LivePost | null;
+    /** The list's page, from `?page=` (1 when absent). */
+    page: number;
+}
+interface SectionRenderProps<P> {
+    props: P;
+    variant: string;
+    node: SectionNode;
+    ctx: RenderContext;
+}
+interface SectionDefinition<P = Record<string, unknown>> {
+    /** The registry key stored in each node: lowercase, such as `hero`. */
+    type: string;
+    /** The current props version. Nodes at a lower `v` are migrated on read. */
+    version: number;
+    label: string;
+    description?: string;
+    category: SectionCategory;
+    /** The props schema (zod 4). Its input type is what an editor writes. */
+    schema: z.ZodType<P>;
+    variants: readonly SectionVariant[];
+    defaultVariant: string;
+    presets: readonly SectionPreset<z.input<z.ZodType<P>>>[];
+    /** At most this many on a page. */
+    limit?: number;
+    /** The page kinds it may appear on (default: every kind). */
+    enabledOn?: readonly PageKind[];
+    /** Where it may go (default: the page body). */
+    placement?: SectionPlacement;
+    /** Its title is the page's `h1` when it comes first (a hero). */
+    providesH1?: boolean;
+    /**
+     * `migrations[n]` turns version `n - 1` props into version `n` props. Pure
+     * functions: `migrateNode` runs them in order on read, in the editor and in
+     * the renderer, and a publish writes the result into the release.
+     */
+    migrations?: Readonly<Record<number, (props: Record<string, unknown>) => Record<string, unknown>>>;
+    /**
+     * The https origins this section frames (a map), so the page's
+     * Content-Security-Policy allows them in `frame-src`. Only origins the
+     * section builds itself, never a URL an editor typed.
+     */
+    frameOrigins?: (props: P) => readonly string[];
+    /** It needs the islands loader (a click-to-load map, say). */
+    islands?: boolean;
+    /** Server-safe React: no state, no effects, no browser APIs. Returning null gives the page's h1 back. */
+    render: (input: SectionRenderProps<P>) => ReactNode;
+}
+/** A definition as the registry holds it: props erased to a record. */
+type AnySectionDefinition = SectionDefinition<any>;
+declare class SectionDefinitionError extends Error {
+    readonly problems: string[];
+    constructor(problems: string[]);
+}
+/**
+ * Declare a section kind. Checks the definition (and every preset against its
+ * schema) and returns it frozen. It isn't registered until `registerSection`.
+ *
+ * @stability Beta
+ */
+declare function defineSection<P>(def: SectionDefinition<P>): Readonly<SectionDefinition<P>>;
+/** The built-in section kinds, which a host replaces only with `{ replace: true }`. */
+declare const BUILT_IN_SECTION_TYPES: readonly ["nav", "hero", "features", "cta", "testimonials", "faq", "pricing", "logos", "stats", "gallery", "rich-text", "form-embed", "footer", "schedule", "team", "blog-list", "post-body", "map", "timeline", "file"];
+type BuiltInSectionType = (typeof BUILT_IN_SECTION_TYPES)[number];
+interface RegisterSectionOptions {
+    /** Replace a built-in kind, for every site in this process. */
+    replace?: boolean;
+}
+/**
+ * Register a section kind (from `defineSection`, or a plain definition, which
+ * is checked the same way). Re-registering a host kind replaces it, so hot
+ * reload works; a built-in kind's name throws unless `{ replace: true }`.
+ *
+ * @stability Beta
+ */
+declare function registerSection(def: AnySectionDefinition, options?: RegisterSectionOptions): void;
+/** For `@marktiderman/genesis-sites/sections`: register a built-in unless one (or a replacement) is there. @internal */
+declare function registerBuiltInSection(def: AnySectionDefinition): void;
+declare function getSection(type: string): AnySectionDefinition | undefined;
+declare function listSections(): AnySectionDefinition[];
+/** Remove a host section kind (tests, hot reload). Built-ins can't be removed, only replaced. */
+declare function unregisterSection(type: string): boolean;
+/**
+ * The JSON Schema of a section's props (`z.toJSONSchema`, input side), for the
+ * editor's fields and for validating AI output. Refinements (safe URLs) don't
+ * appear in JSON Schema; the zod schema still checks them on save.
+ *
+ * @stability Beta
+ */
+declare function sectionJsonSchema(typeOrDef: string | AnySectionDefinition): Record<string, unknown>;
+/** What the editor's Add picker and fields need about one section kind. */
+interface SectionManifest {
+    type: string;
+    version: number;
+    label: string;
+    description?: string;
+    category: SectionCategory;
+    placement: SectionPlacement;
+    variants: readonly SectionVariant[];
+    defaultVariant: string;
+    presets: readonly SectionPreset[];
+    limit?: number;
+    enabledOn?: readonly PageKind[];
+    jsonSchema: Record<string, unknown>;
+}
+/** Every registered section as editor data (no renderers): the editor's catalog. @stability Beta */
+declare function sectionManifests(): SectionManifest[];
+/** A new section id: short, alphanumeric, unique enough within a page. */
+declare function newSectionId(prefix?: string): string;
+/** A section node from a preset: the editor's Add, and templates. */
+declare function nodeFromPreset(type: string, presetName?: string, id?: string): SectionNode;
+
+export { type SectionManifest as $, type AnySectionDefinition as A, BUILT_IN_SECTION_TYPES as B, Copy as C, PostSummarySchema as D, type PostsContext as E, FileRef as F, type RegisterSectionOptions as G, Href as H, Image as I, type Release as J, type ReleaseMeta as K, type LivePost as L, MAX_DOC_BYTES as M, ReleaseSnapshot as N, type RenderContext as O, PageDoc as P, type ResolvedForm as Q, ReleasePage as R, SectionNode as S, RichText as T, SECTION_CATEGORIES as U, type SavePostInput as V, type SavePostResult as W, type SectionCategory as X, type SectionDefinition as Y, SectionDefinitionError as Z, SectionId as _, SiteDoc as a, type SectionPlacement as a0, type SectionPreset as a1, type SectionRenderProps as a2, type SectionVariant as a3, Seo as a4, SeoDefaults as a5, Surface as a6, TokenOverrides as a7, defineSection as a8, getSection as a9, isPlainEmail as aa, listSections as ab, mailtoHref as ac, newSectionId as ad, nodeFromPreset as ae, opensInNewTab as af, parseSnapshot as ag, postSummary as ah, registerBuiltInSection as ai, registerSection as aj, richTextPlain as ak, sectionJsonSchema as al, sectionManifests as am, unregisterSection as an, validatePostSlug as ao, type PostSummary as b, Redirect as c, Link as d, type SiteDocInput as e, PageKind as f, type BuiltInSectionType as g, FontChoice as h, type FormsResolver as i, type FormsResolverContext as j, type ImportPost as k, type ImportPostsResult as l, Line as m, LinkEvent as n, MAX_IMPORT_POSTS as o, MAX_LIVE_POSTS as p, MenuItem as q, type PageMeta as r, PagePath as s, PostAuthor as t, PostDoc as u, type PostDocInput as v, type PostDraft as w, type PostMeta as x, PostSlug as y, type PostStatus as z };