@rathnasgala2/schemas 3.9.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/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:9612379eda4997a04a0e3d0bcb4c3e7d68c5ba76688d4c733ab2b91520a914f7",
+  "openApiDigest": "sha256:6cb44277f117370a70e3828a1a5fdadbfbd1ddb5df3e84b317acf205d5913aeb",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -2121,5 +2121,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:e203c10513b422926292b5ed11f582de9ad4522fcdb824eed3fc332f639a819f"
+  "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
@@ -15677,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"
@@ -15689,6 +15741,8 @@ components:
             - type: "null"
         themePackage:
           $ref: "#/components/schemas/PortableAppearancePackageRange"
+        tokens:
+          $ref: "#/components/schemas/PortableAppearanceSemanticTokens"
       required:
         - themeId
         - themePackage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "3.9.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 .",