@taprootio/site-authoring 0.12.6 → 0.13.0

package/src/content/media-presentation.js

@@ -0,0 +1,123 @@
+// Generated from shared/media-presentation.ts by scripts/sync-field-validation.mjs. Do not edit.
+/**
+ * The one owner of how an image, a video and a video embed are sized and
+ * bordered: the site-default option lists and normalizers, the per-block
+ * override grammar, and the CSS values built from them.
+ *
+ * Images, the Video block and the Video embed block read the same two site
+ * settings (max height, border width) and take the same two optional per-block
+ * overrides, so they share these functions and the custom properties they set.
+ *
+ * It is pure and dependency-free. The generator, the editor and the
+ * site-authoring CLI cannot all import this file, so
+ * `node scripts/sync-field-validation.mjs` writes their copies; edit only this
+ * file and re-run it. The API mirrors the site-setting ranges in
+ * `SiteSettings.cs`.
+ */
+/** The "no explicit choice" sentinel stored in place of an override. */
+export const TIPTAP_SITE_DEFAULT = "site-default";
+export const DEFAULT_TIPTAP_IMAGE_MAX_HEIGHT_VH = 60;
+export const TIPTAP_IMAGE_MAX_HEIGHT_OPTIONS = [45, 60, 75, 90];
+// Mirrors TiptapImageBorder in the API's SiteSettings.cs. 2px matches
+// esp-image's built-in border so untouched sites keep their current look.
+export const TIPTAP_IMAGE_BORDER_WIDTH_MIN = 0;
+export const TIPTAP_IMAGE_BORDER_WIDTH_MAX = 20;
+export const DEFAULT_TIPTAP_IMAGE_BORDER_WIDTH_PX = 2;
+/** The custom property every sized media block reads its max height from. */
+export const MEDIA_MAX_HEIGHT_PROPERTY = "--taproot-article-image-max-height";
+/** The custom property every bordered media block reads its border from. */
+export const MEDIA_BORDER_PROPERTY = "--esp-image-border";
+/** A number, or text read as one (a cleared field reads as 0); anything else is not a number. */
+function optionNumber(value) {
+    if (typeof value === "number")
+        return value;
+    return typeof value === "string" ? Number(value) : Number.NaN;
+}
+function isMaxHeightOption(value) {
+    return TIPTAP_IMAGE_MAX_HEIGHT_OPTIONS.includes(optionNumber(value));
+}
+/** The site max height (in vh) for any stored value; anything outside the options is the default. */
+export function normalizeImageMaxHeight(value) {
+    return isMaxHeightOption(value)
+        ? optionNumber(value)
+        : DEFAULT_TIPTAP_IMAGE_MAX_HEIGHT_VH;
+}
+/** An explicit per-image max height choice, or null for the site default, the sentinel or an invalid value. */
+export function explicitImageMaxHeight(value) {
+    if (value === TIPTAP_SITE_DEFAULT || value === undefined || value === null)
+        return null;
+    return isMaxHeightOption(value) ? optionNumber(value) : null;
+}
+/** The site border width in pixels for any stored value; anything outside the range is the default. */
+export function normalizeImageBorderWidthPx(value) {
+    const parsed = optionNumber(value);
+    if (!Number.isFinite(parsed))
+        return DEFAULT_TIPTAP_IMAGE_BORDER_WIDTH_PX;
+    const width = Math.trunc(parsed);
+    return width >= TIPTAP_IMAGE_BORDER_WIDTH_MIN && width <= TIPTAP_IMAGE_BORDER_WIDTH_MAX
+        ? width
+        : DEFAULT_TIPTAP_IMAGE_BORDER_WIDTH_PX;
+}
+const CSS_LENGTH_UNITS = "px|em|rem|ch|ex|vw|vh|svh|lvh|dvh|svw|lvw|dvw|vmin|vmax|%";
+const CSS_LENGTH_RE = new RegExp(`^\\d+(?:\\.\\d+)?(?:${CSS_LENGTH_UNITS})$`, "i");
+const CSS_VAR_RE = /^var\(--[a-z0-9-]+\)$/i;
+const CSS_CALC_TERM = `(?:\\d+(?:\\.\\d+)?(?:${CSS_LENGTH_UNITS})|\\d+(?:\\.\\d+)?|var\\(--[a-z0-9-]+\\))`;
+const CSS_CALC_RE = new RegExp(`^calc\\(\\s*${CSS_CALC_TERM}(?:\\s*[+\\-*/]\\s*${CSS_CALC_TERM})*\\s*\\)$`, "i");
+/**
+ * Validate a user-supplied CSS length for per-block presentation overrides
+ * (max height, border width). These values are emitted into inline styles on
+ * published pages, so anything outside this strict grammar is rejected:
+ * unitless `0`, a non-negative length, `var(--token)`, `calc(...)` of those
+ * terms, and — when `allowNone` is set — the `none` keyword (max-height).
+ * Returns the trimmed value, or null when invalid or set to the site default.
+ */
+export function normalizeCssLengthOverride(value, options) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed === TIPTAP_SITE_DEFAULT)
+        return null;
+    if (trimmed === "0")
+        return trimmed;
+    if (options?.allowNone && trimmed.toLowerCase() === "none")
+        return "none";
+    if (CSS_LENGTH_RE.test(trimmed))
+        return trimmed;
+    if (CSS_VAR_RE.test(trimmed))
+        return trimmed;
+    if (CSS_CALC_RE.test(trimmed))
+        return trimmed;
+    return null;
+}
+/** The validated max height override of a block (a CSS length or "none"), or null for the site default. */
+export function normalizeMaxHeightOverride(value) {
+    return normalizeCssLengthOverride(value, { allowNone: true });
+}
+/** The validated border width override of a block (a CSS length), or null for the site default. */
+export function normalizeBorderWidthOverride(value) {
+    return normalizeCssLengthOverride(value);
+}
+/** CSS value for the border hook given a width; zero collapses to none. */
+export function imageBorderValue(width) {
+    return /^0(?:\.0+)?(?:[a-z%]+)?$/i.test(width) ? "none" : `${width} solid var(--esp-color-border)`;
+}
+/** The site-default border as CSS, from the stored pixel width. */
+export function siteDefaultBorderValue(widthPx) {
+    return imageBorderValue(`${normalizeImageBorderWidthPx(widthPx)}px`);
+}
+/**
+ * The inline custom-property declarations that carry a block's overrides.
+ * Only an explicit, valid override is emitted, so an absent one keeps
+ * following the site default.
+ */
+export function mediaOverrideStyleParts(overrides) {
+    const parts = [];
+    const maxHeight = normalizeMaxHeightOverride(overrides.maxHeight);
+    const borderWidth = normalizeBorderWidthOverride(overrides.borderWidth);
+    // A unitless zero would make the video frame's width calc invalid; 0px means the same to an image.
+    if (maxHeight)
+        parts.push(`${MEDIA_MAX_HEIGHT_PROPERTY}: ${maxHeight === "0" ? "0px" : maxHeight}`);
+    if (borderWidth)
+        parts.push(`${MEDIA_BORDER_PROPERTY}: ${imageBorderValue(borderWidth)}`);
+    return parts;
+}

