@rathnasgala2/schemas 3.8.0 → 3.10.0

package/sbom.cdx.json

@@ -97,8 +97,8 @@
       "type": "library",
       "name": "schemas",
       "group": "@rathnasgala2",
-      "version": "3.8.0",
-      "bom-ref": "@rathnasgala2/schemas@3.8.0",
+      "version": "3.10.0",
+      "bom-ref": "@rathnasgala2/schemas@3.10.0",
       "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
       "licenses": [
         {
@@ -108,7 +108,7 @@
           }
         }
       ],
-      "purl": "pkg:npm/%40rathnasgala2/schemas@3.8.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
+      "purl": "pkg:npm/%40rathnasgala2/schemas@3.10.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.8.0|ajv-formats@3.0.1",
+      "bom-ref": "@rathnasgala2/schemas@3.10.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.8.0|ajv@8.20.0",
+      "bom-ref": "@rathnasgala2/schemas@3.10.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.8.0|fast-deep-equal@3.1.3",
+      "bom-ref": "@rathnasgala2/schemas@3.10.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.8.0|fast-uri@3.1.8",
+      "bom-ref": "@rathnasgala2/schemas@3.10.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.8.0|json-schema-traverse@1.0.0",
+      "bom-ref": "@rathnasgala2/schemas@3.10.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.8.0|require-from-string@2.0.2",
+      "bom-ref": "@rathnasgala2/schemas@3.10.0|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@3.8.0",
+      "ref": "@rathnasgala2/schemas@3.10.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.8.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@3.8.0|ajv@8.20.0",
+        "@rathnasgala2/schemas@3.10.0|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@3.10.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.8.0|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@3.10.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.8.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@3.10.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.8.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@3.10.0|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.8.0|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@3.8.0|fast-uri@3.1.8",
-        "@rathnasgala2/schemas@3.8.0|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@3.8.0|require-from-string@2.0.2"
+        "@rathnasgala2/schemas@3.10.0|fast-deep-equal@3.1.3",
+        "@rathnasgala2/schemas@3.10.0|fast-uri@3.1.8",
+        "@rathnasgala2/schemas@3.10.0|json-schema-traverse@1.0.0",
+        "@rathnasgala2/schemas@3.10.0|require-from-string@2.0.2"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.8.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@3.10.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.8.0|fast-uri@3.1.8"
+      "ref": "@rathnasgala2/schemas@3.10.0|fast-uri@3.1.8"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.8.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@3.10.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.8.0|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@3.10.0|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"

package/schemas/appearance.schema.json

@@ -211,10 +211,37 @@
     "semanticTokens": {
       "type": "object",
       "required": [],
-      "properties": {},
+      "properties": {
+        "accent": {
+          "type": "object",
+          "required": ["light", "dark"],
+          "properties": {
+            "light": { "type": "string", "pattern": "^#[0-9a-f]{6}$" },
+            "dark": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }
+          },
+          "additionalProperties": false
+        },
+        "canvas": {
+          "type": "object",
+          "required": ["light", "dark"],
+          "properties": {
+            "light": { "type": "string", "pattern": "^#[0-9a-f]{6}$" },
+            "dark": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }
+          },
+          "additionalProperties": false
+        },
+        "text": {
+          "type": "object",
+          "required": ["light", "dark"],
+          "properties": {
+            "light": { "type": "string", "pattern": "^#[0-9a-f]{6}$" },
+            "dark": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }
+          },
+          "additionalProperties": false
+        }
+      },
       "additionalProperties": false,
