stylegallery 0.1.0

package/consumer-reference/schema/baseline-manifest.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/baseline-manifest.schema.json",
+  "title": "Proposed Chromium baseline manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "status", "baseline_owner_approval", "platform", "architecture", "container_image", "node", "os", "playwright", "browser_revision", "browser_version", "viewport", "source", "baseline", "calibration"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "status": { "const": "proposed" },
+    "baseline_owner_approval": { "const": "pending" },
+    "platform": { "const": "linux/amd64" },
+    "architecture": { "const": "amd64" },
+    "container_image": { "const": "mcr.microsoft.com/playwright:v1.61.0-noble@sha256:57b65fdc9ceabe0ef613124c7bbe2babcf9362c4d85e382fe3b03604e84b428a" },
+    "node": { "const": "22" },
+    "os": { "const": "Ubuntu 24.04" },
+    "playwright": { "const": "1.61.0" },
+    "browser_revision": { "const": "1228" },
+    "browser_version": { "const": "149.0.7827.55" },
+    "viewport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["width", "height"],
+      "properties": { "width": { "const": 1024 }, "height": { "const": 768 } }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": { "const": "tests/helpers/render-consumer-reference.mjs" },
+        "sha256": { "const": "88802a948909d5e40470be6b5481766ce2de498e59c053ac68af370b46e72ca9" }
+      }
+    },
+    "baseline": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": { "const": "tests/snapshots/consumer-reference-card-grid.png" },
+        "sha256": { "const": "5528358e957a6115793155e501f62716f7db31dc1c86856d9e1234868d672837" }
+      }
+    },
+    "calibration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["record", "required_runs", "workflow_artifact_name"],
+      "properties": {
+        "record": { "const": "consumer-reference/baselines/calibration.json" },
+        "required_runs": { "const": 20 },
+        "workflow_artifact_name": { "const": "chromium-sentinel-calibration-${run_id}-${sha}" }
+      }
+    }
+  }
+}