package/src/content/tiptap-prosemirror.ts

@@ -8,8 +8,16 @@
  */
 
 import freeFormSectionRegistry from "./free-form-section-registry.json" with { type: "json" };
+import {
+  explicitImageMaxHeight,
+  mediaOverrideStyleParts,
+  normalizeBorderWidthOverride,
+  normalizeCssLengthOverride,
+  normalizeMaxHeightOverride,
+  TIPTAP_SITE_DEFAULT,
+  type TiptapImageMaxHeightVh,
+} from "./media-presentation.js";
 
-export const TIPTAP_SITE_DEFAULT = "site-default";
 export const DEFAULT_TIPTAP_IMAGE_MAX_IMAGES_PER_ROW = 2;
 export const TIPTAP_IMAGE_MAX_IMAGES_PER_ROW_OPTIONS = [1, 2, 3] as const;
 export const TIPTAP_IMAGE_NARROW_CONTENT_REM = 40;
@@ -21,15 +29,11 @@ export function normalizeTiptapImageMaxImagesPerRow(value: unknown): number {
     : DEFAULT_TIPTAP_IMAGE_MAX_IMAGES_PER_ROW;
 }
 
-export const DEFAULT_TIPTAP_IMAGE_MAX_HEIGHT_VH = 60;
-export const TIPTAP_IMAGE_MAX_HEIGHT_OPTIONS = [45, 60, 75, 90] as const;
 const SECTION_CONTEXT_PATTERN = new RegExp(
   freeFormSectionRegistry.section.attrs.context.pattern,
   "u",
 );
 