-      "maxProperties": 0,
-      "$comment": "Fail closed: only the documented empty object is accepted until the semantic-token catalog is accepted."
+      "description": "SCHEMA-3.10.0: the author's publication palette. Each role (accent, canvas, text) is optional; when present it carries both light and dark as opaque lowercase #rrggbb. An absent role uses the theme's default; `{}` selects the theme's default palette entirely."
     },
     "attribution": {
       "type": "object",

package/schemas/build-input.schema.json

@@ -721,10 +721,37 @@
     "semanticTokens": {
       "type": "object",
       "required": [],
-      "properties": {},
+      "properties": {
+        "accent": {
+          "type": "object",
+          "required": ["light", "dark"],
+          "properties": {
+            "light": { "type": "string", "pattern": "^#[0-9a-f]{6}$" },
+            "dark": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }
+          },
+          "additionalProperties": false
+        },
+        "canvas": {
+          "type": "object",
+          "required": ["light", "dark"],
+          "properties": {
+            "light": { "type": "string", "pattern": "^#[0-9a-f]{6}$" },
+            "dark": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }
+          },
+          "additionalProperties": false
+        },
+        "text": {
+          "type": "object",
+          "required": ["light", "dark"],
+          "properties": {
+            "light": { "type": "string", "pattern": "^#[0-9a-f]{6}$" },
+            "dark": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }
+          },
+          "additionalProperties": false
+        }
+      },
       "additionalProperties": false,
-      "maxProperties": 0,
-      "$comment": "Fail closed: only the documented empty object is accepted until the semantic-token catalog is accepted."
+      "description": "SCHEMA-3.10.0: the author's publication palette. Each role (accent, canvas, text) is optional; when present it carries both light and dark as opaque lowercase #rrggbb. An absent role uses the theme's default; `{}` selects the theme's default palette entirely."
     },
     "appearanceNormalized": {
       "type": "object",

package/schemas/problem.schema.json

@@ -186,7 +186,27 @@
       "required": ["pointer", "code"],
       "properties": {
         "pointer": { "type": "string", "minLength": 1, "maxLength": 1024 },
-        "code": { "$ref": "#/$defs/problemCode" }
+        "code": { "$ref": "#/$defs/problemCode" },
+        "reason": {
+          "type": "string",
+          "enum": [
+            "AUTHOR_EDITED",
+            "BRANCH_PROTECTION",
+            "REPOSITORY_ARCHIVED",
+            "INSTALLATION_SUSPENDED",
+            "WORKFLOWS_PERMISSION_MISSING",
+            "AUTHORIZATION_LOST",
+            "FORBIDDEN"
+          ],
+          "description": "SCHEMA-3.9.0, optional: why a REPOSITORY_NEEDS_UPDATE error needs the author. AUTHOR_EDITED: a managed file was changed in a way only the author may resolve. BRANCH_PROTECTION: GitHub refused Galascribe's own commit. REPOSITORY_ARCHIVED: the repository is archived. INSTALLATION_SUSPENDED: the GitHub App installation is suspended. WORKFLOWS_PERMISSION_MISSING: the installation has not accepted the workflows permission. AUTHORIZATION_LOST: Galascribe lost its GitHub authorization. FORBIDDEN: GitHub refused for another permission reason. Absent from older servers and for other codes; a client shows a generic sentence for a value it does not know."
+        },
+        "paths": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1, "maxLength": 512 },
+          "minItems": 0,
+          "maxItems": 50,
+          "description": "SCHEMA-3.9.0, optional: the managed repository file paths the error is about, as the App lists them. Absent from older servers."
+        }
       },
       "additionalProperties": false
     }

package/schemas/theme-contract.schema.json

@@ -1370,6 +1370,21 @@
       "minItems": 116,
       "maxItems": 116
     },
+    "palette": {
+      "type": "object",
+      "required": ["profile", "follow"],
+      "properties": {
+        "profile": { "const": "gala-palette-follow-v1" },
+        "follow": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/paletteFollow" },
+          "minItems": 0,
+          "maxItems": 40
+        }
+      },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.10.0, optional: which palette seed each colour of each palette-drivable token follows. Optional here so contract-3 archive validation is unchanged; the template requires it."
+    },
     "modes": { "const": ["dark", "light", "system"] },
     "assets": {
       "type": "array",
@@ -2011,6 +2026,175 @@
       ],
       "$comment": "Every value is checked against its type's allow-list grammar; keyword tokens carry a per-key enum on their tokens position. Only color, paint, border, shadow tokens may differ between light and dark; every other type must be byte-equal in both modes (enforced by the semantic validator). Font-family components are each limited to 64 ASCII bytes."
     },
