@caltho/site-kit 0.2.11 → 0.3.0

package/dist/content/index.d.ts

@@ -1,11 +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 { 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;
@@ -57,19 +60,19 @@ 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<{
-        both: "both";
-        none: "none";
         top: "top";
+        none: "none";
+        both: "both";
         bottom: "bottom";
     }>>;
     lineColour: z.ZodOptional<z.ZodEnum<{
-        quiet: "quiet";
         strong: "strong";
+        quiet: "quiet";
     }>>;
     background: z.ZodOptional<z.ZodObject<{
         color: z.ZodOptional<z.ZodString>;
@@ -79,8 +82,8 @@ export declare const placement: z.ZodObject<{
         }, z.core.$strip>>;
         overlay: z.ZodDefault<z.ZodEnum<{
             dark: "dark";
-            light: "light";
             none: "none";
+            light: "light";
         }>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -223,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;
@@ -232,7 +237,8 @@ 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,
@@ -283,12 +289,17 @@ export type DefineOptions = {
     /** 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;
@@ -303,9 +314,38 @@ 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<{
@@ -331,13 +371,13 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                     floating: "floating";
                 }>>;
                 layout: z.ZodDefault<z.ZodEnum<{
+                    left: "left";
                     spread: "spread";
                     centered: "centered";
-                    left: "left";
                 }>>;
                 menuShows: z.ZodDefault<z.ZodEnum<{
-                    both: "both";
                     icon: "icon";
+                    both: "both";
                     word: "word";
                 }>>;
                 menuStyle: z.ZodOptional<z.ZodString>;
@@ -354,39 +394,39 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                 color: z.ZodString;
             }, z.core.$strip>>>;
             type: z.ZodDefault<z.ZodObject<{
-                display: z.ZodOptional<z.ZodObject<{
+                h1: z.ZodOptional<z.ZodObject<{
                     size: z.ZodOptional<z.ZodNumber>;
-                    weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                    weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
                     tracking: z.ZodOptional<z.ZodNumber>;
                     leading: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
-                h1: z.ZodOptional<z.ZodObject<{
+                h2: z.ZodOptional<z.ZodObject<{
                     size: z.ZodOptional<z.ZodNumber>;
-                    weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                    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<{
+                h3: z.ZodOptional<z.ZodObject<{
                     size: z.ZodOptional<z.ZodNumber>;
-                    weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                    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<{
+                small: z.ZodOptional<z.ZodObject<{
                     size: z.ZodOptional<z.ZodNumber>;
-                    weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                    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 | 500 | 600 | 700 | 300>>;
+                    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<{
+                display: z.ZodOptional<z.ZodObject<{
                     size: z.ZodOptional<z.ZodNumber>;
-                    weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                    weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
                     tracking: z.ZodOptional<z.ZodNumber>;
                     leading: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
@@ -432,6 +472,7 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
             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<{
@@ -512,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;
@@ -521,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;
@@ -535,9 +610,38 @@ 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<{
@@ -563,13 +667,13 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                         floating: "floating";
                     }>>;
                     layout: z.ZodDefault<z.ZodEnum<{
+                        left: "left";
                         spread: "spread";
                         centered: "centered";
-                        left: "left";
                     }>>;
                     menuShows: z.ZodDefault<z.ZodEnum<{
-                        both: "both";
                         icon: "icon";
+                        both: "both";
                         word: "word";
                     }>>;
                     menuStyle: z.ZodOptional<z.ZodString>;
@@ -586,39 +690,39 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                     color: z.ZodString;
                 }, z.core.$strip>>>;
                 type: z.ZodDefault<z.ZodObject<{
-                    display: z.ZodOptional<z.ZodObject<{
+                    h1: z.ZodOptional<z.ZodObject<{
                         size: z.ZodOptional<z.ZodNumber>;
-                        weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                        weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
                         tracking: z.ZodOptional<z.ZodNumber>;
                         leading: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>;
-                    h1: z.ZodOptional<z.ZodObject<{
+                    h2: z.ZodOptional<z.ZodObject<{
                         size: z.ZodOptional<z.ZodNumber>;
-                        weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                        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<{
+                    h3: z.ZodOptional<z.ZodObject<{
                         size: z.ZodOptional<z.ZodNumber>;
-                        weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                        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<{
+                    small: z.ZodOptional<z.ZodObject<{
                         size: z.ZodOptional<z.ZodNumber>;
-                        weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                        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 | 500 | 600 | 700 | 300>>;
+                        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<{
+                    display: z.ZodOptional<z.ZodObject<{
                         size: z.ZodOptional<z.ZodNumber>;
-                        weight: z.ZodOptional<z.ZodLiteral<400 | 500 | 600 | 700 | 300>>;
+                        weight: z.ZodOptional<z.ZodLiteral<400 | 600 | 500 | 300 | 700>>;
                         tracking: z.ZodOptional<z.ZodNumber>;
                         leading: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>;
@@ -664,6 +768,7 @@ export declare function defineSite<const B extends Record<string, z.ZodObject>>(
                 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<{
@@ -744,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;

package/dist/content/index.js

@@ -11,11 +11,16 @@
 import { z } from "zod";
 import { checkStructure, describePath } from "../schema.js";
 import { presets } from "../sections/presets.js";
+import { built, component, treeProblems } from "../tree/index.js";
+import { CONTENT_FORMAT } from "../content-migrate.js";
+import { consent } from "../consent.js";
+import { FIELD_KINDS, itemPath } from "./lists.js";
 import { buttonStyleName, COLOUR_ROLES, colourOf, isDark, lookProblems, lookSchema, swatchSlug } from "./look.js";
 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, } from "./look.js";
 export { fontFaceCss, fontFiles, googleFamily, googleFont, googleFonts, isFontName, servedAt } from "../fonts-google.js";
 export { blockLabel, checkStructure, describePath } from "../schema.js";
 export { z };
+export { allPages, FIELD_KINDS, fromList, itemOf, itemPages, itemPath, PAGE_LINK, THIS_ITEM, withListItems } from "./lists.js";
 // Fields carry an "x-ui" hint in the JSON Schema, so CalOS draws the right control: a text area, a
 // Markdown box, a picture picker.
 export const text = z.string().trim().min(1);
@@ -213,6 +218,76 @@ export function footerOf(site) {
  * 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]`.
  */
+/** A list's key and a field's: what Shows and Repeats for name them by (`lists.products.items`, `this.price`). */
+const listKey = z.string().regex(/^[a-z][a-zA-Z0-9]{0,39}$/, { error: "Letters and numbers, starting with a lowercase letter, like products or teamMembers" });
+const fieldKey = z
+    .string()
+    .regex(/^[a-z][a-zA-Z0-9]{0,39}$/, { error: "Letters and numbers, starting with a lowercase letter, like name or price" })
+    .refine((k) => k !== "id" && k !== "slug", { error: "id and slug are an item's own" });
+/** An item: its id, its address part, and its values (each checked against its field's kind: listProblems). */
+const listItem = z
+    .object({
+    id: z.string().regex(/^[\w-]{1,64}$/),
+    slug: z.string().max(80).regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, { error: "Lowercase letters, numbers and dashes, like walnut-desk" }),
+})
+    .catchall(z.unknown());
+/** Each kind of a list's field, as a value is checked. */
+const VALUE = {
+    text: z.string().trim().max(300),
+    longText: z.string().max(5000),
+    image,
+    link: href,
+    number: z.number().finite(),
+    date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, { error: "A date like 2026-11-09" }),
+};
+/**
+ * What a list's shape can't say alone: fields named once, each item's values of their field's kind
+ * and no others, ids and addresses used once, a page titled and described by a field of words, and no
+ * item at the address of one of the site's pages.
+ */
+function listProblems(site) {
+    const out = [];
+    const lists = (site.lists ?? {});
+    const pagePaths = new Set(site.pages.map((p) => p.path));
+    for (const [key, list] of Object.entries(lists)) {
+        const at = ["lists", key];
+        const fields = new Map();
+        list.fields.forEach((f, i) => {
+            if (fields.has(f.key))
+                out.push({ path: [...at, "fields", i, "key"], message: `Two fields are called ${f.key}` });
+            fields.set(f.key, f.kind);
+        });
+        const ids = new Set();
+        const slugs = new Set();
+        list.items.forEach((item, i) => {
+            if (ids.has(item.id))
+                out.push({ path: [...at, "items", i, "id"], message: `Two items have the id ${item.id}` });
+            ids.add(item.id);
+            if (slugs.has(item.slug))
+                out.push({ path: [...at, "items", i, "slug"], message: `Two items have the address ${item.slug}` });
+            slugs.add(item.slug);
+            for (const [k, v] of Object.entries(item)) {
+                if (k === "id" || k === "slug" || v === undefined || v === null || v === "")
+                    continue;
+                const kind = fields.get(k);
+                if (!kind)
+                    out.push({ path: [...at, "items", i, k], message: `${k} isn't one of ${list.name}'s fields` });
+                else if (!VALUE[kind].safeParse(v).success)
+                    out.push({ path: [...at, "items", i, k], message: `Not a ${kind === "longText" ? "text" : kind} value` });
+            }
+            if (list.page && pagePaths.has(itemPath(list.page, item.slug, site.trailingSlash !== false)))
+                out.push({ path: [...at, "items", i, "slug"], message: `There's a page at ${itemPath(list.page, item.slug, site.trailingSlash !== false)} already` });
+        });
+        if (list.page) {
+            const words = (k) => !k || fields.get(k) === "text" || fields.get(k) === "longText";
+            if (!fields.has(list.page.title) || fields.get(list.page.title) !== "text")
+                out.push({ path: [...at, "page", "title"], message: "The title is one of the list's fields of words" });
+            if (list.page.description && (!fields.has(list.page.description) || !words(list.page.description)))
+                out.push({ path: [...at, "page", "description"], message: "The description is one of the list's fields of words" });
+        }
+    }
+    return out;
+}
 export function defineSite(blocks, o = {}) {
     const names = Object.keys(blocks);
     if (!names.length)
@@ -229,6 +304,14 @@ export function defineSite(blocks, o = {}) {
     const page = z.object({ ...pageBase(trailingSlash), ...o.pageExtend, blocks: z.array(union).min(1) });
     const schema = z
         .object({
+        /** Which format of the kit's the content is in (../content-migrate.ts): none for the first; set by the migrations, never edited. */
+        format: z
+            .number()
+            .int()
+            .min(0)
+            .max(CONTENT_FORMAT, { error: `A newer format than this kit's (${CONTENT_FORMAT}): the site needs a newer @caltho/site-kit` })
+            .optional()
+            .meta({ title: "Content format", readOnly: true, "x-ui": "hidden" }),
         /** The address it's served at once live (its main domain). */
         url: z.url({ protocol: /^https$/, error: "The site's address, starting https://" }).meta({ title: "Web address" }),
         lang: z.string().default("en-US").meta({ title: "Language" }),
@@ -267,11 +350,48 @@ export function defineSite(blocks, o = {}) {
         })
             .optional()
             .meta({ title: "Footer" }),
+        /**
+         * A header or footer of the business's own, built as a tree like a built section (../tree), in
+         * place of the kit's: its links, logo and button are elements, a phone menu an accordion. Left
+         * out, the kit's header and footer (from the menu, footer and Look above).
+         */
+        ownHeader: built.optional().meta({ title: "Your own header", "x-ui": "hidden" }),
+        ownFooter: built.optional().meta({ title: "Your own footer", "x-ui": "hidden" }),
+        /** A cookie banner, and visits counted only once a visitor accepts: off unless turned on (../consent.ts). */
+        consent: consent.optional(),
         /** Old addresses kept answering, when CalOS doesn't supply them at build. */
         redirects: z.array(z.object({ from: z.string().startsWith("/"), to: href, status: z.union([z.literal(301), z.literal(302)]).default(301) })).default([]),
         ...(o.look ? { look: lookSchema(o.look) } : {}),
         ...o.extend,
         pages: z.array(page).min(1),
+        /**
+         * The site's lists (./lists.ts): items of one kind kept once, repeated by built sections and,
+         * where a list has a page, each at its own address from one design.
+         */
+        lists: z
+            .record(listKey, z.object({
+            name: text.meta({ title: "Name" }),
+            fields: z.array(z.object({ key: fieldKey, label: text, kind: z.enum(FIELD_KINDS) })).max(30),
+            items: z.array(listItem).max(2000).default([]),
+            page: z
+                .object({
+                path: pageBase(trailingSlash).path,
+                title: fieldKey.meta({ title: "The field each page is titled by" }),
+                description: fieldKey.optional().meta({ title: "The field each page is described by" }),
+                blocks: z.array(union).min(1),
+            })
+                .optional()
+                .meta({ title: "A page for each item" }),
+            /** Where its items come from, when CalOS fills it from one of the business's tables: kept by CalOS, never drawn. */
+            source: z
+                .object({ table: z.string().max(60), fields: z.record(z.string(), z.string().max(60)), publish: z.enum(["draft", "auto"]).default("draft") })
+                .optional()
+                .meta({ "x-ui": "hidden" }),
+        }))
+            .default({})
+            .meta({ title: "Lists", "x-ui": "hidden" }),
+        /** Trees kept once and used by name (`use` blocks), changed in one place for every use: on a site that takes built sections. */
+        ...(names.includes("built") || names.includes("use") ? { components: z.array(component).max(50).default([]).meta({ title: "Components" }) } : {}),
         /** Sections the business put together and named, to add again anywhere ("Package card"): CalOS offers them beside the site's own kinds. */
         saved: z
             .array(z.object({ name: text.meta({ title: "Name" }), block: union }))
@@ -289,6 +409,10 @@ export function defineSite(blocks, o = {}) {
         if (placed)
             for (const i of backgroundProblems(s, o.look))
                 ctx.addIssue({ code: "custom", path: i.path, message: i.message });
+        for (const i of builtProblems(s))
+            ctx.addIssue({ code: "custom", path: i.path, message: i.message });
+        for (const i of listProblems(s))
+            ctx.addIssue({ code: "custom", path: i.path, message: i.message });
         o.refine?.(s, ctx);
     });
     return {
@@ -332,6 +456,37 @@ function backgroundProblems(site, look) {
     saved.forEach((s, i) => s?.block && check(s.block, ["saved", i, "block"]));
     return out;
 }
+/**
+ * What a built section's tree can't say alone (../tree: depth, size, an id used twice), for every
+ * tree the content keeps, and that each component a `use` block names is one the site has.
+ */
+function builtProblems(site) {
+    const out = [];
+    const components = Array.isArray(site.components) ? site.components : [];
+    const keys = new Set();
+    components.forEach((c, i) => {
+        if (c?.key && keys.has(c.key))
+            out.push({ path: ["components", i, "key"], message: `Two components are called ${c.key}` });
+        if (c?.key)
+            keys.add(c.key);
+        if (c?.root)
+            for (const m of treeProblems(c.root))
+                out.push({ path: ["components", i, "root"], message: m });
+    });
+    const design = site.consent?.design;
+    if (design && !keys.has(design))
+        out.push({ path: ["consent", "design"], message: `The site has no component called ${design}` });
+    const check = (b, at) => {
+        if (b.type === "built" && b.root && typeof b.root === "object")
+            for (const m of treeProblems(b.root))
+                out.push({ path: [...at, "root"], message: m });
+        if (b.type === "use" && typeof b.component === "string" && !keys.has(b.component))
+            out.push({ path: [...at, "component"], message: `The site has no component called ${b.component}` });
+    };
+    site.pages.forEach((p, i) => p.blocks.forEach((b, j) => check(b, ["pages", i, "blocks", j])));
+    (site.saved ?? []).forEach((s, i) => s?.block && check(s.block, ["saved", i, "block"]));
+    return out;
+}
 /** Search results cut a title at about 60 characters and a description at about 160: said, not refused, since the page still works. */
 function lengthWarnings(site) {
     return site.pages.flatMap((p, i) => [