-export type TiptapSiteDefault = typeof TIPTAP_SITE_DEFAULT;
-export type TiptapImageMaxHeightVh = typeof TIPTAP_IMAGE_MAX_HEIGHT_OPTIONS[number];
 export type TiptapImagePresentationPlacement =
   | "left"
   | "left-text-right"
@@ -1202,13 +1206,11 @@ function resolveImagePresentation(
   defaults: RenderProseMirrorOptions["imageDefaults"],
 ): Record<string, string | number | undefined> {
   const explicitMaxHeight = explicitImageMaxHeight(attrs.maxHeightVh);
-  const maxHeightOverride = normalizeCssLengthOverride(attrs.maxHeight, { allowNone: true });
-  const borderWidthOverride = normalizeCssLengthOverride(attrs.borderWidth);
+  const maxHeightOverride = normalizeMaxHeightOverride(attrs.maxHeight);
+  const borderWidthOverride = normalizeBorderWidthOverride(attrs.borderWidth);
   const placement = resolvePlacement(attrs, defaults?.placement);
   const placementAttrs = imagePresentationAttributesForPlacement(placement);
-  const styleParts: string[] = [];
-  if (maxHeightOverride) styleParts.push(`--taproot-article-image-max-height: ${maxHeightOverride}`);
-  if (borderWidthOverride) styleParts.push(`--esp-image-border: ${imageBorderValue(borderWidthOverride)}`);
+  const styleParts = mediaOverrideStyleParts({ maxHeight: maxHeightOverride, borderWidth: borderWidthOverride });
   return {
     "data-tiptap-image": normalizeTiptapImageMaxImagesPerRow(defaults?.maxImagesPerRow),
     // The page shell owns the inherited site default so HTML and structured
@@ -1226,11 +1228,6 @@ function resolveImagePresentation(
   };
 }
 
-function explicitImageMaxHeight(value: unknown): TiptapImageMaxHeightVh | null {
-  if (value === TIPTAP_SITE_DEFAULT || value === undefined || value === null) return null;
-  return isImageMaxHeightOption(value) ? imageMaxHeightOption(value) : null;
-}
-
 function resolvePlacement(
   attrs: Record<string, JsonValue | undefined>,
   defaultValue: unknown,
@@ -1257,55 +1254,6 @@ function isAbsentPresentationValue(value: unknown): boolean {
   return value === undefined || value === null;
 }
 
-export function normalizeImageMaxHeight(value: unknown): TiptapImageMaxHeightVh {
-  return isImageMaxHeightOption(value) ? imageMaxHeightOption(value) : DEFAULT_TIPTAP_IMAGE_MAX_HEIGHT_VH;
-}
-
-function isImageMaxHeightOption(value: unknown): boolean {
-  return TIPTAP_IMAGE_MAX_HEIGHT_OPTIONS.includes(imageMaxHeightOption(value));
-}
-
-function imageMaxHeightOption(value: unknown): TiptapImageMaxHeightVh {
-  return (typeof value === "number" ? value : Number(value)) as TiptapImageMaxHeightVh;
-}
-
-const CSS_LENGTH_UNITS = "px|em|rem|ch|ex|vw|vh|svh|lvh|dvh|svw|lvw|dvw|vmin|vmax|%";
-const CSS_LENGTH_RE = new RegExp(`^\\d+(?:\\.\\d+)?(?:${CSS_LENGTH_UNITS})$`, "i");
-const CSS_VAR_RE = /^var\(--[a-z0-9-]+\)$/i;
-const CSS_CALC_TERM = `(?:\\d+(?:\\.\\d+)?(?:${CSS_LENGTH_UNITS})|\\d+(?:\\.\\d+)?|var\\(--[a-z0-9-]+\\))`;
-const CSS_CALC_RE = new RegExp(
-  `^calc\\(\\s*${CSS_CALC_TERM}(?:\\s*[+\\-*/]\\s*${CSS_CALC_TERM})*\\s*\\)$`,
-  "i",
-);
-
-/**
- * Validate a user-supplied CSS length for per-image presentation overrides
- * (max height, border width). These values are emitted into inline styles on
- * published pages, so anything outside this strict grammar is rejected:
- * unitless `0`, a non-negative length, `var(--token)`, `calc(...)` of those
- * terms, and — when `allowNone` is set — the `none` keyword (max-height).
- * Returns the trimmed value, or null when invalid or set to the site default.
- */
-export function normalizeCssLengthOverride(
-  value: unknown,
-  options?: { allowNone?: boolean },
-): string | null {
-  if (typeof value !== "string") return null;
-  const trimmed = value.trim();
-  if (!trimmed || trimmed === TIPTAP_SITE_DEFAULT) return null;
-  if (trimmed === "0") return trimmed;
-  if (options?.allowNone && trimmed.toLowerCase() === "none") return "none";
-  if (CSS_LENGTH_RE.test(trimmed)) return trimmed;
-  if (CSS_VAR_RE.test(trimmed)) return trimmed;
-  if (CSS_CALC_RE.test(trimmed)) return trimmed;
-  return null;
-}
-
-/** CSS value for the esp-image border hook given a width; zero collapses to none. */
-export function imageBorderValue(width: string): string {
-  return /^0(?:\.0+)?(?:[a-z%]+)?$/i.test(width) ? "none" : `${width} solid var(--esp-color-border)`;
-}
-
 export function normalizeImagePresentationPlacement(value: unknown): TiptapImagePresentationPlacement {
   switch (value) {
     case "left":

package/src/content/video-embed-url.js

@@ -0,0 +1,104 @@
+// Generated from shared/video-embed-url.ts by scripts/sync-field-validation.mjs. Do not edit.
+/**
+ * The one owner of which video links the embed card accepts.
+ *
+ * A link is reduced to a provider and an id when it is authored, and only that
+ * pair is stored. Every player URL is built here from the validated pair, never
+ * from the text an author pasted. Anything that is not a YouTube watch, share,
+ * Shorts or embed link, or a Vimeo video link, is refused.
+ *
+ * It is pure and dependency-free. The generator, the editor and the
+ * site-authoring CLI cannot all import this file, so
+ * `node scripts/sync-field-validation.mjs` writes their copies; edit only this
+ * file and re-run it. `shared/video-embed-url-corpus.json` is the evidence
+ * every copy agrees.
+ */
+export const VIDEO_EMBED_PROVIDERS = ["youtube", "vimeo"];
+/** The one line shown for any link that is not accepted. */
+export const VIDEO_EMBED_REFUSAL = "Use a YouTube or Vimeo video link, such as youtube.com/watch?v=… or vimeo.com/123456789.";
+/** The origin each provider's player loads from; a page with an embed may frame exactly these. */
+export const VIDEO_EMBED_FRAME_ORIGINS = {
+    youtube: "https://www.youtube-nocookie.com",
+    vimeo: "https://player.vimeo.com",
+};
+const YOUTUBE_ID = /^[A-Za-z0-9_-]{11}$/u;
+/** Two 11-character path segments of `/embed/` links that are playlists and live streams, not video ids. */
+const YOUTUBE_NON_VIDEO_IDS = new Set(["videoseries", "live_stream"]);
+const VIMEO_ID = /^[1-9][0-9]{0,11}$/u;
+const YOUTUBE_HOSTS = new Set([
+    "youtube.com",
+    "www.youtube.com",
+    "m.youtube.com",
+    "youtube-nocookie.com",
+    "www.youtube-nocookie.com",
+]);
+const VIMEO_HOSTS = new Set(["vimeo.com", "www.vimeo.com"]);
+export function isVideoEmbedProvider(value) {
+    return value === "youtube" || value === "vimeo";
+}
+export function isVideoEmbedId(provider, videoId) {
+    if (typeof videoId !== "string")
+        return false;
+    if (provider === "youtube")
+        return YOUTUBE_ID.test(videoId) && !YOUTUBE_NON_VIDEO_IDS.has(videoId);
+    if (provider === "vimeo")
+        return VIMEO_ID.test(videoId);
+    return false;
+}
+/** The player URL for a validated provider and id, or an empty string when either is not valid. */
+export function videoEmbedPlayerUrl(provider, videoId) {
+    if (!isVideoEmbedProvider(provider) || !isVideoEmbedId(provider, videoId))
+        return "";
+    return provider === "youtube"
+        ? `${VIDEO_EMBED_FRAME_ORIGINS.youtube}/embed/${videoId}?autoplay=1`
+        : `${VIDEO_EMBED_FRAME_ORIGINS.vimeo}/video/${videoId}?dnt=1&autoplay=1`;
+}
+/** Reduces an accepted video link to its provider and id; every other value gives `null`. */
+export function parseVideoEmbedUrl(input) {
+    if (typeof input !== "string")
+        return null;
+    const text = input.trim();
+    if (text === "" || text.length > 2048)
+        return null;
+    let url;
+    try {
+        url = new URL(text);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "https:" && url.protocol !== "http:")
+        return null;
+    if (url.username !== "" || url.password !== "" || url.port !== "")
+        return null;
+    const host = url.hostname.toLowerCase();
+    const pathname = url.pathname.length > 1 && url.pathname.endsWith("/") ? url.pathname.slice(0, -1) : url.pathname;
+    if (pathname.includes("//"))
+        return null;
+    const segments = pathname.slice(1).split("/");
+    if (host === "youtu.be") {
+        return segments.length === 1 ? target("youtube", segments[0]) : null;
+    }
+    if (YOUTUBE_HOSTS.has(host)) {
+        if (segments.length === 1 && segments[0] === "watch")
+            return target("youtube", url.searchParams.get("v"));
+        if (segments.length === 2 && (segments[0] === "shorts" || segments[0] === "embed")) {
+            return target("youtube", segments[1]);
+        }
+        return null;
+    }
+    // An unlisted Vimeo video needs its `h` privacy hash to play; only the id is
+    // stored, so a link that carries one is refused rather than saved broken.
+    if (VIMEO_HOSTS.has(host)) {
+        return segments.length === 1 && !url.searchParams.has("h") ? target("vimeo", segments[0]) : null;
+    }
+    if (host === "player.vimeo.com") {
+        return segments.length === 2 && segments[0] === "video" && !url.searchParams.has("h")
+            ? target("vimeo", segments[1])
+            : null;
+    }
+    return null;
+}
+function target(provider, videoId) {
+    return videoId !== null && videoId !== undefined && isVideoEmbedId(provider, videoId) ? { provider, videoId } : null;
+}

package/src/content/vocabulary.js

@@ -1,6 +1,11 @@
 import { isContactOrWebUrl } from "../contact-url.js";
 import { sanitizeDiagnostic } from "../errors.js";
 import freeFormSectionRegistry from "./free-form-section-registry.json" with { type: "json" };
+import {
+  normalizeCssLengthOverride,
+  TIPTAP_IMAGE_MAX_HEIGHT_OPTIONS,
+  TIPTAP_SITE_DEFAULT,
+} from "./media-presentation.js";
 
 /**
  * The primitives the content module shares: the accepted ProseMirror
@@ -186,11 +191,12 @@ export const CONTENT_LIMITS = Object.freeze({
 // Renderer-mirrored constants and predicates
 // ---------------------------------------------------------------------------
 
-/** `TIPTAP_SITE_DEFAULT` — the "no explicit choice" sentinel. */
-export const TIPTAP_SITE_DEFAULT = "site-default";
+// The sentinel, the max height options and the CSS length grammar are the
+// renderer's own, from the shared media presentation module.
+export { normalizeCssLengthOverride, TIPTAP_SITE_DEFAULT };
 
 /** `TIPTAP_IMAGE_MAX_HEIGHT_OPTIONS` — anything else normalises to 60 (silent). */
-export const IMAGE_MAX_HEIGHT_OPTIONS = Object.freeze([45, 60, 75, 90]);
+export const IMAGE_MAX_HEIGHT_OPTIONS = Object.freeze([...TIPTAP_IMAGE_MAX_HEIGHT_OPTIONS]);
 
 /** The canonical `TiptapImagePresentationPlacement` union. */
 export const IMAGE_PRESENTATION_PLACEMENTS = Object.freeze([
@@ -244,35 +250,6 @@ export function isSafeUrl(url) {
   }
 }
 
-// The renderer's CSS grammar, character for character. These values are
-// emitted into inline styles on published pages, which is why the grammar is
-// this narrow — and why a value outside it is dropped rather than escaped.
-const CSS_LENGTH_UNITS = "px|em|rem|ch|ex|vw|vh|svh|lvh|dvh|svw|lvw|dvw|vmin|vmax|%";
-const CSS_LENGTH_RE = new RegExp(`^\\d+(?:\\.\\d+)?(?:${CSS_LENGTH_UNITS})$`, "i");
-const CSS_VAR_RE = /^var\(--[a-z0-9-]+\)$/i;
-const CSS_CALC_TERM = `(?:\\d+(?:\\.\\d+)?(?:${CSS_LENGTH_UNITS})|\\d+(?:\\.\\d+)?|var\\(--[a-z0-9-]+\\))`;
-const CSS_CALC_RE = new RegExp(
-  `^calc\\(\\s*${CSS_CALC_TERM}(?:\\s*[+\\-*/]\\s*${CSS_CALC_TERM})*\\s*\\)$`,
-  "i",
-);
-
-/**
- * Mirrors the renderer's `normalizeCssLengthOverride`: returns the trimmed
- * value, or null when the value is invalid *or* is the site-default sentinel.
- * Callers that need to tell those two apart check the sentinel themselves.
- */
-export function normalizeCssLengthOverride(value, options) {
-  if (typeof value !== "string") return null;
-  const trimmed = value.trim();
-  if (!trimmed || trimmed === TIPTAP_SITE_DEFAULT) return null;
-  if (trimmed === "0") return trimmed;
-  if (options?.allowNone && trimmed.toLowerCase() === "none") return "none";
-  if (CSS_LENGTH_RE.test(trimmed)) return trimmed;
-  if (CSS_VAR_RE.test(trimmed)) return trimmed;
-  if (CSS_CALC_RE.test(trimmed)) return trimmed;
-  return null;
-}
-
 /**
  * The lowercase canonical UUID the API round-trips. Deliberately looser than
  * `config.js`'s site-id pattern on the version nibble: image ids are server

package/src/field-schema.json

@@ -0,0 +1,227 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://taproot.io/schemas/field-definitions.json",
+  "title": "Taproot field definitions",
+  "description": "A flat, closed list of typed fields. shared/field-validation.ts and the API validator interpret it; shared/field-validation-corpus.json is the evidence they agree. Limits: 30 fields, 16 KB of submitted content. JSON Schema maxLength counts code points while the validators count UTF-16 code units, so the validators are authoritative and stricter for astral characters.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["fields"],
+  "properties": {
+    "fields": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 30,
+      "items": { "$ref": "#/$defs/field" }
+    },
+    "contact_field": {
+      "description": "The id of the email field whose value the API copies to subject_email. It must name an email field. Omit it when the form has one email field (that field is the contact); it is required with two or more.",
+      "$ref": "#/$defs/id"
+    },
+    "submit_label": {
+      "description": "The text on the submit button. Omit it for Taproot's default. Must contain more than whitespace; the validator also rejects a blank label, which a schema cannot express.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 40
+    },
+    "after_submit": {
+      "description": "What a visitor sees once a response is sent. Omit it to show Taproot's default message. A page is named by its resource id and must belong to the same site; the release freezes the path the page has when it is built.",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["show"],
+          "properties": {
+            "show": { "const": "message" },
+            "message": {
+              "description": "Omit it for Taproot's default. Must contain more than whitespace; the validator also rejects a blank message, which a schema cannot express.",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 500
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["show", "page_resource_id"],
+          "properties": {
+            "show": { "const": "page" },
+            "page_resource_id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }
+          }
+        }
+      ]
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,39}$" },
+    "label": {
+      "description": "Must contain more than whitespace; the validator also rejects a blank label, which a schema cannot express.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "consentLabel": {
+      "description": "A consent field's label is the agreement the visitor accepts, so it is longer than any other label. Must contain more than whitespace; the validator also rejects a blank label.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1000
+    },
+    "hint": {
+      "description": "Optional helper text drawn under the field. Must contain more than whitespace; the validator rejects a blank hint, which a schema cannot express.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "required": { "type": "boolean" },
+    "shortLength": { "type": "integer", "minimum": 0, "maximum": 500 },
+    "shortMaxLength": { "type": "integer", "minimum": 1, "maximum": 500 },
+    "longLength": { "type": "integer", "minimum": 0, "maximum": 5000 },
+    "longMaxLength": { "type": "integer", "minimum": 1, "maximum": 5000 },
+    "choices": {
+      "description": "Each choice must contain more than whitespace; the validator rejects blank choices, which a schema cannot express.",
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 50,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1, "maxLength": 100 }
+    },
+    "isoDate": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+    "relativeDateBound": {
+      "description": "A date measured from the site's calendar date, resolved when the page loads and again when a submission arrives. offset_days is bounded to a year either side (366 covers a leap year); further out is a fixed date. A fixed date is the other form of a date bound.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["from"],
+      "properties": {
+        "from": {
+          "enum": ["today", "start_of_month", "end_of_month", "start_of_next_month", "end_of_next_month"]
+        },
+        "offset_days": { "type": "integer", "minimum": -366, "maximum": 366 }
+      }
+    },
+    "dateBound": {
+      "oneOf": [{ "$ref": "#/$defs/isoDate" }, { "$ref": "#/$defs/relativeDateBound" }]
+    },
+    "field": {
+      "type": "object",
+      "required": ["id", "type", "label"],
+      "oneOf": [
+        {
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "text" },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" },
+            "min_length": { "$ref": "#/$defs/shortLength" },
+            "max_length": { "$ref": "#/$defs/shortMaxLength" },
+            "format": { "enum": ["digits", "alphanumeric"] }
+          },
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "long_text" },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" },
+            "min_length": { "$ref": "#/$defs/longLength" },
+            "max_length": { "$ref": "#/$defs/longMaxLength" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "enum": ["email", "url"] },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" },
+            "max_length": { "$ref": "#/$defs/shortMaxLength" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "tel" },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "number" },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" },
+            "min": { "type": "number" },
+            "max": { "type": "number" },
+            "format": { "enum": ["integer"] }
+          },
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "date" },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" },
+            "min": { "$ref": "#/$defs/dateBound" },
+            "max": { "$ref": "#/$defs/dateBound" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "required": ["choices"],
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "single_choice" },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" },
+            "choices": { "$ref": "#/$defs/choices" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "required": ["choices"],
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "multi_choice" },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" },
+            "choices": { "$ref": "#/$defs/choices" },
+            "min": { "type": "integer", "minimum": 0, "maximum": 50 },
+            "max": { "type": "integer", "minimum": 0, "maximum": 50 }
+          },
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "checkbox" },
+            "label": { "$ref": "#/$defs/label" },
+            "hint": { "$ref": "#/$defs/hint" },
+            "required": { "$ref": "#/$defs/required" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "type": { "const": "consent" },
+            "label": { "$ref": "#/$defs/consentLabel" },
+            "hint": { "$ref": "#/$defs/hint" }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  }
+}