@rathnasgala2/schemas 3.20.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:
@@ -166,6 +175,7 @@ export type BuildInputContentFrontmatterNormalized = Readonly<{
   readonly status: 'published' | 'unlisted';
   readonly tags: ReadonlyArray<BuildInputPlainLabel>;
   readonly title: BuildInputPlainText;
+  readonly translationOf?: BuildInputSlug;
   readonly updatedAt?: BuildInputRfc3339;
 }> &
   unknown;
@@ -199,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;
@@ -262,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;
@@ -307,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';
   }>;
@@ -320,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;
@@ -418,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/content-frontmatter.d.ts

@@ -96,6 +96,7 @@ export type ContentFrontmatterDocument = Readonly<{
   readonly status: 'draft' | 'published' | 'unlisted' | 'archived';
   readonly tags: ReadonlyArray<ContentFrontmatterPlainLabel>;
   readonly title: ContentFrontmatterPlainText;
+  readonly translationOf?: ContentFrontmatterSlug;
   readonly updatedAt?: ContentFrontmatterRfc3339;
 }> &
   unknown;

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:6d50ed9571629d6d818cc9ad7d638cbbbf74eb98706023784ad405258f3882c8",
+  "openApiDigest": "sha256:42639c6b587144df5a524606fca2ac95528f48039f6785332855fb0d7487fa63",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -2699,5 +2699,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:aaedcc72639047fe375be8a37593c93c4834b1cdf0bc2b4f683eaa8c42a97fda"
+  "digest": "sha256:cc839a8b4a5da1e604fcff157bffb588c7bda0e557bcd78b319e80bf86dfa22f"
 }

package/openapi/openapi.yaml

@@ -1334,6 +1334,11 @@ components:
           x-gala-graphemeLength:
             maximum: 200
             minimum: 1
+        translationOf:
+          description: "SCHEMA-3.21.0: the slug of the primary article this document translates; null on a primary."
+          oneOf:
+            - $ref: "#/components/schemas/PortableContentFrontmatterSlug"
+            - type: "null"
         updatedAt:
           $ref: "#/components/schemas/PortableContentFrontmatterRfc3339"
       required:
@@ -8166,6 +8171,20 @@ components:
           then:
             required:
               - edition
+        - if:
+            required:
+              - translationOf
+          then:
+            not:
+              required:
+                - edition
+            properties:
+              kind:
+                pattern: ^article$
+                type: string
+                x-gala-const: article
+            required:
+              - kind
       dependentRequired:
         seriesOrder:
           - series
@@ -8253,6 +8272,9 @@ components:
           x-gala-graphemeLength:
             maximum: 200
             minimum: 1
+        translationOf:
+          $ref: "#/components/schemas/PortableContentFrontmatterSlug"
+          description: "SCHEMA-3.21.0: the slug of the article this document translates. The group is that article (the primary, in the publication's default language) plus every document naming it. The target must exist in the same content root, be `kind: article`, carry a different `language`, and must not itself carry `translationOf`; at most one document per language per group. A translation's default route is `/<language lowercased>/<primary slug>/` unless `route` is set. The API enforces the cross-document rules; the schema only fixes the shape: `translationOf` is allowed only when `kind` is `article` and never together with `edition`."
         updatedAt:
           $ref: "#/components/schemas/PortableContentFrontmatterRfc3339"
       required:
@@ -13658,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.20.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.20.0",
-      "bom-ref": "@rathnasgala2/schemas@3.20.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.20.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.20.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.20.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.20.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.20.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.20.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.20.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.20.0",
+      "ref": "@rathnasgala2/schemas@3.22.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.20.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@3.20.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.20.0|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@3.22.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.20.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@3.22.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@3.22.0|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.20.0|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@3.20.0|fast-uri@3.1.8",
-        "@rathnasgala2/schemas@3.20.0|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@3.20.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.20.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@3.22.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.0|fast-uri@3.1.8"
+      "ref": "@rathnasgala2/schemas@3.22.0|fast-uri@3.1.8"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@3.22.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.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",
@@ -890,7 +970,11 @@
           "uniqueItems": true
         },
         "edition": { "$ref": "#/$defs/contentEdition" },
-        "seo": { "$ref": "#/$defs/contentSeo" }
+        "seo": { "$ref": "#/$defs/contentSeo" },
+        "translationOf": {
+          "$ref": "#/$defs/slug",
+          "description": "SCHEMA-3.21.0: the slug of the article this document translates. The group is that article (the primary, in the publication's default language) plus every document naming it. The target must exist in the same content root, be `kind: article`, carry a different `language`, and must not itself carry `translationOf`; at most one document per language per group. A translation's default route is `/<language lowercased>/<primary slug>/` unless `route` is set. The API enforces the cross-document rules; the schema only fixes the shape: `translationOf` is allowed only when `kind` is `article` and never together with `edition`."
+        }
       },
       "additionalProperties": false,
       "dependentRequired": { "seriesOrder": ["series"] },
@@ -902,6 +986,14 @@
           },
           "then": { "required": ["edition"] },
           "else": { "not": { "required": ["edition"] } }
+        },
+        {
+          "if": { "required": ["translationOf"] },
+          "then": {
+            "properties": { "kind": { "const": "article" } },
+            "required": ["kind"],
+            "not": { "required": ["edition"] }
+          }
         }
       ],
       "$comment": "Timestamp ordering, canonical set ordering, route derivation, and route/redirect collision rules are enforced semantically."
@@ -1115,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/content-frontmatter.schema.json

@@ -66,6 +66,10 @@
     "edition": { "$ref": "#/$defs/contentEdition" },
     "seo": { "$ref": "#/$defs/contentSeo" },
     "publishAfter": { "$ref": "#/$defs/publishAfterDate" },
+    "translationOf": {
+      "$ref": "#/$defs/slug",
+      "description": "SCHEMA-3.21.0: the slug of the article this document translates. The group is that article (the primary, in the publication's default language) plus every document naming it. The target must exist in the same content root, be `kind: article`, carry a different `language`, and must not itself carry `translationOf`; at most one document per language per group. A translation's default route is `/<language lowercased>/<primary slug>/` unless `route` is set. The API enforces the cross-document rules; the schema only fixes the shape: `translationOf` is allowed only when `kind` is `article` and never together with `edition`."
+    },
     "extensions": { "$ref": "#/$defs/extensionMap" }
   },
   "additionalProperties": false,
@@ -291,6 +295,14 @@
       },
       "then": { "required": ["edition"] },
       "else": { "not": { "required": ["edition"] } }
+    },
+    {
+      "if": { "required": ["translationOf"] },
+      "then": {
+        "properties": { "kind": { "const": "article" } },
+        "required": ["kind"],
+        "not": { "required": ["edition"] }
+      }
     }
   ],
   "$comment": "The content validator enforces canonical set ordering, timestamp ordering, root-kind agreement, and route/redirect collision checks."

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,