+    "paletteFollow": {
+      "type": "object",
+      "required": ["key", "light", "dark"],
+      "properties": {
+        "key": {
+          "enum": [
+            "border-button",
+            "border-card",
+            "border-chip",
+            "border-media-divider",
+            "border-quote",
+            "border-row-divider",
+            "border-section-rule",
+            "color-accent",
+            "color-accent-2",
+            "color-border",
+            "color-btn-panel",
+            "color-btn-panel-text",
+            "color-btn-text",
+            "color-canvas",
+            "color-chip-text",
+            "color-focus",
+            "color-footer",
+            "color-header",
+            "color-icon-accent",
+            "color-link",
+            "color-link-underline",
+            "color-link-underline-hover",
+            "color-link-visited",
+            "color-on-accent",
+            "color-panel-muted",
+            "color-panel-text",
+            "color-selection",
+            "color-surface",
+            "color-surface-raised",
+            "color-text",
+            "color-text-faint",
+            "color-text-muted",
+            "color-toc-active",
+            "color-toc-active-text",
+            "paint-button",
+            "paint-chip",
+            "paint-page-decor",
+            "paint-panel",
+            "shadow-avatar-ring",
+            "shadow-button"
+          ]
+        },
+        "light": {
+          "type": "array",
+          "items": { "enum": ["accent", "canvas", "text", null] },
+          "minItems": 0,
+          "maxItems": 15
+        },
+        "dark": {
+          "type": "array",
+          "items": { "enum": ["accent", "canvas", "text", null] },
+          "minItems": 0,
+          "maxItems": 15
+        }
+      },
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "key": {
+                "enum": [
+                  "color-accent",
+                  "color-accent-2",
+                  "color-border",
+                  "color-btn-panel",
+                  "color-btn-panel-text",
+                  "color-btn-text",
+                  "color-canvas",
+                  "color-chip-text",
+                  "color-focus",
+                  "color-footer",
+                  "color-header",
+                  "color-icon-accent",
+                  "color-link",
+                  "color-link-underline",
+                  "color-link-underline-hover",
+                  "color-link-visited",
+                  "color-on-accent",
+                  "color-panel-muted",
+                  "color-panel-text",
+                  "color-selection",
+                  "color-surface",
+                  "color-surface-raised",
+                  "color-text",
+                  "color-text-faint",
+                  "color-text-muted",
+                  "color-toc-active",
+                  "color-toc-active-text"
+                ]
+              }
+            },
+            "required": ["key"]
+          },
+          "then": {
+            "properties": {
+              "light": { "maxItems": 1 },
+              "dark": { "maxItems": 1 }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "key": {
+                "enum": [
+                  "border-button",
+                  "border-card",
+                  "border-chip",
+                  "border-media-divider",
+                  "border-quote",
+                  "border-row-divider",
+                  "border-section-rule"
+                ]
+              }
+            },
+            "required": ["key"]
+          },
+          "then": {
+            "properties": {
+              "light": { "maxItems": 1 },
+              "dark": { "maxItems": 1 }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "key": { "enum": ["shadow-avatar-ring", "shadow-button"] }
+            },
+            "required": ["key"]
+          },
+          "then": {
+            "properties": {
+              "light": { "maxItems": 3 },
+              "dark": { "maxItems": 3 }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "key": {
+                "enum": [
+                  "paint-button",
+                  "paint-chip",
+                  "paint-page-decor",
+                  "paint-panel"
+                ]
+              }
+            },
+            "required": ["key"]
+          },
+          "then": {
+            "properties": {
+              "light": { "maxItems": 15 },
+              "dark": { "maxItems": 15 }
+            }
+          }
+        }
+      ],
+      "$comment": "The semantic validator requires each list length to equal the number of colours in the matching mode value of the named token, and each key to appear at most once."
+    },
     "passiveAsset": {
       "type": "object",
       "required": ["path", "mediaType", "byteLength", "sha256", "license"],
@@ -2125,7 +2309,7 @@
         "required": ["contractVersion"]
       },
       "then": {
-        "properties": { "templateRange": { "const": "^4.0.0" } },
+        "properties": { "templateRange": { "enum": ["^4.0.0", "^4.1.0"] } },
         "required": ["composition"],
         "allOf": [
           {