package/consumer-reference/schema/calibration-record.schema.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/calibration-record.schema.json",
+  "title": "Chromium sentinel calibration record",
+  "$comment": "This schema owns recursive shape and exact scalar identity. scripts/baseline-contract.mjs additionally enforces committed_ci tuple correlation and cross-run DOM/AX/hash equality.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "status", "baseline_owner_approval", "required_runs", "committed_ci", "environment", "reference", "runs"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "status": { "enum": ["awaiting_committed_ci", "awaiting_external_verification", "completed"] },
+    "baseline_owner_approval": { "const": "pending" },
+    "required_runs": { "const": 20 },
+    "committed_ci": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["artifact_name", "checkout_sha", "execution_repository", "external_verification", "head_sha", "raw_evidence_sha256", "repository", "run_attempt", "run_id", "sha", "workflow"],
+          "properties": {
+            "run_id": { "type": "string", "pattern": "^[0-9]+$" },
+            "run_attempt": { "type": "string", "pattern": "^[0-9]+$" },
+            "sha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+            "checkout_sha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+            "execution_repository": {
+              "description": "Actual GitHub Actions repository, limited to the canonical upstream or the explicit calibration fork.",
+              "enum": ["ark-jo/StyleGallery", "changeroa/StyleGallery"]
+            },
+            "external_verification": {
+              "oneOf": [
+                { "type": "null" },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["artifact", "repository_relationship", "source", "verified_at"],
+                  "properties": {
+                    "artifact": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": ["api_digest", "expires_at", "id", "name", "size_in_bytes"],
+                      "properties": {
+                        "api_digest": { "const": "sha256:3f11a517b447e1b5a1da17d9ee66ba2dd947fc8a0a482c447556ef00652e6074" },
+                        "expires_at": { "const": "2026-07-27T15:01:36Z" },
+                        "id": { "const": "8283099324" },
+                        "name": { "const": "chromium-sentinel-calibration-29260372260-18229be570766d3b42f5600955120bfcba690b76" },
+                        "size_in_bytes": { "const": 70310 }
+                      }
+                    },
+                    "repository_relationship": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": ["execution_is_fork", "parent", "source"],
+                      "properties": {
+                        "execution_is_fork": { "const": true },
+                        "parent": { "const": "changeroa/StyleGallery" },
+                        "source": { "const": "changeroa/StyleGallery" }
+                      }
+                    },
+                    "source": { "const": "https://github.com/ark-jo/StyleGallery/actions/runs/29260372260" },
+                    "verified_at": { "const": "2026-07-13T15:04:41Z" }
+                  }
+                }
+              ]
+            },
+            "head_sha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+            "raw_evidence_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+            "repository": {
+              "description": "Canonical upstream repository, independent of the GitHub Actions execution repository.",
+              "const": "changeroa/StyleGallery"
+            },
+            "workflow": { "const": ".github/workflows/validate.yml" },
+            "artifact_name": { "type": "string", "pattern": "^chromium-sentinel-calibration-[0-9]+-[0-9a-f]{40}$" }
+          }
+        }
+      ]
+    },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["platform", "architecture", "container_image", "node", "os", "playwright", "browser_revision", "browser_version", "viewport"],
+      "properties": {
+        "platform": { "const": "linux/amd64" },
+        "architecture": { "const": "amd64" },
+        "container_image": { "const": "mcr.microsoft.com/playwright:v1.61.0-noble@sha256:57b65fdc9ceabe0ef613124c7bbe2babcf9362c4d85e382fe3b03604e84b428a" },
+        "node": { "const": "22" },
+        "os": { "const": "Ubuntu 24.04" },
+        "playwright": { "const": "1.61.0" },
+        "browser_revision": { "const": "1228" },
+        "browser_version": { "const": "149.0.7827.55" },
+        "viewport": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["width", "height"],
+          "properties": { "width": { "const": 1024 }, "height": { "const": 768 } }
+        }
+      }
+    },
+    "reference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "baseline"],
+      "properties": {
+        "source": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "sha256"],
+          "properties": {
+            "path": { "const": "tests/helpers/render-consumer-reference.mjs" },
+            "sha256": { "const": "88802a948909d5e40470be6b5481766ce2de498e59c053ac68af370b46e72ca9" }
+          }
+        },
+        "baseline": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "sha256"],
+          "properties": {
+            "path": { "const": "tests/snapshots/consumer-reference-card-grid.png" },
+            "sha256": { "const": "5528358e957a6115793155e501f62716f7db31dc1c86856d9e1234868d672837" }
+          }
+        }
+      }
+    },
+    "runs": {
+      "type": "array",
+      "maxItems": 20,
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["run", "completed", "architecture", "png_sha256", "dom_sha256", "ax_sha256", "metadata_sha256", "screenshot_diff_pixels"],
+        "properties": {
+          "run": { "type": "integer", "minimum": 1, "maximum": 20 },
+          "completed": { "const": true },
+          "architecture": { "const": "amd64" },
+          "png_sha256": { "const": "5528358e957a6115793155e501f62716f7db31dc1c86856d9e1234868d672837" },
+          "dom_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "ax_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "metadata_sha256": { "const": "43a98d03b473e29c78ba2d359cf5f39346288d55564e5bfe65bc4a4fd78ebc2c" },
+          "screenshot_diff_pixels": { "const": 0 }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "awaiting_committed_ci" } } },
+      "then": { "properties": { "committed_ci": { "type": "null" }, "runs": { "maxItems": 0 } } },
+      "else": {
+        "properties": {
+          "committed_ci": { "type": "object" },
+          "runs": {
+            "minItems": 20,
+            "maxItems": 20,
+            "allOf": [
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 1 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 2 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 3 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 4 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 5 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 6 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 7 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 8 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 9 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 10 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 11 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 12 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 13 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 14 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 15 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 16 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 17 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 18 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 19 } } }, "minContains": 1, "maxContains": 1 },
+              { "contains": { "required": ["run"], "properties": { "run": { "const": 20 } } }, "minContains": 1, "maxContains": 1 }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "status": { "const": "completed" } } },
+      "then": { "properties": { "committed_ci": { "properties": { "external_verification": { "type": "object" } } } } },
+      "else": {
+        "if": { "properties": { "status": { "const": "awaiting_external_verification" } } },
+        "then": { "properties": { "committed_ci": { "properties": { "external_verification": { "type": "null" } } } } }
+      }
+    }
+  ]
+}

