@rathnasgala2/schemas 3.20.0 → 3.21.0

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

@@ -166,6 +166,7 @@ export type BuildInputContentFrontmatterNormalized = Readonly<{
   readonly status: 'published' | 'unlisted';
   readonly tags: ReadonlyArray<BuildInputPlainLabel>;
   readonly title: BuildInputPlainText;
+  readonly translationOf?: BuildInputSlug;
   readonly updatedAt?: BuildInputRfc3339;
 }> &
   unknown;

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/openapi/http-catalog.json

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

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:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "3.20.0",
+  "version": "3.21.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.21.0",
+      "bom-ref": "@rathnasgala2/schemas@3.21.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.21.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.21.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.21.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.21.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.21.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.21.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.21.0|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@3.20.0",
+      "ref": "@rathnasgala2/schemas@3.21.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.20.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@3.20.0|ajv@8.20.0",
+        "@rathnasgala2/schemas@3.21.0|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@3.21.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.21.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.20.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@3.21.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@3.21.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.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"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@3.21.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.0|fast-uri@3.1.8"
+      "ref": "@rathnasgala2/schemas@3.21.0|fast-uri@3.1.8"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@3.21.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.20.0|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@3.21.0|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"

package/schemas/build-input.schema.json

@@ -890,7 +890,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 +906,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."

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