@cloudhal/core-contracts 0.3.4 → 0.3.5

package/schemas/.bundled/site.schema.json

@@ -1,1050 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cloudhal.dev/schemas/v1/site.schema.json",
-  "title": "Site",
-  "description": "Root node of a Site Graph: one deployable website with its locales, domains, theme and page index. Pages and content entries are separate nodes referenced by id so they can be versioned and locked independently.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schemaVersion",
-    "id",
-    "projectId",
-    "name",
-    "slug",
-    "defaultLocale",
-    "locales",
-    "domains",
-    "pageIds",
-    "theme",
-    "rev",
-    "createdAt",
-    "updatedAt"
-  ],
-  "properties": {
-    "schemaVersion": {
-      "$ref": "#/$defs/SchemaVersion"
-    },
-    "id": {
-      "$ref": "#/$defs/Id"
-    },
-    "projectId": {
-      "$ref": "#/$defs/Id"
-    },
-    "name": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 200
-    },
-    "slug": {
-      "$ref": "#/$defs/Slug"
-    },
-    "defaultLocale": {
-      "$ref": "#/$defs/Locale"
-    },
-    "locales": {
-      "type": "array",
-      "items": {
-        "$ref": "#/$defs/Locale"
-      },
-      "minItems": 1,
-      "uniqueItems": true
-    },
-    "domains": {
-      "type": "array",
-      "description": "Hostnames serving this site. Exactly one should be primary: the address canonical links, feeds and previews use. Sites run on their own domains or their Cloudflare account's workers.dev address, never on a Cloudhal domain (ADR-0037).",
-      "items": {
-        "$ref": "#/$defs/Domain"
-      }
-    },
-    "pageIds": {
-      "type": "array",
-      "items": {
-        "$ref": "#/$defs/Id"
-      },
-      "uniqueItems": true
-    },
-    "homePageId": {
-      "$ref": "#/$defs/Id"
-    },
-    "localization": {
-      "$ref": "#/$defs/Localization"
-    },
-    "theme": {
-      "$ref": "#/$defs/ThemeRef"
-    },
-    "design": {
-      "$ref": "#/$defs/Design"
-    },
-    "brand": {
-      "$ref": "#/$defs/Brand"
-    },
-    "chrome": {
-      "$ref": "#/$defs/Chrome"
-    },
-    "timeZone": {
-      "$ref": "#/$defs/TimeZone",
-      "description": "The site's time zone (RFC-0008): Studio's calendar, schedules entered as wall-clock times and recurring automations use it. Absent means UTC."
-    },
-    "publishedSnapshotId": {
-      "$ref": "#/$defs/Id",
-      "description": "Snapshot currently serving production. Rollback = pointing this at an older snapshot."
-    },
-    "rev": {
-      "$ref": "#/$defs/Revision"
-    },
-    "createdAt": {
-      "$ref": "#/$defs/Timestamp"
-    },
-    "updatedAt": {
-      "$ref": "#/$defs/Timestamp"
-    },
-    "metadata": {
-      "$ref": "#/$defs/Metadata"
-    }
-  },
-  "$defs": {
-    "Actor": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "kind",
-        "id"
-      ],
-      "properties": {
-        "kind": {
-          "$ref": "#/$defs/ActorKind"
-        },
-        "id": {
-          "$ref": "#/$defs/Id"
-        },
-        "name": {
-          "type": "string",
-          "maxLength": 200
-        }
-      }
-    },
-    "ActorKind": {
-      "type": "string",
-      "description": "Who performed an action. Humans and agents share one actor model so the policy engine treats them uniformly.",
-      "enum": [
-        "human",
-        "agent",
-        "system"
-      ]
-    },
-    "Announcement": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "id",
-        "text"
-      ],
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^[a-z0-9][a-z0-9-]{0,40}$",
-          "description": "Change it when the text changes, so readers who dismissed the old one see the new one."
-        },
-        "text": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 200
-        },
-        "label": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 40
-        },
-        "href": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        },
-        "tone": {
-          "type": "string",
-          "enum": [
-            "info",
-            "brand",
-            "warning"
-          ]
-        },
-        "dismissible": {
-          "type": "boolean"
-        }
-      }
-    },
-    "BodyBlock": {
-      "type": "object",
-      "description": "One top-level block of a markdown body in the store's index (RFC-0014 §3). Written by the store only: a client's values are replaced on every write. `by`, `via` and `at` say who last changed the block's content, through which channel and when; they are absent for content written before the index existed.",
-      "additionalProperties": false,
-      "required": [
-        "id",
-        "hash"
-      ],
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^blk_[0-9A-Za-z]{8,24}$",
-          "description": "Stable across writes that keep the block's content or its place among unchanged blocks."
-        },
-        "hash": {
-          "type": "string",
-          "pattern": "^[0-9a-f]{64}$",
-          "description": "SHA-256 (hex) of the block's markdown without trailing whitespace."
-        },
-        "by": {
-          "$ref": "#/$defs/Actor"
-        },
-        "via": {
-          "type": "string",
-          "enum": [
-            "studio",
-            "mcp",
-            "api",
-            "import",
-            "ai-command",
-            "proposal"
-          ],
-          "description": "The channel of that change."
-        },
-        "at": {
-          "$ref": "#/$defs/Timestamp"
-        }
-      }
-    },
-    "BodyBlocks": {
-      "type": "array",
-      "description": "A markdown body's block index, in body order (RFC-0014 §3). Absent means not indexed (yet, or an HTML body), never empty.",
-      "maxItems": 5000,
-      "items": {
-        "$ref": "#/$defs/BodyBlock"
-      }
-    },
-    "BodyProfile": {
-      "type": "integer",
-      "enum": [
-        1
-      ],
-      "description": "The markdown dialect a body follows (RFC-0014 §1): 1 = Cloudhal Markdown v1 (CommonMark + GFM + `asset:` + directives; raw HTML escaped). Set by the store on markdown bodies."
-    },
-    "Brand": {
-      "type": "object",
-      "description": "The site's logo and social links (RFC-0025 §1), shared by the header, the footer and SEO.",
-      "additionalProperties": false,
-      "properties": {
-        "logo": {
-          "$ref": "#/$defs/ImageRef"
-        },
-        "logoDark": {
-          "$ref": "#/$defs/ImageRef"
-        },
-        "logoHeight": {
-          "type": "string",
-          "enum": [
-            "s",
-            "m",
-            "l"
-          ]
-        },
-        "social": {
-          "type": "array",
-          "maxItems": 8,
-          "items": {
-            "$ref": "#/$defs/SocialLink"
-          }
-        }
-      }
-    },
-    "Chrome": {
-      "type": "object",
-      "description": "The site's header, footer and bars as data (RFC-0025): enums, menu keys and short texts; the theme renders them with landmarks, focus and contrast guaranteed.",
-      "additionalProperties": false,
-      "properties": {
-        "header": {
-          "$ref": "#/$defs/ChromeHeader"
-        },
-        "footer": {
-          "$ref": "#/$defs/ChromeFooter"
-        },
-        "announcement": {
-          "$ref": "#/$defs/Announcement"
-        },
-        "consent": {
-          "$ref": "#/$defs/Consent"
-        }
-      }
-    },
-    "ChromeFooter": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "layout": {
-          "type": "string",
-          "enum": [
-            "simple",
-            "columns",
-            "cta-band",
-            "minimal"
-          ]
-        },
-        "surface": {
-          "type": "string",
-          "enum": [
-            "plain",
-            "muted",
-            "inverse"
-          ]
-        },
-        "tagline": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 200
-        },
-        "columns": {
-          "type": "array",
-          "maxItems": 5,
-          "items": {
-            "$ref": "#/$defs/FooterColumn"
-          }
-        },
-        "ctaHeading": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 120
-        },
-        "ctaLabel": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 40
-        },
-        "ctaHref": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        },
-        "social": {
-          "type": "boolean"
-        },
-        "copyright": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 200,
-          "description": "The legal line; {year} and {site} are the only placeholders."
-        },
-        "legal": {
-          "$ref": "#/$defs/Slug",
-          "description": "A menu key (RFC-0003)."
-        },
-        "extras": {
-          "type": "array",
-          "maxItems": 3,
-          "uniqueItems": true,
-          "items": {
-            "type": "string",
-            "enum": [
-              "locale",
-              "theme-toggle",
-              "motion-toggle"
-            ]
-          }
-        },
-        "credit": {
-          "type": "boolean"
-        },
-        "region": {
-          "$ref": "#/$defs/Section",
-          "description": "RFC-0025 §2: one optional surface (kind `surface`) above the footer's columns, built and checked like any surface; the store refuses other section kinds."
-        }
-      }
-    },
-    "ChromeHeader": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "layout": {
-          "type": "string",
-          "enum": [
-            "logo-left",
-            "logo-left-nav-center",
-            "centered",
-            "split",
-            "minimal"
-          ]
-        },
-        "behavior": {
-          "type": "string",
-          "enum": [
-            "static",
-            "sticky",
-            "hide-on-scroll",
-            "fixed"
-          ]
-        },
-        "shrink": {
-          "type": "boolean"
-        },
-        "overHero": {
-          "type": "string",
-          "enum": [
-            "solid",
-            "transparent"
-          ]
-        },
-        "width": {
-          "type": "string",
-          "enum": [
-            "content",
-            "wide",
-            "full"
-          ]
-        },
-        "surface": {
-          "type": "string",
-          "enum": [
-            "plain",
-            "muted",
-            "raised",
-            "inverse",
-            "brand"
-          ]
-        },
-        "mobileStyle": {
-          "type": "string",
-          "enum": [
-            "dropdown",
-            "drawer-start",
-            "drawer-end",
-            "fullscreen"
-          ]
-        },
-        "collapseAt": {
-          "type": "string",
-          "enum": [
-            "sm",
-            "md",
-            "lg",
-            "always"
-          ]
-        },
-        "nav": {
-          "$ref": "#/$defs/Slug",
-          "description": "A menu key (RFC-0003)."
-        },
-        "utility": {
-          "$ref": "#/$defs/Slug",
-          "description": "A menu key (RFC-0003)."
-        },
-        "actions": {
-          "type": "array",
-          "maxItems": 3,
-          "items": {
-            "$ref": "#/$defs/HeaderAction"
-          }
-        }
-      }
-    },
-    "Consent": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "mode"
-      ],
-      "properties": {
-        "mode": {
-          "type": "string",
-          "enum": [
-            "none",
-            "notice",
-            "choices"
-          ]
-        },
-        "policy": {
-          "$ref": "#/$defs/Path"
-        }
-      }
-    },
-    "Design": {
-      "type": "object",
-      "description": "The site's design rules for people and agents (RFC-0021): Markdown that agents read with the theme's DESIGN.md before they build. Guidance only: it changes neither rendering nor permissions.",
-      "additionalProperties": false,
-      "required": [
-        "markdown"
-      ],
-      "properties": {
-        "markdown": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 24000
-        }
-      }
-    },
-    "Domain": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "hostname",
-        "primary"
-      ],
-      "properties": {
-        "hostname": {
-          "type": "string",
-          "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,63}$",
-          "maxLength": 253
-        },
-        "primary": {
-          "type": "boolean"
-        }
-      }
-    },
-    "FooterColumn": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "heading",
-        "menu"
-      ],
-      "properties": {
-        "heading": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 60
-        },
-        "menu": {
-          "$ref": "#/$defs/Slug",
-          "description": "A menu key (RFC-0003)."
-        }
-      }
-    },
-    "HeaderAction": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "kind"
-      ],
-      "properties": {
-        "kind": {
-          "type": "string",
-          "enum": [
-            "button",
-            "search",
-            "locale",
-            "theme-toggle",
-            "motion-toggle"
-          ]
-        },
-        "label": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 40
-        },
-        "href": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        },
-        "variant": {
-          "type": "string",
-          "enum": [
-            "primary",
-            "secondary"
-          ]
-        }
-      }
-    },
-    "Id": {
-      "type": "string",
-      "description": "Prefixed, URL-safe identifier, e.g. site_01HZX8K3Q9. The prefix names the entity kind; agents and the MCP server pass these as opaque handles.",
-      "pattern": "^[a-z]+_[A-Za-z0-9]{6,32}$",
-      "minLength": 8,
-      "maxLength": 48
-    },
-    "ImageRef": {
-      "type": "object",
-      "description": "Reference to an image. With `assetId` the image is an Asset node (RFC-0004): the store writes its media URL into `src`, and its size into `width` and `height`, as a fallback for readers that do not resolve assets. Without it, `src` is a relative path or an absolute URL, as before.",
-      "additionalProperties": false,
-      "required": [
-        "src",
-        "alt"
-      ],
-      "properties": {
-        "assetId": {
-          "$ref": "#/$defs/Id",
-          "description": "The Asset node shown (RFC-0004). Renderers that know assets resolve it and ignore `src`."
-        },
-        "src": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        },
-        "alt": {
-          "type": "string",
-          "maxLength": 500
-        },
-        "width": {
-          "type": "integer",
-          "minimum": 1
-        },
-        "height": {
-          "type": "integer",
-          "minimum": 1
-        }
-      }
-    },
-    "Link": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "label",
-        "href"
-      ],
-      "properties": {
-        "label": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 200
-        },
-        "href": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        },
-        "external": {
-          "type": "boolean"
-        }
-      }
-    },
-    "Locale": {
-      "type": "string",
-      "description": "BCP 47 language tag, e.g. en, tr, en-US.",
-      "pattern": "^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"
-    },
-    "Localization": {
-      "type": "object",
-      "description": "How the site serves its locales (RFC-0033 §2). Absent fields mean: prefix-except-default routing, no fallback, no required review, the machine-translation notice until reviewed.",
-      "additionalProperties": false,
-      "properties": {
-        "routing": {
-          "type": "string",
-          "description": "prefix-except-default: the default locale at the root, the others under /<locale>/. prefix-all: every locale prefixed, / is a language chooser (x-default).",
-          "enum": [
-            "prefix-except-default",
-            "prefix-all"
-          ]
-        },
-        "domains": {
-          "type": "object",
-          "description": "Optional hostname per locale; that locale is then served at the host's root.",
-          "propertyNames": {
-            "$ref": "#/$defs/Locale"
-          },
-          "additionalProperties": {
-            "type": "string",
-            "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,63}$",
-            "maxLength": 253
-          }
-        },
-        "fallback": {
-          "type": "string",
-          "description": "none: a missing translation is not found. default-with-notice: the default locale's page is served with a notice and noindex.",
-          "enum": [
-            "none",
-            "default-with-notice"
-          ]
-        },
-        "review": {
-          "type": "object",
-          "description": "Collections whose machine translations need a person's review before they publish ('pages' stands for pages).",
-          "additionalProperties": false,
-          "properties": {
-            "required": {
-              "type": "array",
-              "items": {
-                "type": "string",
-                "minLength": 1,
-                "maxLength": 100
-              },
-              "uniqueItems": true
-            }
-          }
-        },
-        "label": {
-          "type": "string",
-          "description": "When readers see the machine-translation notice: unreviewed (until a person reviews) or always.",
-          "enum": [
-            "unreviewed",
-            "always"
-          ]
-        }
-      }
-    },
-    "Metadata": {
-      "type": "object",
-      "description": "Free-form string-to-string map for extensions. Keys should be namespaced (e.g. cloudhal.source).",
-      "additionalProperties": {
-        "type": "string"
-      }
-    },
-    "Path": {
-      "type": "string",
-      "description": "Absolute URL path of a route the site owns: starts with '/', lower-case slug segments, no trailing slash except root.",
-      "pattern": "^/(?:[a-z0-9]+(?:-[a-z0-9]+)*(?:/[a-z0-9]+(?:-[a-z0-9]+)*)*)?$",
-      "maxLength": 1024
-    },
-    "Revision": {
-      "type": "integer",
-      "description": "Monotonic per-node revision used for optimistic locking (compare-and-swap on write).",
-      "minimum": 0
-    },
-    "SchemaVersion": {
-      "type": "integer",
-      "description": "Version of this contract. Readers reject unknown versions; migrations move documents forward one version at a time.",
-      "enum": [
-        1
-      ]
-    },
-    "Section": {
-      "title": "Section",
-      "description": "A block inside a page, discriminated by `kind`. Variants are written inline (not via $ref) and `kind` is a single-value string enum so that TypeScript gets a literal union and Rust gets a serde internally-tagged enum.",
-      "oneOf": [
-        {
-          "type": "object",
-          "title": "HeroSection",
-          "additionalProperties": false,
-          "required": [
-            "id",
-            "kind",
-            "heading"
-          ],
-          "properties": {
-            "id": {
-              "$ref": "#/$defs/Id"
-            },
-            "kind": {
-              "type": "string",
-              "enum": [
-                "hero"
-              ]
-            },
-            "heading": {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 300
-            },
-            "subheading": {
-              "type": "string",
-              "maxLength": 1000
-            },
-            "image": {
-              "$ref": "#/$defs/ImageRef"
-            },
-            "cta": {
-              "$ref": "#/$defs/Link"
-            }
-          }
-        },
-        {
-          "type": "object",
-          "title": "RichTextSection",
-          "additionalProperties": false,
-          "required": [
-            "id",
-            "kind",
-            "format",
-            "body"
-          ],
-          "properties": {
-            "id": {
-              "$ref": "#/$defs/Id"
-            },
-            "kind": {
-              "type": "string",
-              "enum": [
-                "richText"
-              ]
-            },
-            "format": {
-              "type": "string",
-              "enum": [
-                "markdown",
-                "html"
-              ]
-            },
-            "body": {
-              "type": "string",
-              "maxLength": 200000
-            },
-            "profile": {
-              "$ref": "#/$defs/BodyProfile"
-            },
-            "blocks": {
-              "$ref": "#/$defs/BodyBlocks"
-            }
-          }
-        },
-        {
-          "type": "object",
-          "title": "ImageSection",
-          "additionalProperties": false,
-          "required": [
-            "id",
-            "kind",
-            "image"
-          ],
-          "properties": {
-            "id": {
-              "$ref": "#/$defs/Id"
-            },
-            "kind": {
-              "type": "string",
-              "enum": [
-                "image"
-              ]
-            },
-            "image": {
-              "$ref": "#/$defs/ImageRef"
-            },
-            "caption": {
-              "type": "string",
-              "maxLength": 1000
-            }
-          }
-        },
-        {
-          "type": "object",
-          "title": "ContentListSection",
-          "description": "Renders the newest entries of a content collection (e.g. blog posts).",
-          "additionalProperties": false,
-          "required": [
-            "id",
-            "kind",
-            "collection",
-            "limit",
-            "sort"
-          ],
-          "properties": {
-            "id": {
-              "$ref": "#/$defs/Id"
-            },
-            "kind": {
-              "type": "string",
-              "enum": [
-                "contentList"
-              ]
-            },
-            "collection": {
-              "$ref": "#/$defs/Slug"
-            },
-            "limit": {
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 100
-            },
-            "sort": {
-              "type": "string",
-              "enum": [
-                "newest",
-                "oldest",
-                "title"
-              ]
-            },
-            "filter": {
-              "type": "string",
-              "description": "Filter expression over term assignments (RFC-0002), e.g. 'category:news+tag:ai' or 'category:news>*'.",
-              "minLength": 1,
-              "maxLength": 512
-            }
-          }
-        },
-        {
-          "type": "object",
-          "title": "ComponentSection",
-          "description": "A typed block from the block registry (RFC-0015): `type` names a registered block type (one global namespace of English names), `props` follow that type's props schema, which the store validates.",
-          "additionalProperties": false,
-          "required": [
-            "id",
-            "kind",
-            "type",
-            "props"
-          ],
-          "properties": {
-            "id": {
-              "$ref": "#/$defs/Id"
-            },
-            "kind": {
-              "type": "string",
-              "enum": [
-                "component"
-              ]
-            },
-            "type": {
-              "type": "string",
-              "pattern": "^[a-z][a-z0-9-]{1,40}$"
-            },
-            "props": {
-              "type": "object",
-              "description": "Validated against the type's props schema by the store, not by this contract.",
-              "additionalProperties": true
-            }
-          }
-        },
-        {
-          "type": "object",
-          "title": "SurfaceSection",
-          "description": "A generative UI surface (RFC-0020): a flat list of catalog components with a `root`, plus a data model their props may bind to. Written and streamed by agents as data, never code; the store checks the tree, the catalog and the limits.",
-          "additionalProperties": false,
-          "required": [
-            "id",
-            "kind",
-            "catalog",
-            "components"
-          ],
-          "properties": {
-            "id": {
-              "$ref": "#/$defs/Id"
-            },
-            "kind": {
-              "type": "string",
-              "enum": [
-                "surface"
-              ]
-            },
-            "catalog": {
-              "type": "string",
-              "description": "The catalog the surface was written for: `<theme>@<major>` (RFC-0018 manifest).",
-              "pattern": "^[a-z][a-z0-9-]{0,40}@[0-9]{1,4}$"
-            },
-            "components": {
-              "type": "array",
-              "minItems": 1,
-              "maxItems": 200,
-              "items": {
-                "$ref": "#/$defs/SurfaceComponent"
-              }
-            },
-            "data": {
-              "type": "object",
-              "description": "The surface's data model: JSON its components bind to with `{path}` (at most 64 KB serialized; the store enforces the size).",
-              "additionalProperties": true
-            }
-          }
-        }
-      ]
-    },
-    "Slug": {
-      "type": "string",
-      "description": "Lower-case URL segment.",
-      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-      "minLength": 1,
-      "maxLength": 128
-    },
-    "SocialLink": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "network",
-        "href"
-      ],
-      "properties": {
-        "network": {
-          "type": "string",
-          "enum": [
-            "x",
-            "bluesky",
-            "mastodon",
-            "github",
-            "linkedin",
-            "instagram",
-            "facebook",
-            "youtube",
-            "tiktok",
-            "threads",
-            "rss",
-            "email"
-          ]
-        },
-        "href": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        }
-      }
-    },
-    "SurfaceComponent": {
-      "type": "object",
-      "description": "One element of a generative UI surface (RFC-0020 §1), in a flat list: `component` names a catalog entry (a PascalCase built-in primitive such as `Stack`, or a registry block type such as `callout`), `children` refer to other ids of the same surface, and `props` follow the entry's schema, which the store checks. Field names follow A2UI v0.9.",
-      "additionalProperties": false,
-      "required": [
-        "id",
-        "component"
-      ],
-      "properties": {
-        "id": {
-          "$ref": "#/$defs/SurfaceComponentId"
-        },
-        "component": {
-          "type": "string",
-          "pattern": "^(?:[A-Z][A-Za-z0-9]{1,40}|[a-z][a-z0-9-]{1,40})$"
-        },
-        "children": {
-          "type": "array",
-          "maxItems": 200,
-          "items": {
-            "$ref": "#/$defs/SurfaceComponentId"
-          }
-        },
-        "props": {
-          "type": "object",
-          "description": "Literal values, `{path}` bindings into the surface's data, or `{call}` named functions; validated by the store against the catalog, not by this contract.",
-          "additionalProperties": true
-        },
-        "visible": {
-          "type": "object",
-          "description": "A visibility condition over the surface's data (`eq`, `ne`, `gt`, `lt`, `and`, `or`, `not`); validated by the store.",
-          "additionalProperties": true
-        },
-        "motion": {
-          "type": "object",
-          "description": "Motion presets for this component (RFC-0024 §2): `reveal`, `hover`, `speed`, `delay`, `stagger`, `replay` and later `scroll`, `loop`; enums and clamped numbers only, validated by the store against the catalog. The renderer turns them into CSS; agents never write CSS.",
-          "additionalProperties": true
-        }
-      }
-    },
-    "SurfaceComponentId": {
-      "type": "string",
-      "description": "A component's id, unique within its surface; `root` is the tree's root (RFC-0020 §1).",
-      "pattern": "^[a-z][a-z0-9-]{0,40}$"
-    },
-    "ThemeRef": {
-      "type": "object",
-      "description": "Theme (a.k.a. Experience) applied by the renderer. Config is theme-defined and validated by the theme's own schema, not here.",
-      "additionalProperties": false,
-      "required": [
-        "name"
-      ],
-      "properties": {
-        "name": {
-          "$ref": "#/$defs/Slug"
-        },
-        "version": {
-          "type": "string",
-          "maxLength": 64
-        },
-        "config": {
-          "type": "object",
-          "additionalProperties": true
-        }
-      }
-    },
-    "Timestamp": {
-      "type": "string",
-      "description": "RFC 3339 / ISO 8601 instant in UTC.",
-      "format": "date-time"
-    },
-    "TimeZone": {
-      "type": "string",
-      "description": "IANA time zone name from the tz database (RFC-0008), e.g. Europe/Istanbul, America/Argentina/Buenos_Aires, Etc/GMT+3 or UTC. Wall-clock times a person enters are kept with their zone, so the instant is recomputed when governments change the rules. The pattern bounds the shape only; writers also check the name against the runtime's Intl zone list.",
-      "pattern": "^(?:UTC|[A-Z][A-Za-z_-]+(?:/[A-Za-z0-9_+-]+){1,2})$",
-      "maxLength": 64
-    }
-  }
-}