@rathnasgala2/schemas 3.19.1 → 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:ad69bd463734d47aa91cb5544634209587658435564fbb9e96ceb3d302c15226",
+  "openApiDigest": "sha256:f015c933c536a3a0030eeb06986d014debd8c929b968c82df9817976492fd6d3",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -2699,5 +2699,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:df68ea5a261750bcbd7c6449ab1fb9b5d0329859cc6d73c7a3e17142430d3918"
+  "digest": "sha256:02efa2a51a27ec6907da974e1d7b4b6baaf18efe8783dcdf8f432c8e91f2efea"
 }

package/openapi/openapi.yaml

@@ -1210,7 +1210,7 @@ components:
         path:
           maxLength: 512
           minLength: 1
-          pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala(?:/|$))(?!gala\.lock\.json$)[^\x00-\x1f\x7f\\]+$
+          pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala\.lock\.json$)(?:gala/theme-pages/[^\x00-\x1f\x7f\\/]+|(?!gala(?:/|$))[^\x00-\x1f\x7f\\]+)$
           type: string
         text:
           maxLength: 1048576
@@ -1287,7 +1287,7 @@ components:
         path:
           maxLength: 512
           minLength: 1
-          pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala(?:/|$))(?!gala\.lock\.json$)[^\x00-\x1f\x7f\\]+$
+          pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala\.lock\.json$)(?:gala/theme-pages/[^\x00-\x1f\x7f\\/]+|(?!gala(?:/|$))[^\x00-\x1f\x7f\\]+)$
           type: string
         size:
           format: int64
@@ -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:
@@ -2890,7 +2895,7 @@ components:
         path:
           maxLength: 512
           minLength: 1
-          pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala(?:/|$))(?!gala\.lock\.json$)[^\x00-\x1f\x7f\\]+$
+          pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala\.lock\.json$)(?:gala/theme-pages/[^\x00-\x1f\x7f\\/]+|(?!gala(?:/|$))[^\x00-\x1f\x7f\\]+)$
           type: string
         revision:
           pattern: ^(?:sha1:[0-9a-f]{40}|sha256:[0-9a-f]{64})$
@@ -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:
@@ -35165,7 +35187,7 @@ paths:
           schema:
             maxLength: 512
             minLength: 1
-            pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala(?:/|$))(?!gala\.lock\.json$)[^\x00-\x1f\x7f\\]+$
+            pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala\.lock\.json$)(?:gala/theme-pages/[^\x00-\x1f\x7f\\/]+|(?!gala(?:/|$))[^\x00-\x1f\x7f\\]+)$
             type: string
         - example: sha1:0000000000000000000000000000000000000000
           in: query

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "3.19.1",
+  "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.19.1",
-      "bom-ref": "@rathnasgala2/schemas@3.19.1",
+      "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.19.1?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.19.1|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.19.1|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.19.1|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.19.1|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.19.1|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.19.1|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.19.1",
+      "ref": "@rathnasgala2/schemas@3.21.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.19.1|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@3.19.1|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.19.1|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@3.21.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.19.1|ajv@8.20.0"
+        "@rathnasgala2/schemas@3.21.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.19.1|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@3.21.0|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.19.1|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@3.19.1|fast-uri@3.1.8",
-        "@rathnasgala2/schemas@3.19.1|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@3.19.1|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.19.1|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@3.21.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.19.1|fast-uri@3.1.8"
+      "ref": "@rathnasgala2/schemas@3.21.0|fast-uri@3.1.8"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.19.1|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@3.21.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.19.1|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."