@rathnasgala2/schemas 3.21.0 → 3.22.0

package/generated/typescript/contracts/build-input.d.ts

@@ -102,6 +102,15 @@ export type BuildInputColorMode = Readonly<{
 }> &
   unknown;
 
+export type BuildInputContactFormNormalized = Readonly<{
+  readonly enabled: boolean;
+  readonly fields: Readonly<{
+    readonly phone: boolean;
+    readonly website: boolean;
+  }>;
+  readonly intro?: BuildInputRenderableBody;
+}>;
+
 export type BuildInputContentBuildMediaFile = Readonly<{
   readonly byteLength: number;
   readonly mediaType:
@@ -200,6 +209,9 @@ export type BuildInputInteractionsConfig = Readonly<{
     readonly enabled: boolean;
     readonly maxDepth: number;
   }>;
+  readonly follows?: Readonly<{
+    readonly enabled: boolean;
+  }>;
   readonly publicCounts: Readonly<{
     readonly comments: boolean;
     readonly reactions: boolean;
@@ -263,6 +275,21 @@ export type BuildInputNavigationNormalized = Readonly<{
   readonly source: BuildInputNormalizedSource;
 }>;
 
+export type BuildInputNewsletter =
+  | Readonly<{
+      readonly emailContent: 'card' | 'full';
+      readonly mode: 'galascribe';
+      readonly replyToOwner: boolean;
+      readonly text: BuildInputPlainText;
+      readonly title: BuildInputPlainLabel;
+    }>
+  | Readonly<{
+      readonly mode?: 'link';
+      readonly text: BuildInputPlainText;
+      readonly title: BuildInputPlainLabel;
+      readonly url: BuildInputUrlHttps;
+    }>;
+
 export type BuildInputNormalizedSource =
   | Readonly<{
       readonly defaultDigest: BuildInputDigest;
@@ -308,6 +335,7 @@ export type BuildInputPublicationNormalized = Readonly<{
   readonly authorIds: ReadonlyArray<BuildInputStableId>;
   readonly canonicalBase: BuildInputUrlHttps;
   readonly contactAuthorId?: BuildInputStableId;
+  readonly contactForm?: BuildInputContactFormNormalized;
   readonly crawlers?: Readonly<{
     readonly ai: 'allow' | 'block';
   }>;
@@ -321,15 +349,12 @@ export type BuildInputPublicationNormalized = Readonly<{
     readonly heading: BuildInputPlainText;
   }>;
   readonly id: BuildInputStableId;
-  readonly newsletter?: Readonly<{
-    readonly text: BuildInputPlainText;
-    readonly title: BuildInputPlainLabel;
-    readonly url: BuildInputUrlHttps;
-  }>;
+  readonly newsletter?: BuildInputNewsletter;
   readonly profile?: Readonly<{
     readonly body: BuildInputRenderableBody;
     readonly route: BuildInputCanonicalRoute;
   }>;
+  readonly sharing?: BuildInputSharing;
   readonly slug: BuildInputSlug;
   readonly socialLinks: ReadonlyArray<BuildInputSocialLink>;
   readonly sourceDigest: BuildInputDigest;
@@ -419,6 +444,22 @@ export type BuildInputSemver = string;
 
 export type BuildInputSemverRange = string;
 
+export type BuildInputSharing = Readonly<{
+  readonly targets: ReadonlyArray<
+    | 'copy-link'
+    | 'native'
+    | 'x'
+    | 'bluesky'
+    | 'linkedin'
+    | 'facebook'
+    | 'hacker-news'
+    | 'whatsapp'
+    | 'telegram'
+    | 'reddit'
+    | 'email'
+  >;
+}>;
+
 export type BuildInputSlug = string;
 
 export type BuildInputSocialLink = Readonly<{

package/generated/typescript/contracts/interactions-config.d.ts

@@ -78,6 +78,9 @@ export type InteractionsConfigDocument = Readonly<{
     readonly enabled: boolean;
     readonly maxDepth: number;
   }>;
+  readonly follows?: Readonly<{
+    readonly enabled: boolean;
+  }>;
   readonly publicCounts: Readonly<{
     readonly comments: boolean;
     readonly reactions: boolean;

package/generated/typescript/contracts/publication.d.ts

@@ -5,6 +5,14 @@ export type PublicationBcp47 = string;
 
 export type PublicationCanonicalRoute = string;
 
+export type PublicationContactForm = Readonly<{
+  readonly enabled: boolean;
+  readonly fields: Readonly<{
+    readonly phone: boolean;
+    readonly website: boolean;
+  }>;
+}>;
+
 export type PublicationCrawlers = Readonly<{
   readonly ai: 'allow' | 'block';
 }>;
@@ -28,11 +36,20 @@ export type PublicationGlob = string;
 
 export type PublicationIsoCountry = string;
 
-export type PublicationNewsletter = Readonly<{
-  readonly text: PublicationPlainText;
-  readonly title: PublicationPlainLabel;
-  readonly url: PublicationUrlHttps;
-}>;
+export type PublicationNewsletter =
+  | Readonly<{
+      readonly emailContent: 'card' | 'full';
+      readonly mode: 'galascribe';
+      readonly replyToOwner: boolean;
+      readonly text: PublicationPlainText;
+      readonly title: PublicationPlainLabel;
+    }>
+  | Readonly<{
+      readonly mode?: 'link';
+      readonly text: PublicationPlainText;
+      readonly title: PublicationPlainLabel;
+      readonly url: PublicationUrlHttps;
+    }>;
 
 export type PublicationPackageExact = string;
 
@@ -67,6 +84,22 @@ export type PublicationSemver = string;
 
 export type PublicationSemverRange = string;
 
+export type PublicationSharing = Readonly<{
+  readonly targets: ReadonlyArray<
+    | 'copy-link'
+    | 'native'
+    | 'x'
+    | 'bluesky'
+    | 'linkedin'
+    | 'facebook'
+    | 'hacker-news'
+    | 'whatsapp'
+    | 'telegram'
+    | 'reddit'
+    | 'email'
+  >;
+}>;
+
 export type PublicationSlug = string;
 
 export type PublicationSocialLink = Readonly<{
@@ -94,6 +127,7 @@ export type PublicationUrn = string;
 export type PublicationDocument = Readonly<{
   readonly authors: ReadonlyArray<PublicationRepoRelativePath>;
   readonly canonicalBase: PublicationUrlHttps;
+  readonly contactForm?: PublicationContactForm;
   readonly contactRef?: PublicationRepoRelativePath;
   readonly crawlers?: PublicationCrawlers;
   readonly defaultImageRef?: PublicationRepoRelativePath;
@@ -107,6 +141,7 @@ export type PublicationDocument = Readonly<{
   readonly profile?: PublicationPublicationProfile;
   readonly schemaId: 'urn:gala:schema:publication:2.0.0';
   readonly schemaVersion: '2.0.0';
+  readonly sharing?: PublicationSharing;
   readonly slug: PublicationSlug;
   readonly socialLinks: ReadonlyArray<PublicationSocialLink>;
   readonly title: PublicationPlainText;

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:f015c933c536a3a0030eeb06986d014debd8c929b968c82df9817976492fd6d3",
+  "openApiDigest": "sha256:42639c6b587144df5a524606fca2ac95528f48039f6785332855fb0d7487fa63",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -2699,5 +2699,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:02efa2a51a27ec6907da974e1d7b4b6baaf18efe8783dcdf8f432c8e91f2efea"
+  "digest": "sha256:cc839a8b4a5da1e604fcff157bffb588c7bda0e557bcd78b319e80bf86dfa22f"
 }

package/openapi/openapi.yaml

@@ -13680,6 +13680,15 @@ components:
             - allowReplies
             - maxDepth
           type: object
+        follows:
+          additionalProperties: false
+          description: "SCHEMA-3.22.0: reader follows. `enabled: true` shows the Follow control, with which a signed-in reader follows an author of the site; an absent `follows` member means off. The user template seeds it on for new sites."
+          properties:
+            enabled:
+              type: boolean
+          required:
+            - enabled
+          type: object
         publicCounts:
           additionalProperties: false
           properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "3.21.0",
+  "version": "3.22.0",
   "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
   "type": "module",
   "license": "Apache-2.0",

package/sbom.cdx.json

@@ -97,8 +97,8 @@
       "type": "library",
       "name": "schemas",
       "group": "@rathnasgala2",
-      "version": "3.21.0",
-      "bom-ref": "@rathnasgala2/schemas@3.21.0",
+      "version": "3.22.0",
+      "bom-ref": "@rathnasgala2/schemas@3.22.0",
       "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
       "licenses": [
         {
@@ -108,7 +108,7 @@
           }
         }
       ],
-      "purl": "pkg:npm/%40rathnasgala2/schemas@3.21.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
+      "purl": "pkg:npm/%40rathnasgala2/schemas@3.22.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
       "externalReferences": [
         {
           "url": "https://github.com/rathnasgala2/schema/issues",
@@ -153,7 +153,7 @@
       "type": "library",
       "name": "ajv-formats",
       "version": "3.0.1",
-      "bom-ref": "@rathnasgala2/schemas@3.21.0|ajv-formats@3.0.1",
+      "bom-ref": "@rathnasgala2/schemas@3.22.0|ajv-formats@3.0.1",
       "licenses": [
         {
           "license": {
@@ -187,7 +187,7 @@
       "type": "library",
       "name": "ajv",
       "version": "8.20.0",
-      "bom-ref": "@rathnasgala2/schemas@3.21.0|ajv@8.20.0",
+      "bom-ref": "@rathnasgala2/schemas@3.22.0|ajv@8.20.0",
       "licenses": [
         {
           "license": {
@@ -221,7 +221,7 @@
       "type": "library",
       "name": "fast-deep-equal",
       "version": "3.1.3",
-      "bom-ref": "@rathnasgala2/schemas@3.21.0|fast-deep-equal@3.1.3",
+      "bom-ref": "@rathnasgala2/schemas@3.22.0|fast-deep-equal@3.1.3",
       "licenses": [
         {
           "license": {
@@ -255,7 +255,7 @@
       "type": "library",
       "name": "fast-uri",
       "version": "3.1.8",
-      "bom-ref": "@rathnasgala2/schemas@3.21.0|fast-uri@3.1.8",
+      "bom-ref": "@rathnasgala2/schemas@3.22.0|fast-uri@3.1.8",
       "licenses": [
         {
           "license": {
@@ -289,7 +289,7 @@
       "type": "library",
       "name": "json-schema-traverse",
       "version": "1.0.0",
-      "bom-ref": "@rathnasgala2/schemas@3.21.0|json-schema-traverse@1.0.0",
+      "bom-ref": "@rathnasgala2/schemas@3.22.0|json-schema-traverse@1.0.0",
       "licenses": [
         {
           "license": {
@@ -323,7 +323,7 @@
       "type": "library",
       "name": "require-from-string",
       "version": "2.0.2",
-      "bom-ref": "@rathnasgala2/schemas@3.21.0|require-from-string@2.0.2",
+      "bom-ref": "@rathnasgala2/schemas@3.22.0|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@3.21.0",
+      "ref": "@rathnasgala2/schemas@3.22.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.21.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@3.21.0|ajv@8.20.0",
+        "@rathnasgala2/schemas@3.22.0|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@3.22.0|ajv@8.20.0",
         "pkg:npm/semver@7.8.5",
         "urn:gala:source-data:iana-ipv4-special-registry",
         "urn:gala:source-data:iana-ipv6-special-registry",
@@ -1089,31 +1089,31 @@
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.21.0|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@3.22.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.21.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@3.22.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.21.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@3.22.0|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.21.0|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@3.21.0|fast-uri@3.1.8",
-        "@rathnasgala2/schemas@3.21.0|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@3.21.0|require-from-string@2.0.2"
+        "@rathnasgala2/schemas@3.22.0|fast-deep-equal@3.1.3",
+        "@rathnasgala2/schemas@3.22.0|fast-uri@3.1.8",
+        "@rathnasgala2/schemas@3.22.0|json-schema-traverse@1.0.0",
+        "@rathnasgala2/schemas@3.22.0|require-from-string@2.0.2"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.21.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@3.22.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.21.0|fast-uri@3.1.8"
+      "ref": "@rathnasgala2/schemas@3.22.0|fast-uri@3.1.8"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.21.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@3.22.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.21.0|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@3.22.0|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"

package/schemas/build-input.schema.json

@@ -514,10 +514,22 @@
           "properties": { "ai": { "enum": ["allow", "block"] } },
           "additionalProperties": false
         },
-        "newsletter": {
+        "newsletter": { "$ref": "#/$defs/newsletter" },
+        "sharing": { "$ref": "#/$defs/sharing" },
+        "contactForm": { "$ref": "#/$defs/contactFormNormalized" },
+        "sourcePath": { "$ref": "#/$defs/repoRelativePath" },
+        "sourceDigest": { "$ref": "#/$defs/digest" }
+      },
+      "additionalProperties": false
+    },
+    "newsletter": {
+      "description": "SCHEMA-3.22.0: the newsletter panel. Link mode (`mode` absent or `link`) sends readers to the author's own newsletter at `url`; Galascribe mode (`mode: \"galascribe\"`) collects and mails subscribers itself. An absent `newsletter` member means the panel is off.",
+      "oneOf": [
+        {
           "type": "object",
           "required": ["url", "title", "text"],
           "properties": {
+            "mode": { "const": "link" },
             "url": { "$ref": "#/$defs/urlHttps" },
             "title": { "$ref": "#/$defs/plainLabel" },
             "text": {
@@ -525,12 +537,80 @@
               "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
             }
           },
+          "additionalProperties": false,
+          "description": "Link mode: the panel links to an external newsletter. `mode` is optional and `link` when present, so a 3.21 publication still validates."
+        },
+        {
+          "type": "object",
+          "required": ["mode", "title", "text", "emailContent", "replyToOwner"],
+          "properties": {
+            "mode": { "const": "galascribe" },
+            "title": { "$ref": "#/$defs/plainLabel" },
+            "text": {
+              "$ref": "#/$defs/plainText",
+              "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
+            },
+            "emailContent": {
+              "enum": ["card", "full"],
+              "description": "`card` mails the post title, description, image and a Read the post button; the template renders no email fragment. `full` mails the whole post: for each published post the template renders an email-safe HTML fragment at `/_gala/email/<content id>.html` (`<content id>` is the post's front-matter `id`; absolute URLs and inline-safe markup only; `noindex`; absent from the sitemap, the feeds, the search index and the llms files), which the API fetches after the generation is certified live."
+            },
+            "replyToOwner": {
+              "type": "boolean",
+              "description": "When true, subscribers' replies go to the site owner's contact email; when false the emails carry no Reply-To."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Galascribe mode: the panel is an email field and a Subscribe button. `title` and `text` are the panel heading and sentence; there is no `url`. The API refuses to turn this mode on until the site owner has a postal address in their Account."
+        }
+      ]
+    },
+    "sharing": {
+      "type": "object",
+      "required": ["targets"],
+      "properties": {
+        "targets": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "copy-link",
+              "native",
+              "x",
+              "bluesky",
+              "linkedin",
+              "facebook",
+              "hacker-news",
+              "whatsapp",
+              "telegram",
+              "reddit",
+              "email"
+            ]
+          },
+          "minItems": 0,
+          "maxItems": 11,
+          "uniqueItems": true
+        }
+      },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.22.0: the share buttons shown on each article. `targets` is the display order: 0 to 11 unique members of the closed target set. An absent `sharing` member means `[\"copy-link\"]` (the Copy link button only); an empty `targets` array means no share buttons. `native` is shown only where the browser offers the system share sheet; every other target is a plain link to that service's documented share URL. Bookmark is not a share target and is unaffected."
+    },
+    "contactFormNormalized": {
+      "type": "object",
+      "required": ["enabled", "fields"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "fields": {
+          "type": "object",
+          "required": ["website", "phone"],
+          "properties": {
+            "website": { "type": "boolean" },
+            "phone": { "type": "boolean" }
+          },
           "additionalProperties": false
         },
-        "sourcePath": { "$ref": "#/$defs/repoRelativePath" },
-        "sourceDigest": { "$ref": "#/$defs/digest" }
+        "intro": { "$ref": "#/$defs/renderableBody" }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "SCHEMA-3.22.0: the normalized contact form. `intro` is the rendered body of the optional `gala/theme-pages/contact.md`, absent when the file is absent (the template then shows its default intro). The template renders the `/contact/` page only when `enabled` is true."
     },
     "policyPageNormalized": {
       "type": "object",
@@ -1127,6 +1207,13 @@
             "comments": { "type": "boolean" }
           },
           "additionalProperties": false
+        },
+        "follows": {
+          "type": "object",
+          "required": ["enabled"],
+          "properties": { "enabled": { "type": "boolean" } },
+          "additionalProperties": false,
+          "description": "SCHEMA-3.22.0: reader follows. `enabled: true` shows the Follow control, with which a signed-in reader follows an author of the site; an absent `follows` member means off. The user template seeds it on for new sites."
         }
       },
       "additionalProperties": false,

package/schemas/interactions-config.schema.json

@@ -45,6 +45,13 @@
         "comments": { "type": "boolean" }
       },
       "additionalProperties": false
+    },
+    "follows": {
+      "type": "object",
+      "required": ["enabled"],
+      "properties": { "enabled": { "type": "boolean" } },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.22.0: reader follows. `enabled: true` shows the Follow control, with which a signed-in reader follows an author of the site; an absent `follows` member means off. The user template seeds it on for new sites."
     }
   },
   "additionalProperties": false,

package/schemas/publication.schema.json

@@ -49,6 +49,8 @@
     "policies": { "$ref": "#/$defs/publicationPolicies" },
     "footerCard": { "$ref": "#/$defs/footerCard" },
     "newsletter": { "$ref": "#/$defs/newsletter" },
+    "sharing": { "$ref": "#/$defs/sharing" },
+    "contactForm": { "$ref": "#/$defs/contactForm" },
     "crawlers": { "$ref": "#/$defs/crawlers" },
     "extensions": { "$ref": "#/$defs/extensionMap" }
   },
@@ -262,17 +264,93 @@
       "additionalProperties": false
     },
     "newsletter": {
+      "description": "SCHEMA-3.22.0: the newsletter panel. Link mode (`mode` absent or `link`) sends readers to the author's own newsletter at `url`; Galascribe mode (`mode: \"galascribe\"`) collects and mails subscribers itself. An absent `newsletter` member means the panel is off.",
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["url", "title", "text"],
+          "properties": {
+            "mode": { "const": "link" },
+            "url": { "$ref": "#/$defs/urlHttps" },
+            "title": { "$ref": "#/$defs/plainLabel" },
+            "text": {
+              "$ref": "#/$defs/plainText",
+              "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
+            }
+          },
+          "additionalProperties": false,
+          "description": "Link mode: the panel links to an external newsletter. `mode` is optional and `link` when present, so a 3.21 publication still validates."
+        },
+        {
+          "type": "object",
+          "required": ["mode", "title", "text", "emailContent", "replyToOwner"],
+          "properties": {
+            "mode": { "const": "galascribe" },
+            "title": { "$ref": "#/$defs/plainLabel" },
+            "text": {
+              "$ref": "#/$defs/plainText",
+              "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
+            },
+            "emailContent": {
+              "enum": ["card", "full"],
+              "description": "`card` mails the post title, description, image and a Read the post button; the template renders no email fragment. `full` mails the whole post: for each published post the template renders an email-safe HTML fragment at `/_gala/email/<content id>.html` (`<content id>` is the post's front-matter `id`; absolute URLs and inline-safe markup only; `noindex`; absent from the sitemap, the feeds, the search index and the llms files), which the API fetches after the generation is certified live."
+            },
+            "replyToOwner": {
+              "type": "boolean",
+              "description": "When true, subscribers' replies go to the site owner's contact email; when false the emails carry no Reply-To."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Galascribe mode: the panel is an email field and a Subscribe button. `title` and `text` are the panel heading and sentence; there is no `url`. The API refuses to turn this mode on until the site owner has a postal address in their Account."
+        }
+      ]
+    },
+    "sharing": {
       "type": "object",
-      "required": ["url", "title", "text"],
+      "required": ["targets"],
       "properties": {
-        "url": { "$ref": "#/$defs/urlHttps" },
-        "title": { "$ref": "#/$defs/plainLabel" },
-        "text": {
-          "$ref": "#/$defs/plainText",
-          "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
+        "targets": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "copy-link",
+              "native",
+              "x",
+              "bluesky",
+              "linkedin",
+              "facebook",
+              "hacker-news",
+              "whatsapp",
+              "telegram",
+              "reddit",
+              "email"
+            ]
+          },
+          "minItems": 0,
+          "maxItems": 11,
+          "uniqueItems": true
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "SCHEMA-3.22.0: the share buttons shown on each article. `targets` is the display order: 0 to 11 unique members of the closed target set. An absent `sharing` member means `[\"copy-link\"]` (the Copy link button only); an empty `targets` array means no share buttons. `native` is shown only where the browser offers the system share sheet; every other target is a plain link to that service's documented share URL. Bookmark is not a share target and is unaffected."
+    },
+    "contactForm": {
+      "type": "object",
+      "required": ["enabled", "fields"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "fields": {
+          "type": "object",
+          "required": ["website", "phone"],
+          "properties": {
+            "website": { "type": "boolean" },
+            "phone": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.22.0: the site's contact form. `enabled` turns the form on, and the template renders the `/contact/` page only when it is true. `fields.website` and `fields.phone` add the optional Website and Phone inputs; name, email and message are always present. The intro text is not a member: it is the optional document `gala/theme-pages/contact.md`, and the template shows a default intro when it is absent. An absent `contactForm` means no form. The API, not the schema, limits the form to the Pro and Business plans."
     },
     "crawlers": {
       "type": "object",