@caltho/site-kit 0.2.10 → 0.3.0

package/dist/content/index.d.ts

@@ -1,10 +1,14 @@
 import type { ShareOptions } from "../share.ts";
 export type { CardNode, ShareCard, ShareFont, ShareOptions } from "../share.ts";
 import { z } from "zod";
+import { type Node } from "../tree/index.ts";
+import { type Consent } from "../consent.ts";
 import { type Look, type LookOptions } from "./look.ts";
-export { contrast, lookCss, lookProblems, lookVars, type Look, type LookOptions } from "./look.ts";
-export { checkStructure, describePath, type StructureIssue } from "../schema.ts";
+export { COLOUR_ROLES, colourOf, contrast, HEADER_LAYOUTS, HEADER_STYLES, headerOf, isDark, KIT_FONTS, KIT_TYPE, lookCss, lookProblems, lookVars, swatchSlug, TYPE_ROLES, uploadedFontCss, buttonStyleClass, BUTTON_SIZES, MAX_BUTTON_STYLES, THEME_BUTTONS, type ButtonStyle, type ColourRole, type HeaderLayout, type HeaderLook, type HeaderStyle, type Look, type LookOptions, type Space, type Swatch, type TypeRole, type TypeScale, type TypeStyle, type UploadedFont, } from "./look.ts";
+export { fontFaceCss, fontFiles, googleFamily, googleFont, googleFonts, isFontName, servedAt, type FontFile, type FontKind, type GoogleFont } from "../fonts-google.ts";
+export { blockLabel, checkStructure, describePath, type StructureIssue } from "../schema.ts";
 export { z };
+export { allPages, FIELD_KINDS, fromList, itemOf, itemPages, itemPath, PAGE_LINK, THIS_ITEM, withListItems, type FieldKind, type FromList, type List, type ListField, type ListItem, type ListPage } from "./lists.ts";
 export declare const text: z.ZodString;
 /** Longer plain text: drawn as a text area. */
 export declare const longText: z.ZodString;
@@ -22,6 +26,7 @@ export declare const link: z.ZodObject<{
     label: z.ZodString;
     href: z.ZodString;
     style: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
         primary: "primary";
         secondary: "secondary";
     }>>;
