@rathnasgala2/schemas 3.20.0 → 3.22.0

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",