@rathnasgala2/schemas 3.8.0 → 3.10.0

package/generated/typescript/contracts/appearance.d.ts

@@ -41,7 +41,20 @@ export type AppearanceRepoRelativePath = string;
 
 export type AppearanceRfc3339 = string;
 
-export type AppearanceSemanticTokens = Readonly<Record<string, never>>;
+export type AppearanceSemanticTokens = Readonly<{
+  readonly accent?: Readonly<{
+    readonly dark: string;
+    readonly light: string;
+  }>;
+  readonly canvas?: Readonly<{
+    readonly dark: string;
+    readonly light: string;
+  }>;
+  readonly text?: Readonly<{
+    readonly dark: string;
+    readonly light: string;
+  }>;
+}>;
 
 export type AppearanceSemver = string;
 

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

@@ -366,7 +366,20 @@ export type BuildInputResolvedMedia = Readonly<{
 
 export type BuildInputRfc3339 = string;
 
-export type BuildInputSemanticTokens = Readonly<Record<string, never>>;
+export type BuildInputSemanticTokens = Readonly<{
+  readonly accent?: Readonly<{
+    readonly dark: string;
+    readonly light: string;
+  }>;
+  readonly canvas?: Readonly<{
+    readonly dark: string;
+    readonly light: string;
+  }>;
+  readonly text?: Readonly<{
+    readonly dark: string;
+    readonly light: string;
+  }>;
+}>;
 
 export type BuildInputSemver = string;
 

package/generated/typescript/contracts/problem.d.ts

@@ -11,7 +11,16 @@ export type ProblemExtensionKey = string;
 
 export type ProblemFieldError = Readonly<{
   readonly code: ProblemProblemCode;
+  readonly paths?: ReadonlyArray<string>;
   readonly pointer: string;
+  readonly reason?:
+    | 'AUTHOR_EDITED'
+    | 'BRANCH_PROTECTION'
+    | 'REPOSITORY_ARCHIVED'
+    | 'INSTALLATION_SUSPENDED'
+    | 'WORKFLOWS_PERMISSION_MISSING'
+    | 'AUTHORIZATION_LOST'
+    | 'FORBIDDEN';
 }>;
 
 export type ProblemGitObjectId = string;

package/generated/typescript/contracts/theme-contract.d.ts

@@ -21,6 +21,53 @@ export type ThemeContractPackageExact = string;
 
 export type ThemeContractPackageRange = string;
 
+export type ThemeContractPaletteFollow = Readonly<{
+  readonly dark: ReadonlyArray<'accent' | 'canvas' | 'text' | null>;
+  readonly key:
+    | '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';
+  readonly light: ReadonlyArray<'accent' | 'canvas' | 'text' | null>;
+}> &
+  unknown;
+
 export type ThemeContractPassiveAsset = Readonly<{
   readonly byteLength: ThemeContractNonNegativeInt64;
   readonly license: ThemeContractSpdxExpression;
@@ -330,6 +377,10 @@ export type ThemeContractDocument = (
     readonly integrity: ThemeContractDigest;
     readonly modes: ['dark', 'light', 'system'];
     readonly package: string & ThemeContractPackageExact;
+    readonly palette?: Readonly<{
+      readonly follow: ReadonlyArray<ThemeContractPaletteFollow>;
+      readonly profile: 'gala-palette-follow-v1';
+    }>;
     readonly schemaId: 'urn:gala:schema:theme-contract:2.0.0';
     readonly schemaVersion: '2.0.0';
     readonly slotHooks: ReadonlyArray<ThemeContractPlainLabel>;

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:e6fd6235d1b1a32d1f17ff8f6badc5db21f91e4b1aa3622b5fd8376faace3654",
+  "openApiDigest": "sha256:6cb44277f117370a70e3828a1a5fdadbfbd1ddb5df3e84b317acf205d5913aeb",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -2121,5 +2121,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:d1e44a2e15a91541e28f86087dbe9a2369669cac422c4ce7570dd0b2e60c0c67"
+  "digest": "sha256:161281d4484ec95bf4980bbd15129efca7630a14a23ba66d30b3820294df714b"
 }

package/openapi/openapi.yaml

@@ -1056,7 +1056,10 @@ components:
         values to change only `attribution`. `attribution` (SCHEMA-3.3.0) is
         optional: when present the server writes it as
         `gala/appearance.json`'s `attribution`; when absent the file's
-        `attribution` is preserved unchanged.
+        `attribution` is preserved unchanged. `tokens` (SCHEMA-3.10.0) is
+        optional: the author's publication palette, written as
+        `gala/appearance.json`'s `tokens`; when absent the file's `tokens`
+        are preserved unchanged, and `{}` resets to the theme's own colours.
       properties:
         attribution:
           $ref: "#/components/schemas/PortableAppearanceAttribution"
@@ -1064,6 +1067,8 @@ components:
           $ref: "#/components/schemas/AppearanceColorMode"
         themeId:
           $ref: "#/components/schemas/AppearanceThemeId"
+        tokens:
+          $ref: "#/components/schemas/PortableAppearanceSemanticTokens"
       required:
         - themeId
         - colorModeDefault
@@ -7038,6 +7043,51 @@ components:
       minLength: 3
       pattern: ^(?:@[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?/[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?|[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?)@(?:\S+|\S+ \S+)$
       type: string
+    PortableAppearanceSemanticTokens:
+      additionalProperties: false
+      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."
+      properties:
+        accent:
+          additionalProperties: false
+          properties:
+            dark:
+              pattern: ^#[0-9a-f]{6}$
+              type: string
+            light:
+              pattern: ^#[0-9a-f]{6}$
+              type: string
+          required:
+            - light
+            - dark
+          type: object
+        canvas:
+          additionalProperties: false
+          properties:
+            dark:
+              pattern: ^#[0-9a-f]{6}$
+              type: string
+            light:
+              pattern: ^#[0-9a-f]{6}$
+              type: string
+          required:
+            - light
+            - dark
+          type: object
+        text:
+          additionalProperties: false
+          properties:
+            dark:
+              pattern: ^#[0-9a-f]{6}$
+              type: string
+            light:
+              pattern: ^#[0-9a-f]{6}$
+              type: string
+          required:
+            - light
+            - dark
+          type: object
+      required: []
+      type: object
     PortableAuthorPlainText:
       description: NFC Unicode text without disallowed C0/C1 controls or bidi override/isolate controls.
       format: gala-plain-text
@@ -12796,10 +12846,30 @@ components:
       properties:
         code:
           $ref: "#/components/schemas/PortableProblemProblemCode"
+        paths:
+          description: "SCHEMA-3.9.0, optional: the managed repository file paths the error is about, as the App lists them. Absent from older servers."
+          items:
+            maxLength: 512
+            minLength: 1
+            type: string
+          maxItems: 50
+          minItems: 0
+          type: array
         pointer:
           maxLength: 1024
           minLength: 1
           type: string
+        reason:
+          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."
+          enum:
+            - AUTHOR_EDITED
+            - BRANCH_PROTECTION
+            - REPOSITORY_ARCHIVED
+            - INSTALLATION_SUSPENDED
+            - WORKFLOWS_PERMISSION_MISSING
+            - AUTHORIZATION_LOST
+            - FORBIDDEN
+          type: string
       required:
         - pointer
         - code
@@ -15657,7 +15727,9 @@ components:
         `themePackage` is not in the catalog. `themePackage` is the file's
         `theme` value, a package with its version range. `attribution`
         (SCHEMA-3.3.0, optional) is the file's footer attribution switch;
-        absent means the file has none, which renders as shown.
+        absent means the file has none, which renders as shown. `tokens`
+        (SCHEMA-3.10.0, optional) is the file's publication palette as read;
+        absent or `{}` means the theme's own colours.
       properties:
         attribution:
           $ref: "#/components/schemas/PortableAppearanceAttribution"
@@ -15669,6 +15741,8 @@ components:
             - type: "null"
         themePackage:
           $ref: "#/components/schemas/PortableAppearancePackageRange"
+        tokens:
+          $ref: "#/components/schemas/PortableAppearanceSemanticTokens"
       required:
         - themeId
         - themePackage
@@ -17403,7 +17477,7 @@ components:
       type: object
     SiteAttentionItem:
       additionalProperties: false
-      description: "Something that needs a person to act. The list is empty when nothing does. SCHEMA-3.3.0: `SCHEDULED_PUBLISH_FAILED` means a scheduled publish could not start at its time; `relatedPublishId` names the schedule and `reasonCode` the first precondition that failed (a client maps the values it knows to a sentence and shows a generic one otherwise); nothing was merged. `DOMAIN_PUBLISH_REQUIRED` means a custom domain is live and the next publish moves the site's address to it. `DOMAIN_DEGRADED` means a live custom domain stopped working; `reasonCode` names why and the domain read carries the next step."
+      description: "Something that needs a person to act. The list is empty when nothing does. SCHEMA-3.3.0: `SCHEDULED_PUBLISH_FAILED` means a scheduled publish could not start at its time; `relatedPublishId` names the schedule and `reasonCode` the first precondition that failed (a client maps the values it knows to a sentence and shows a generic one otherwise); nothing was merged. `DOMAIN_PUBLISH_REQUIRED` means a custom domain is live and the next publish moves the site's address to it. `DOMAIN_DEGRADED` means a live custom domain stopped working; `reasonCode` names why and the domain read carries the next step. SCHEMA-3.9.0: on `REPOSITORY_NEEDS_UPDATE`, `reason` names the cause and `paths` the managed repository files involved, so a client can say what to do and list the files (both are absent from older servers and for other codes; show a generic sentence for a `reason` you do not know). `AUTHOR_EDITED`: a managed file differs from the version Galascribe manages and only the author may resolve it. `BRANCH_PROTECTION`: GitHub refused Galascribe's own repair 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. The same `reason` and `paths` ride on the `REPOSITORY_NEEDS_UPDATE` entry of a publish refusal's `errors`."
       properties:
         code:
           enum:
@@ -17422,6 +17496,26 @@ components:
             - DOMAIN_PUBLISH_REQUIRED
             - DOMAIN_DEGRADED
           type: string
+        paths:
+          description: SCHEMA-3.9.0. The managed repository files a `REPOSITORY_NEEDS_UPDATE` is about; may be empty when the cause is not about a file.
+          items:
+            maxLength: 512
+            minLength: 1
+            type: string
+          maxItems: 50
+          minItems: 0
+          type: array
+        reason:
+          description: SCHEMA-3.9.0. Why a `REPOSITORY_NEEDS_UPDATE` needs the author.
+          enum:
+            - AUTHOR_EDITED
+            - BRANCH_PROTECTION
+            - REPOSITORY_ARCHIVED
+            - INSTALLATION_SUSPENDED
+            - WORKFLOWS_PERMISSION_MISSING
+            - AUTHORIZATION_LOST
+            - FORBIDDEN
+          type: string
         reasonCode:
           maxLength: 80
           minLength: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "3.8.0",
+  "version": "3.10.0",
   "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
   "type": "module",
   "license": "Apache-2.0",
@@ -29,6 +29,10 @@
       "types": "./types/frozen-envelope.d.ts",
       "import": "./src/frozen-envelope.js"
     },
+    "./palette": {
+      "types": "./types/palette.d.ts",
+      "import": "./src/palette.js"
+    },
     "./schemas/adapter-capability.schema.json": "./schemas/adapter-capability.schema.json",
     "./schemas/appearance.schema.json": "./schemas/appearance.schema.json",
     "./schemas/artifact-manifest.schema.json": "./schemas/artifact-manifest.schema.json",
@@ -55,6 +59,9 @@
       "import": "./generated/typescript/index.js"
     },
     "./parity/digest-record-vectors.json": "./parity/digest-record-vectors.json",
+    "./palette/golden-vectors.json": "./parity/palette/golden-vectors.json",
+    "./palette/stress-corpus.json": "./parity/palette/stress-corpus.json",
+    "./palette/theme-default.fixture.json": "./parity/palette/theme-default.fixture.json",
     "./catalog-sources/internal-event-actions.json": "./catalog-sources/internal-event-actions.json",
     "./docs/catalogs/app-components.json": "./docs/catalogs/app-components.json",
     "./docs/catalogs/app-routes.json": "./docs/catalogs/app-routes.json",
@@ -85,6 +92,7 @@
     "docs/catalogs/app-routes.json",
     "docs/catalogs/app-components.json",
     "parity/digest-record-vectors.json",
+    "parity/palette/",
     "LICENSE",
     "NOTICE",
     "README.md",
@@ -142,6 +150,7 @@
     "app-catalogs:generate": "node scripts/generate-app-catalogs.mjs",
     "app-catalogs:check": "node scripts/generate-app-catalogs.mjs --check",
     "browser-safety:check": "node scripts/check-browser-safety.mjs",
+    "palette-vectors:generate": "node scripts/generate-palette-vectors.mjs",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint": "eslint .",