@@ -29,10 +34,15 @@ export declare const link: z.ZodObject<{
 export declare const time: z.ZodString;
 export declare const DAYS: readonly ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"];
 /**
- * How a section sits on the page, for a site that offers it (defineSite's `placement`): its alignment,
- * width, spacing and the screens it shows on. The site's design says what each means at every width,
- * so a choice here stays sensible on a phone. CalOS shows it as the section's Layout. (A block's own
- * `layout`, a site's choice of how it's drawn, is a different thing and keeps its name.)
+ * How a section sits on the page, offered on every section (defineSite's `placement`, on unless a site
+ * turns it off): its alignment, width, spacing, the screens it shows on, and what's behind it. The
+ * site's design says what each means at every width, so a choice here stays sensible on a phone.
+ * CalOS shows it as the section's Layout. (A block's own `layout`, a site's choice of how it's drawn,
+ * is a different thing and keeps its name.)
+ *
+ * Its background is drawn by KitBlocks (../next/blocks.tsx) as a frame around the section: a colour
+ * (one of the page's, by its role, or one of the site's own, by its slug) and a photo, shaded so the
+ * words over it read.
  */
 export declare const placement: z.ZodObject<{
     align: z.ZodDefault<z.ZodEnum<{
@@ -41,8 +51,8 @@ export declare const placement: z.ZodObject<{
     }>>;
     width: z.ZodDefault<z.ZodEnum<{
         normal: "normal";
-        narrow: "narrow";
         wide: "wide";
+        narrow: "narrow";
     }>>;
     spacing: z.ZodDefault<z.ZodEnum<{
         normal: "normal";
@@ -50,16 +60,64 @@ export declare const placement: z.ZodObject<{
         roomy: "roomy";
     }>>;
     show: z.ZodDefault<z.ZodEnum<{
-        phone: "phone";
         all: "all";
+        phone: "phone";
         desktop: "desktop";
     }>>;
+    lines: z.ZodOptional<z.ZodEnum<{
+        top: "top";
+        none: "none";
+        both: "both";
+        bottom: "bottom";
+    }>>;
+    lineColour: z.ZodOptional<z.ZodEnum<{
+        strong: "strong";
+        quiet: "quiet";
+    }>>;
+    background: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        photo: z.ZodOptional<z.ZodObject<{
+            src: z.ZodString;
+            alt: z.ZodString;
+        }, z.core.$strip>>;
+        overlay: z.ZodDefault<z.ZodEnum<{
+            dark: "dark";
+            none: "none";
+            light: "light";
+        }>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Placement = z.output<typeof placement>;
-/** A section's placement as class names, only what differs from the usual: "place-align-center place-width-narrow", or "". */
+export type Background = NonNullable<Placement["background"]>;
+/** A section's placement as class names, only what differs from the usual: "place-align-center place-width-narrow", or "". Its background is the frame's (frameClass). */
 export declare function placementClass(block: {
     placement?: Partial<Placement>;
 }): string;
+/** The classes of the lines across a section's full width (KitBlocks wraps it in them), or "" for none. */
+export declare function linesClass(block: {
+    placement?: Partial<Placement>;
+}): string;
+/** Whether a section has something behind it (a colour or a photo), and so a frame. */
+export declare function hasBackground(block: {
+    placement?: Partial<Placement>;
+}): boolean;
+/**
+ * Whether a section's background is dark, so its words go light: under a photo, by its shade (dark
+ * or none: light words; light: dark words); else by its colour's value in the Look (`vars`, from
+ * lookVars, at build and in the preview alike). A colour it can't find counts as light.
+ */
+export declare function backgroundIsDark(block: {
+    placement?: Partial<Placement>;
+}, vars?: Record<string, string>): boolean;
+/**
+ * The classes of the frame KitBlocks draws around a section with a background, or "" for one
+ * without: `kit-frame`, its colour (`kit-bg-soft`, or `kit-bg-swatch-2` for the site's second own
+ * colour, found in `vars`), `kit-frame-photo kit-overlay-dark` under a photo, and `kit-frame-dark`
+ * when its words go light (backgroundIsDark). sections.css draws them from the Look's variables.
+ */
+export declare function frameClass(block: {
+    placement?: Partial<Placement>;
+}, vars?: Record<string, string>): string;
 /** The business's facts: the header, footer, hours, contact details and search data all come from here. */
 export declare const business: z.ZodObject<{
     name: z.ZodString;
@@ -137,16 +195,22 @@ export type Redirect = {
     status: 301 | 302;
 };
 /** What every site has, whatever its blocks. */
+/** A link in the menu; `children` (up to 8, one level) open under it: a dropdown on a wide screen, indented in a phone's menu. */
 export type MenuLink = {
     label: string;
     href: string;
     emphasis?: boolean;
+    children?: {
+        label: string;
+        href: string;
+    }[];
 };
 export type Menu = {
     links: MenuLink[];
     button?: {
         label: string;
         href: string;
+        style?: string;
     };
 };
 export type FooterLink = {
@@ -162,6 +226,8 @@ export type Footer = {
     note?: string;
 };
 export type SiteBase = {
+    format?: number; /** Whether it asks before counting visits, and its banner (../consent.ts). */
+    consent?: Consent;
     url: string;
     lang: string;
     business: Business;
@@ -171,11 +237,12 @@ export type SiteBase = {
     look?: Look;
     redirects: Redirect[]; /** Whether page paths end in a slash (the default). */
     trailingSlash?: boolean; /** Set by prepare, never in content: CalOS counts this site's visits (its pages carry the script), which its privacy policy says. */
-    countsVisits?: boolean;
+    countsVisits?: boolean; /** Set by prepare (and CalOS's preview), never in content: the business's forms' addresses by key, for a built form's sendTo. */
+    forms?: Record<string, string>;
 };
 /**
  * The site's menu, as its header draws it: the one edited in CalOS (its links in order, one picked out,
- * and the header's button), else the pages that have a menu label, in page order (and no button: the
+ * each with the links under it if it has any, and the header's button), else the pages that have a menu label, in page order (and no button: the
  * site's own default).
  */
 export declare function menuOf(site: Pick<Site, "pages" | "menu">): Menu;
@@ -217,17 +284,22 @@ export type DefineOptions = {
     refine?: (site: Site, ctx: z.RefinementCtx) => void;
     /** How each page's share card looks (colours, fonts, a logo, or a card of the site's own); `false` for none (../share.ts). */
     share?: ShareOptions;
-    /** Every section gets a Layout (placement: alignment, width, spacing, screens), drawn by the site through placementClass. */
+    /** Every section gets a Layout (placement: alignment, width, spacing, screens, background), drawn by the site through placementClass and KitBlocks. On unless `false`. */
     placement?: boolean;
     /** The site's Look, chosen in CalOS (fonts from the ones it carries, colours, corners, buttons), drawn through CSS variables (./look.ts). */
     look?: LookOptions;
 };
-/**
- * A site's content shape from its blocks: each a name and the fields it has. The site's own block
- * type is `z.output<typeof content.schema>["pages"][number]["blocks"][number]`.
- */
 export declare function defineSite<const B extends Record<string, z.ZodObject>>(blocks: B, o?: DefineOptions): {
     schema: z.ZodObject<{
+        saved: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            block: z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">;
+        }, z.core.$strip>>>;
+        components?: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            name: z.ZodString;
+            root: z.ZodType<Node, unknown, z.core.$ZodTypeInternals<Node, unknown>>;
+        }, z.core.$strip>>> | undefined;
         pages: z.ZodArray<z.ZodObject<{
             blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">>;
             path: z.ZodString;
@@ -242,13 +314,129 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
             shareText: z.ZodOptional<z.ZodString>;
             noindex: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
-        saved: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        lists: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             name: z.ZodString;
-            block: z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">;
+            fields: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                kind: z.ZodEnum<{
+                    number: "number";
+                    date: "date";
+                    text: "text";
+                    image: "image";
+                    link: "link";
+                    longText: "longText";
+                }>;
+            }, z.core.$strip>>;
+            items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                slug: z.ZodString;
+            }, z.core.$catchall<z.ZodUnknown>>>>;
+            page: z.ZodOptional<z.ZodObject<{
+                path: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">>;
+            }, z.core.$strip>>;
+            source: z.ZodOptional<z.ZodObject<{
+                table: z.ZodString;
+                fields: z.ZodRecord<z.ZodString, z.ZodString>;
+                publish: z.ZodDefault<z.ZodEnum<{
+                    draft: "draft";
+                    auto: "auto";
+                }>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>>;
         look?: z.ZodOptional<z.ZodObject<{
+            uploadedFonts?: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                family: z.ZodString;
+                files: z.ZodArray<z.ZodObject<{
+                    src: z.ZodString;
+                    weight: z.ZodString;
+                    style: z.ZodEnum<{
+                        normal: "normal";
+                        italic: "italic";
+                    }>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>> | undefined;
+            footer?: z.ZodDefault<z.ZodObject<{
+                background: z.ZodDefault<z.ZodString>;
+            }, z.core.$strip>> | undefined;
+            header?: z.ZodDefault<z.ZodObject<{
+                sticky: z.ZodDefault<z.ZodBoolean>;
+                style: z.ZodDefault<z.ZodEnum<{
+                    line: "line";
+                    plain: "plain";
+                    brand: "brand";
+                    floating: "floating";
+                }>>;
+                layout: z.ZodDefault<z.ZodEnum<{
+                    left: "left";
+                    spread: "spread";
+                    centered: "centered";
+                }>>;
+                menuShows: z.ZodDefault<z.ZodEnum<{
+                    icon: "icon";
+                    both: "both";
+                    word: "word";
+                }>>;
+                menuStyle: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>> | undefined;
             brand: z.ZodDefault<z.ZodString>;
             accent: z.ZodDefault<z.ZodString>;
+            page: z.ZodDefault<z.ZodString>;
+            ink: z.ZodDefault<z.ZodString>;
+            muted: z.ZodDefault<z.ZodString>;
+            line: z.ZodDefault<z.ZodString>;
+            soft: z.ZodDefault<z.ZodString>;
+            palette: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                color: z.ZodString;
+            }, z.core.$strip>>>;
+            type: z.ZodDefault<z.ZodObject<{
+                h1: z.ZodOptional<z.ZodObject<{
+                    size: z.ZodOptional<z.ZodNumber>;
+                    weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                    tracking: z.ZodOptional<z.ZodNumber>;
+                    leading: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                h2: z.ZodOptional<z.ZodObject<{
+                    size: z.ZodOptional<z.ZodNumber>;
+                    weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                    tracking: z.ZodOptional<z.ZodNumber>;
+                    leading: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                h3: z.ZodOptional<z.ZodObject<{
+                    size: z.ZodOptional<z.ZodNumber>;
+                    weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                    tracking: z.ZodOptional<z.ZodNumber>;
+                    leading: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                small: z.ZodOptional<z.ZodObject<{
+                    size: z.ZodOptional<z.ZodNumber>;
+                    weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                    tracking: z.ZodOptional<z.ZodNumber>;
+                    leading: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                body: z.ZodOptional<z.ZodObject<{
+                    size: z.ZodOptional<z.ZodNumber>;
+                    weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                    tracking: z.ZodOptional<z.ZodNumber>;
+                    leading: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                display: z.ZodOptional<z.ZodObject<{
+                    size: z.ZodOptional<z.ZodNumber>;
+                    weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                    tracking: z.ZodOptional<z.ZodNumber>;
+                    leading: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            width: z.ZodDefault<z.ZodNumber>;
+            space: z.ZodDefault<z.ZodEnum<{
+                normal: "normal";
+                compact: "compact";
+                roomy: "roomy";
+            }>>;
             corners: z.ZodDefault<z.ZodEnum<{
                 square: "square";
                 soft: "soft";
@@ -258,13 +446,33 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                 solid: "solid";
                 outline: "outline";
             }>>;
-            headingFont?: z.ZodDefault<z.ZodEnum<{
-                [x: string]: string;
-            }>> | undefined;
-            bodyFont?: z.ZodDefault<z.ZodEnum<{
-                [x: string]: string;
-            }>> | undefined;
+            radius: z.ZodOptional<z.ZodNumber>;
+            buttonRadius: z.ZodOptional<z.ZodNumber>;
+            buttonStyles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                fill: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                border: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodOptional<z.ZodNumber>;
+                    color: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                radius: z.ZodOptional<z.ZodNumber>;
+                size: z.ZodOptional<z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    large: "large";
+                }>>;
+                weight: z.ZodOptional<z.ZodNumber>;
+                caps: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+            buttonBorder: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                color: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            headingFont?: z.ZodDefault<z.ZodString> | undefined;
+            bodyFont?: z.ZodDefault<z.ZodString> | undefined;
         }, z.core.$strip>> | undefined;
+        format: z.ZodOptional<z.ZodNumber>;
         url: z.ZodURL;
         lang: z.ZodDefault<z.ZodString>;
         business: z.ZodObject<{
@@ -320,10 +528,15 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                 label: z.ZodString;
                 href: z.ZodString;
                 emphasis: z.ZodDefault<z.ZodBoolean>;
+                children: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodString;
+                }, z.core.$strip>>>;
             }, z.core.$strip>>;
             button: z.ZodOptional<z.ZodObject<{
                 label: z.ZodString;
                 href: z.ZodString;
+                style: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         footer: z.ZodOptional<z.ZodObject<{
@@ -340,6 +553,31 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
             }, z.core.$strip>>>;
             note: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        ownHeader: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            root: z.ZodType<Node, unknown, z.core.$ZodTypeInternals<Node, unknown>>;
+        }, z.core.$strip>>;
+        ownFooter: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            root: z.ZodType<Node, unknown, z.core.$ZodTypeInternals<Node, unknown>>;
+        }, z.core.$strip>>;
+        consent: z.ZodOptional<z.ZodObject<{
+            on: z.ZodDefault<z.ZodBoolean>;
+            text: z.ZodDefault<z.ZodString>;
+            accept: z.ZodDefault<z.ZodString>;
+            decline: z.ZodDefault<z.ZodString>;
+            policy: z.ZodOptional<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+            }, z.core.$strip>>;
+            place: z.ZodDefault<z.ZodEnum<{
+                top: "top";
+                bottom: "bottom";
+                "bottom-left": "bottom-left";
+                "bottom-right": "bottom-right";
+            }>>;
+            design: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         redirects: z.ZodDefault<z.ZodArray<z.ZodObject<{
             from: z.ZodString;
             to: z.ZodString;
@@ -349,6 +587,15 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
     /** The content checked, or every problem in it as "where: what" lines. */
     parse(raw: unknown): {
         site: z.output<z.ZodObject<{
+            saved: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                block: z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">;
+            }, z.core.$strip>>>;
+            components?: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                name: z.ZodString;
+                root: z.ZodType<Node, unknown, z.core.$ZodTypeInternals<Node, unknown>>;
+            }, z.core.$strip>>> | undefined;
             pages: z.ZodArray<z.ZodObject<{
                 blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">>;
                 path: z.ZodString;
@@ -363,13 +610,129 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                 shareText: z.ZodOptional<z.ZodString>;
                 noindex: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$strip>>;
-            saved: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            lists: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
                 name: z.ZodString;
-                block: z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">;
+                fields: z.ZodArray<z.ZodObject<{
+                    key: z.ZodString;
+                    label: z.ZodString;
+                    kind: z.ZodEnum<{
+                        number: "number";
+                        date: "date";
+                        text: "text";
+                        image: "image";
+                        link: "link";
+                        longText: "longText";
+                    }>;
+                }, z.core.$strip>>;
+                items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    slug: z.ZodString;
+                }, z.core.$catchall<z.ZodUnknown>>>>;
+                page: z.ZodOptional<z.ZodObject<{
+                    path: z.ZodString;
+                    title: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">>;
+                }, z.core.$strip>>;
+                source: z.ZodOptional<z.ZodObject<{
+                    table: z.ZodString;
+                    fields: z.ZodRecord<z.ZodString, z.ZodString>;
+                    publish: z.ZodDefault<z.ZodEnum<{
+                        draft: "draft";
+                        auto: "auto";
+                    }>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>>>;
             look?: z.ZodOptional<z.ZodObject<{
+                uploadedFonts?: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    family: z.ZodString;
+                    files: z.ZodArray<z.ZodObject<{
+                        src: z.ZodString;
+                        weight: z.ZodString;
+                        style: z.ZodEnum<{
+                            normal: "normal";
+                            italic: "italic";
+                        }>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>> | undefined;
+                footer?: z.ZodDefault<z.ZodObject<{
+                    background: z.ZodDefault<z.ZodString>;
+                }, z.core.$strip>> | undefined;
+                header?: z.ZodDefault<z.ZodObject<{
+                    sticky: z.ZodDefault<z.ZodBoolean>;
+                    style: z.ZodDefault<z.ZodEnum<{
+                        line: "line";
+                        plain: "plain";
+                        brand: "brand";
+                        floating: "floating";
+                    }>>;
+                    layout: z.ZodDefault<z.ZodEnum<{
+                        left: "left";
+                        spread: "spread";
+                        centered: "centered";
+                    }>>;
+                    menuShows: z.ZodDefault<z.ZodEnum<{
+                        icon: "icon";
+                        both: "both";
+                        word: "word";
+                    }>>;
+                    menuStyle: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>> | undefined;
                 brand: z.ZodDefault<z.ZodString>;
                 accent: z.ZodDefault<z.ZodString>;
+                page: z.ZodDefault<z.ZodString>;
+                ink: z.ZodDefault<z.ZodString>;
+                muted: z.ZodDefault<z.ZodString>;
+                line: z.ZodDefault<z.ZodString>;
+                soft: z.ZodDefault<z.ZodString>;
+                palette: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    color: z.ZodString;
+                }, z.core.$strip>>>;
+                type: z.ZodDefault<z.ZodObject<{
+                    h1: z.ZodOptional<z.ZodObject<{
+                        size: z.ZodOptional<z.ZodNumber>;
+                        weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                        tracking: z.ZodOptional<z.ZodNumber>;
+                        leading: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    h2: z.ZodOptional<z.ZodObject<{
+                        size: z.ZodOptional<z.ZodNumber>;
+                        weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                        tracking: z.ZodOptional<z.ZodNumber>;
+                        leading: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    h3: z.ZodOptional<z.ZodObject<{
+                        size: z.ZodOptional<z.ZodNumber>;
+                        weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                        tracking: z.ZodOptional<z.ZodNumber>;
+                        leading: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    small: z.ZodOptional<z.ZodObject<{
+                        size: z.ZodOptional<z.ZodNumber>;
+                        weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                        tracking: z.ZodOptional<z.ZodNumber>;
+                        leading: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    body: z.ZodOptional<z.ZodObject<{
+                        size: z.ZodOptional<z.ZodNumber>;
+                        weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                        tracking: z.ZodOptional<z.ZodNumber>;
+                        leading: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    display: z.ZodOptional<z.ZodObject<{
+                        size: z.ZodOptional<z.ZodNumber>;
+                        weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
+                        tracking: z.ZodOptional<z.ZodNumber>;
+                        leading: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                width: z.ZodDefault<z.ZodNumber>;
+                space: z.ZodDefault<z.ZodEnum<{
+                    normal: "normal";
+                    compact: "compact";
+                    roomy: "roomy";
+                }>>;
                 corners: z.ZodDefault<z.ZodEnum<{
                     square: "square";
                     soft: "soft";
@@ -379,13 +742,33 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                     solid: "solid";
                     outline: "outline";
                 }>>;
-                headingFont?: z.ZodDefault<z.ZodEnum<{
-                    [x: string]: string;
-                }>> | undefined;
-                bodyFont?: z.ZodDefault<z.ZodEnum<{
-                    [x: string]: string;
-                }>> | undefined;
+                radius: z.ZodOptional<z.ZodNumber>;
+                buttonRadius: z.ZodOptional<z.ZodNumber>;
+                buttonStyles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    fill: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    border: z.ZodOptional<z.ZodObject<{
+                        width: z.ZodOptional<z.ZodNumber>;
+                        color: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    radius: z.ZodOptional<z.ZodNumber>;
+                    size: z.ZodOptional<z.ZodEnum<{
+                        small: "small";
+                        medium: "medium";
+                        large: "large";
+                    }>>;
+                    weight: z.ZodOptional<z.ZodNumber>;
+                    caps: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>>;
+                buttonBorder: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodNumber;
+                    color: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                headingFont?: z.ZodDefault<z.ZodString> | undefined;
+                bodyFont?: z.ZodDefault<z.ZodString> | undefined;
             }, z.core.$strip>> | undefined;
+            format: z.ZodOptional<z.ZodNumber>;
             url: z.ZodURL;
             lang: z.ZodDefault<z.ZodString>;
             business: z.ZodObject<{
@@ -441,10 +824,15 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                     label: z.ZodString;
                     href: z.ZodString;
                     emphasis: z.ZodDefault<z.ZodBoolean>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        label: z.ZodString;
+                        href: z.ZodString;
+                    }, z.core.$strip>>>;
                 }, z.core.$strip>>;
                 button: z.ZodOptional<z.ZodObject<{
                     label: z.ZodString;
                     href: z.ZodString;
+                    style: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
             footer: z.ZodOptional<z.ZodObject<{
@@ -461,6 +849,31 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                 }, z.core.$strip>>>;
                 note: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
+            ownHeader: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                root: z.ZodType<Node, unknown, z.core.$ZodTypeInternals<Node, unknown>>;
+            }, z.core.$strip>>;
+            ownFooter: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                root: z.ZodType<Node, unknown, z.core.$ZodTypeInternals<Node, unknown>>;
+            }, z.core.$strip>>;
+            consent: z.ZodOptional<z.ZodObject<{
+                on: z.ZodDefault<z.ZodBoolean>;
+                text: z.ZodDefault<z.ZodString>;
+                accept: z.ZodDefault<z.ZodString>;
+                decline: z.ZodDefault<z.ZodString>;
+                policy: z.ZodOptional<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodString;
+                }, z.core.$strip>>;
+                place: z.ZodDefault<z.ZodEnum<{
+                    top: "top";
+                    bottom: "bottom";
+                    "bottom-left": "bottom-left";
+                    "bottom-right": "bottom-right";
+                }>>;
+                design: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
             redirects: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 from: z.ZodString;
                 to: z.ZodString;
@@ -480,7 +893,11 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
     csp: Record<string, string[]>;
     share: ShareOptions | undefined;
     look: LookOptions | undefined;
-    /** The declaration CalOS draws its editing forms from. */
+    /**
+     * The declaration CalOS draws its editing forms from. A site with sections of the business's own
+     * (`own`) carries the ready-made ones it can start from, each one this site's schema takes, as
+     * `x-presets`: [{ key, name, description, block }].
+     */
     jsonSchema: () => Record<string, unknown>;
 };
 export type SiteDefinition = ReturnType<typeof defineSite>;