package/consumer-reference/schema/capture-session.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/capture-session.schema.json",
+  "title": "Component-state capture session",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "record_kind", "session_id", "nonce", "started_at", "repository", "revision", "branch", "attempt", "environment", "source", "intended"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "record_kind": { "const": "component_state_capture_session" },
+    "session_id": { "type": "string", "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$" },
+    "nonce": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "started_at": { "type": "string", "format": "date-time" },
+    "repository": { "type": "string", "minLength": 1 },
+    "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+    "branch": { "type": "string", "minLength": 1 },
+    "attempt": { "type": "integer", "minimum": 1 },
+    "environment": { "$ref": "#/$defs/environment" },
+    "source": { "$ref": "#/$defs/source_manifest" },
+    "intended": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["profile_name", "profile_id", "scenarios"],
+        "properties": {
+          "profile_name": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "profile_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "scenarios": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "channels"],
+              "properties": {
+                "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+                "channels": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["visual", "dom", "ax"] } }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "platform", "node", "browser", "browser_revision", "playwright", "lockfile_sha256", "container_image", "viewport"],
+      "properties": {
+        "kind": { "const": "browser" },
+        "platform": { "type": "string", "minLength": 1 },
+        "node": { "type": "string", "pattern": "^v\\d+\\.\\d+\\.\\d+$" },
+        "browser": { "type": "string", "minLength": 1 },
+        "browser_revision": { "type": "string", "minLength": 1 },
+        "playwright": { "type": "string", "minLength": 1 },
+        "lockfile_sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "container_image": { "type": "string", "minLength": 1 },
+        "viewport": { "type": "string", "pattern": "^\\d+x\\d+$" }
+      }
+    },
+    "session_link": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["session_id", "nonce", "receipt_sha256", "started_at", "revision", "branch", "attempt", "environment", "source"],
+      "properties": {
+        "session_id": { "type": "string", "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$" },
+        "nonce": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "receipt_sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "started_at": { "type": "string", "format": "date-time" },
+        "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "branch": { "type": "string", "minLength": 1 },
+        "attempt": { "type": "integer", "minimum": 1 },
+        "environment": { "$ref": "#/$defs/environment" },
+        "source": { "$ref": "#/$defs/source_manifest" }
+      }
+    },
+    "receipt_artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "byte_length", "media_type"],
+      "properties": {
+        "path": { "const": "capture-session.json" },
+        "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "byte_length": { "type": "integer", "minimum": 1 },
+        "media_type": { "const": "application/json" }
+      }
+    },
+    "completed_session": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["session_id", "nonce", "receipt_sha256", "receipt", "started_at", "completed_at", "repository", "revision", "branch", "attempt", "environment", "source", "intended"],
+      "properties": {
+        "session_id": { "type": "string", "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$" },
+        "nonce": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "receipt_sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "receipt": { "$ref": "#/$defs/receipt_artifact" },
+        "started_at": { "type": "string", "format": "date-time" },
+        "completed_at": { "type": "string", "format": "date-time" },
+        "repository": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "branch": { "type": "string", "minLength": 1 },
+        "attempt": { "type": "integer", "minimum": 1 },
+        "environment": { "$ref": "#/$defs/environment" },
+        "source": { "$ref": "#/$defs/source_manifest" },
+        "intended": { "$ref": "#/$defs/intended" }
+      }
+    },
+    "source_manifest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sha256", "files"],
+      "properties": {
+        "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "files": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "sha256", "byte_length"],
+            "properties": {
+              "path": { "type": "string", "pattern": "^(?:(?:consumer-reference|profiles|scripts|tests)/[^\\\\?#]+|package(?:-lock)?\\.json|playwright\\.config\\.mjs)$" },
+              "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+              "byte_length": { "type": "integer", "minimum": 1 }
+            }
+          }
+        }
+      }
+    },
+    "intended": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["profile_name", "profile_id", "scenarios"],
+        "properties": {
+          "profile_name": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "profile_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "scenarios": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "channels"],
+              "properties": {
+                "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+                "channels": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["visual", "dom", "ax"] } }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/consumer-reference/schema/component-state.schema.json

@@ -0,0 +1,150 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/component-state.schema.json",
+  "title": "Consumer component and compound-state records",
+  "oneOf": [
+    { "$ref": "#/$defs/component" },
+    { "$ref": "#/$defs/stateSet" }
+  ],
+  "$defs": {
+    "applicability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "status"],
+      "properties": {
+        "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" },
+        "status": { "enum": ["required", "conditional", "not_applicable", "prohibited"] },
+        "condition": { "type": "string", "minLength": 1 },
+        "resolution": { "enum": ["required", "not_applicable", "prohibited"] },
+        "reason": { "type": "string", "minLength": 10, "pattern": "^\\S+(?:\\s+\\S+){2,}\\s*[.!?]$" },
+        "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": ["string", "boolean"] } }
+      }
+    },
+    "component": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "record_kind", "component_id", "profile_id", "anatomy", "semantic_modes", "versions"],
+      "properties": {
+        "schema_version": { "const": "1.0" },
+        "record_kind": { "const": "component" },
+        "component_id": { "const": "button" },
+        "profile_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "anatomy": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" } },
+        "semantic_modes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "element", "role", "keys", "aria_states", "activation"],
+            "properties": {
+              "id": { "enum": ["action", "toggle", "disclosure", "switch"] },
+              "element": { "const": "button" },
+              "role": { "enum": ["button", "switch"] },
+              "keys": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["Enter", "Space"] } },
+              "aria_states": { "type": "array", "items": { "$ref": "#/$defs/applicability" } },
+              "activation": { "enum": ["invoke", "toggle", "control"] }
+            }
+          }
+        },
+        "versions": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["design_revision", "package_version", "api_version", "delivery_channel", "lifecycle"],
+          "properties": {
+            "design_revision": { "type": "string", "pattern": "^\\d{4}\\.\\d{2}\\.\\d{2}$" },
+            "package_version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-z0-9.-]+)?$" },
+            "api_version": { "type": "string", "pattern": "^\\d+\\.\\d+$" },
+            "delivery_channel": { "enum": ["preview", "stable"] },
+            "lifecycle": { "enum": ["experimental", "stable", "deprecated"] }
+          }
+        }
+      }
+    },
+    "stateSet": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "record_kind", "component_id", "profile_id", "visual_environments", "scenarios"],
+      "properties": {
+        "schema_version": { "const": "1.0" },
+        "record_kind": { "const": "state_set" },
+        "component_id": { "const": "button" },
+        "profile_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "visual_environments": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "browser", "browser_revision", "container_image", "platform", "playwright", "viewport"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+              "browser": { "type": "string", "minLength": 1 },
+              "browser_revision": { "type": "string", "minLength": 1 },
+              "container_image": { "type": "string", "minLength": 1 },
+              "platform": { "enum": ["darwin/arm64", "linux/amd64"] },
+              "playwright": { "const": "1.61.0" },
+              "viewport": { "const": "1024x768" }
+            }
+          }
+        },
+        "scenarios": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "semantic_mode", "states", "aria", "expected"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+              "semantic_mode": { "enum": ["action", "toggle", "disclosure", "switch"] },
+              "states": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["focus", "pressed", "expanded", "loading", "busy", "disabled", "invalid", "selected", "current", "reduced_motion"] } },
+              "aria": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "pressed": { "enum": ["true", "false"] },
+                  "expanded": { "enum": ["true", "false"] },
+                  "busy": { "enum": ["true", "false"] },
+                  "disabled": { "enum": ["true", "false"] },
+                  "checked": { "enum": ["true", "false"] }
+                }
+              },
+              "expected": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["visual", "visual_image", "dom", "ax", "activation"],
+                "properties": {
+                  "visual": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": { "enum": ["ready", "focus", "pressed", "expanded", "loading", "busy", "disabled"] }
+                  },
+                  "visual_image": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": ["environment_id", "sha256", "width", "height"],
+                      "properties": {
+                        "environment_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+                        "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+                        "width": { "type": "integer", "minimum": 44 },
+                        "height": { "type": "integer", "minimum": 44 }
+                      }
+                    }
+                  },
+                  "dom": { "type": "object", "additionalProperties": { "type": "string" } },
+                  "ax": { "type": "object", "additionalProperties": { "type": ["string", "boolean"] } },
+                  "activation": { "enum": ["allowed", "suppressed"] }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}