@marktiderman/genesis-sites 0.0.0-stage → 0.1.0

package/dist/registry-CdgVymsu.d.ts

@@ -0,0 +1,764 @@
+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>>;
+/** A labelled link: a button, a menu entry, a footer link. */
+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>;
+}, z.core.$strip>;
+type Link = z.infer<typeof Link>;
+/**
+ * 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>;
+declare const PageKind: z.ZodEnum<{
+    page: "page";
+    landing: "landing";
+}>;
+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";
+    }>;
+    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";
+        }>;
+        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. The page renders it on the
+ *   server with forms-web's `<Form>`, and the form island makes it
+ *   interactive; answers are POSTed as JSON to `submitUrl` (the host's
+ *   endpoint, for example one that runs genesis-forms destinations).
+ * - `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: "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>;
+
+/**
+ * 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;
+}
+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>>>;
+    /** Server-safe React: no state, no effects, no browser APIs. */
+    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"];
+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 { unregisterSection as $, type AnySectionDefinition as A, BUILT_IN_SECTION_TYPES as B, Copy as C, type SectionRenderProps as D, type SectionVariant as E, FontChoice as F, Seo as G, Href as H, Image as I, SeoDefaults as J, Surface as K, Link as L, MAX_DOC_BYTES as M, defineSection as N, getSection as O, PageDoc as P, listSections as Q, ReleasePage as R, SectionNode as S, TokenOverrides as T, newSectionId as U, nodeFromPreset as V, parseSnapshot as W, registerBuiltInSection as X, registerSection as Y, sectionJsonSchema as Z, sectionManifests as _, SiteDoc as a, Redirect as b, type SiteDocInput as c, PageKind as d, type BuiltInSectionType as e, type FormsResolver as f, type FormsResolverContext as g, Line as h, MenuItem as i, type PageMeta as j, PagePath as k, type RegisterSectionOptions as l, type Release as m, type ReleaseMeta as n, ReleaseSnapshot as o, type RenderContext as p, type ResolvedForm as q, RichText as r, SECTION_CATEGORIES as s, type SectionCategory as t, type SectionDefinition as u, SectionDefinitionError as v, SectionId as w, type SectionManifest as x, type SectionPlacement as y, type SectionPreset as z };