stylegallery 0.1.0

package/consumer-reference/schema/item.schema.json

@@ -0,0 +1,188 @@
+{
+  "$id": "https://stylegallery.example/consumer-reference/schema/item.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "maturity": { "const": "stable" },
+          "support": {
+            "properties": { "status": { "const": "ended" } },
+            "required": ["status"]
+          }
+        },
+        "required": ["maturity", "support"]
+      },
+      "then": false
+    },
+    {
+      "if": {
+        "properties": { "maturity": { "const": "deprecated" } },
+        "required": ["maturity"]
+      },
+      "then": { "required": ["removal_trigger", "replacement"] }
+    },
+    {
+      "if": { "required": ["profile_kind"] },
+      "then": {
+        "properties": {
+          "artifact_mode": { "const": "governed_local" },
+          "default": { "const": false },
+          "example_only": { "const": true },
+          "maturity": { "const": "experimental" },
+          "profile_kind": { "const": "governed_local" }
+        },
+        "required": [
+          "default",
+          "environment_assumptions",
+          "example_only",
+          "component_records",
+          "evidence_records",
+          "fixture_records",
+          "generated_records",
+          "layout_source_sha",
+          "local_foundations",
+          "profile_kind",
+          "related_fixture_set_id",
+          "selection",
+          "state_records",
+          "tokens"
+        ]
+      }
+    }
+  ],
+  "properties": {
+    "artifact_mode": {
+      "enum": ["consumer_local", "external_consumer", "governed_local", "schema_only"]
+    },
+    "component_records": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "const": "components/button.component.json" }
+    },
+    "default": { "const": false },
+    "environment_assumptions": {
+      "additionalProperties": false,
+      "properties": {
+        "reset": {
+          "additionalProperties": false,
+          "properties": {
+            "body_margin": { "minLength": 1, "type": "string" },
+            "box_sizing": { "minLength": 1, "type": "string" },
+            "figure_margin": { "minLength": 1, "type": "string" }
+          },
+          "required": ["body_margin", "box_sizing", "figure_margin"],
+          "type": "object"
+        },
+        "user_agent_styles": { "minLength": 1, "type": "string" }
+      },
+      "required": ["reset", "user_agent_styles"],
+      "type": "object"
+    },
+    "example_only": { "const": true },
+    "evidence_records": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "const": "evidence/button.evidence.json" }
+    },
+    "fixture_independence": { "const": "related" },
+    "fixture_records": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "const": "fixtures/button.fixture.json" }
+    },
+    "generated_records": {
+      "type": "array",
+      "minItems": 3,
+      "uniqueItems": true,
+      "items": { "enum": ["generated/state-matrix.md", "generated/keyboard-matrix.md", "generated/evidence-coverage.md"] }
+    },
+    "handoff": {
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "record": {
+              "pattern": "^(?!/)(?!.*//)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?![A-Za-z][A-Za-z0-9+.-]*:)[^\\\\?#]+\\.json$",
+              "type": "string"
+            },
+            "status": { "const": "declared" }
+          },
+          "required": ["record", "status"],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "reason": {
+              "minLength": 10,
+              "pattern": "^\\S+(?:\\s+\\S+){2,}\\s*[.!?]$",
+              "type": "string"
+            },
+            "status": { "const": "not_applicable" }
+          },
+          "required": ["reason", "status"],
+          "type": "object"
+        }
+      ]
+    },
+    "id": { "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" },
+    "layout_source_sha": { "const": "775430bbaf4ee208a642220f440f6926d79c90a3" },
+    "local_foundations": { "const": "local-foundations.json" },
+    "maturity": { "enum": ["deprecated", "experimental", "stable"] },
+    "owner": {
+      "additionalProperties": false,
+      "properties": {
+        "enforcement": { "const": "placeholder" },
+        "name": { "minLength": 1, "type": "string" }
+      },
+      "required": ["enforcement", "name"],
+      "type": "object"
+    },
+    "removal_trigger": { "minLength": 1, "type": "string" },
+    "profile_kind": { "const": "governed_local" },
+    "related_fixture_set_id": { "minLength": 1, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" },
+    "replacement": { "minLength": 1, "type": "string" },
+    "review_independence": { "const": "single_account" },
+    "schema_version": { "const": "1.0" },
+    "selection": {
+      "additionalProperties": false,
+      "properties": {
+        "method": { "const": "profile_path" },
+        "required": { "const": true }
+      },
+      "required": ["method", "required"],
+      "type": "object"
+    },
+    "support": {
+      "additionalProperties": false,
+      "properties": { "status": { "enum": ["active", "ended"] } },
+      "required": ["status"],
+      "type": "object"
+    },
+    "state_records": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "const": "states/button.states.json" }
+    },
+    "tokens": { "const": "tokens.dtcg.json" }
+  },
+  "required": [
+    "artifact_mode",
+    "fixture_independence",
+    "handoff",
+    "id",
+    "maturity",
+    "owner",
+    "review_independence",
+    "schema_version",
+    "support"
+  ],
+  "title": "Consumer reference item",
+  "type": "object"
+}

package/consumer-reference/schema/page-evidence-manifest.schema.json

@@ -0,0 +1,216 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/page-evidence-manifest.schema.json",
+  "title": "Closed consumer-local page evidence manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "record_kind", "claim_boundary", "completed_at", "review_by", "repository", "revision", "run", "session", "scenarios"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "record_kind": { "const": "page_evidence_manifest" },
+    "claim_boundary": { "const": "Page evidence is claim-scoped runtime evidence, not visual-regression approval or accessibility certification." },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "review_by": { "type": "string", "format": "date-time" },
+    "repository": { "type": "string", "minLength": 1 },
+    "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+    "run": { "$ref": "#/$defs/run" },
+    "session": { "$ref": "https://stylegallery.local/consumer-reference/schema/page-evidence-session.schema.json#/$defs/completed_session" },
+    "scenarios": {
+      "type": "array",
+      "maxItems": 256,
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/manifest_scenario" }
+    }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "identity": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$" },
+    "scenario_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "normalized_path": { "type": "string", "minLength": 1, "pattern": "^(?!/)(?![A-Za-z]:)(?!.*\\\\)(?!.*[?#]).+$" },
+    "run": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "source", "repository", "revision", "attempt", "status"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identity" },
+        "source": { "enum": ["local", "github_actions"] },
+        "repository": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "attempt": { "type": "integer", "minimum": 1 },
+        "status": { "const": "passed" }
+      }
+    },
+    "semantic_environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["browser", "browser_revision", "platform", "viewport", "page_scale_factor", "locale", "color_scheme", "reduced_motion"],
+      "properties": {
+        "browser": { "type": "string", "minLength": 1 },
+        "browser_revision": { "type": "string", "minLength": 1 },
+        "platform": { "type": "string", "minLength": 1 },
+        "viewport": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["width", "height"],
+          "properties": {
+            "width": { "type": "integer", "minimum": 1 },
+            "height": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "page_scale_factor": { "type": "number", "exclusiveMinimum": 0, "maximum": 10 },
+        "locale": { "type": "string", "minLength": 1 },
+        "color_scheme": { "enum": ["light", "dark", "no-preference"] },
+        "reduced_motion": { "enum": ["reduce", "no-preference"] }
+      }
+    },
+    "artifact_declaration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "media_type"],
+      "properties": {
+        "path": { "$ref": "#/$defs/normalized_path" },
+        "media_type": { "enum": ["application/json", "image/png", "text/plain"] }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "byte_length", "media_type"],
+      "properties": {
+        "path": { "$ref": "#/$defs/normalized_path" },
+        "sha256": { "$ref": "#/$defs/hash" },
+        "byte_length": { "type": "integer", "minimum": 1 },
+        "media_type": { "enum": ["application/json", "image/png", "text/plain"] },
+        "width": { "type": "integer", "minimum": 1 },
+        "height": { "type": "integer", "minimum": 1 }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "media_type": { "const": "image/png" } }, "required": ["media_type"] },
+          "then": {
+            "required": ["width", "height"],
+            "properties": {
+              "width": { "type": "integer", "minimum": 1 },
+              "height": { "type": "integer", "minimum": 1 }
+            }
+          }
+        }
+      ]
+    },
+    "reuse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "prior_manifest_sha256", "prior_session_id", "prior_run_id", "prior_scenario_id"],
+      "properties": {
+        "kind": { "const": "reused" },
+        "prior_manifest_sha256": { "$ref": "#/$defs/hash" },
+        "prior_session_id": { "$ref": "#/$defs/identity" },
+        "prior_run_id": { "$ref": "#/$defs/identity" },
+        "prior_scenario_id": { "$ref": "#/$defs/scenario_id" }
+      }
+    },
+    "runner_result": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "record_kind", "session_id", "nonce", "receipt_sha256", "repository", "revision", "source_sha256", "run", "scenario_id", "recorded_at", "semantic_environment", "status", "evidence"],
+      "properties": {
+        "schema_version": { "const": "1.0" },
+        "record_kind": { "const": "page_evidence_runner_result" },
+        "session_id": { "$ref": "#/$defs/identity" },
+        "nonce": { "$ref": "#/$defs/hash" },
+        "receipt_sha256": { "$ref": "#/$defs/hash" },
+        "repository": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "source_sha256": { "$ref": "#/$defs/hash" },
+        "run": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "source", "repository", "revision", "attempt"],
+          "properties": {
+            "id": { "$ref": "#/$defs/identity" },
+            "source": { "enum": ["local", "github_actions"] },
+            "repository": { "type": "string", "minLength": 1 },
+            "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+            "attempt": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "scenario_id": { "$ref": "#/$defs/scenario_id" },
+        "recorded_at": { "type": "string", "format": "date-time" },
+        "semantic_environment": { "$ref": "#/$defs/semantic_environment" },
+        "status": { "enum": ["passed", "failed"] },
+        "evidence": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["kind", "artifacts"],
+              "properties": {
+                "kind": { "const": "captured" },
+                "artifacts": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "#/$defs/artifact_declaration" } }
+              }
+            },
+            { "$ref": "#/$defs/reuse" },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["kind", "reason"],
+              "properties": {
+                "kind": { "const": "failed" },
+                "reason": { "type": "string", "minLength": 1 }
+              }
+            }
+          ]
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "status": { "const": "passed" } }, "required": ["status"] },
+          "then": {
+            "properties": {
+              "evidence": {
+                "type": "object",
+                "oneOf": [
+                  { "$ref": "#/$defs/reuse" },
+                  { "type": "object", "properties": { "kind": { "const": "captured" } }, "required": ["kind"] }
+                ]
+              }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "status": { "const": "failed" } }, "required": ["status"] },
+          "then": {
+            "properties": {
+              "evidence": { "type": "object", "properties": { "kind": { "const": "failed" } }, "required": ["kind"] }
+            }
+          }
+        }
+      ]
+    },
+    "manifest_scenario": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "recorded_at", "semantic_environment", "runner_result", "evidence"],
+      "properties": {
+        "id": { "$ref": "#/$defs/scenario_id" },
+        "recorded_at": { "type": "string", "format": "date-time" },
+        "semantic_environment": { "$ref": "#/$defs/semantic_environment" },
+        "runner_result": { "$ref": "#/$defs/artifact" },
+        "evidence": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["kind", "artifacts"],
+              "properties": {
+                "kind": { "const": "captured" },
+                "artifacts": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "#/$defs/artifact" } }
+              }
+            },
+            { "$ref": "#/$defs/reuse" }
+          ]
+        }
+      }
+    }
+  }
+}

package/consumer-reference/schema/page-evidence-session.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/page-evidence-session.schema.json",
+  "title": "Consumer-local page evidence start receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "record_kind", "session_id", "run_id", "nonce", "started_at", "repository", "revision", "branch", "attempt", "environment", "conformance_record", "source", "intended_scenario_ids"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "record_kind": { "const": "page_evidence_session" },
+    "session_id": { "$ref": "#/$defs/identity" },
+    "run_id": { "$ref": "#/$defs/identity" },
+    "nonce": { "$ref": "#/$defs/hash" },
+    "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/producer_environment" },
+    "conformance_record": { "$ref": "#/$defs/json_artifact" },
+    "source": { "$ref": "#/$defs/source_manifest" },
+    "intended_scenario_ids": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/scenario_id" }
+    }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "identity": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$" },
+    "scenario_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "normalized_path": { "type": "string", "minLength": 1, "pattern": "^(?!/)(?![A-Za-z]:)(?!.*\\\\)(?!.*[?#]).+$" },
+    "producer_environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "node", "platform", "producer"],
+      "properties": {
+        "kind": { "const": "browser_evidence" },
+        "node": { "type": "string", "pattern": "^v\\d+\\.\\d+\\.\\d+$" },
+        "platform": { "type": "string", "minLength": 1 },
+        "producer": { "const": "stylegallery_page_evidence" }
+      }
+    },
+    "file_artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "byte_length"],
+      "properties": {
+        "path": { "$ref": "#/$defs/normalized_path" },
+        "sha256": { "$ref": "#/$defs/hash" },
+        "byte_length": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "json_artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "byte_length", "media_type"],
+      "properties": {
+        "path": { "$ref": "#/$defs/normalized_path" },
+        "sha256": { "$ref": "#/$defs/hash" },
+        "byte_length": { "type": "integer", "minimum": 1 },
+        "media_type": { "const": "application/json" }
+      }
+    },
+    "source_manifest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sha256", "files"],
+      "properties": {
+        "sha256": { "$ref": "#/$defs/hash" },
+        "files": {
+          "type": "array",
+          "maxItems": 1024,
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/file_artifact" }
+        }
+      }
+    },
+    "receipt_artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "byte_length", "media_type"],
+      "properties": {
+        "path": { "const": "page-evidence-session.json" },
+        "sha256": { "$ref": "#/$defs/hash" },
+        "byte_length": { "type": "integer", "minimum": 1 },
+        "media_type": { "const": "application/json" }
+      }
+    },
+    "completed_session": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["session_id", "run_id", "nonce", "receipt_sha256", "receipt", "started_at", "completed_at", "repository", "revision", "branch", "attempt", "environment", "conformance_record", "source", "intended_scenario_ids"],
+      "properties": {
+        "session_id": { "$ref": "#/$defs/identity" },
+        "run_id": { "$ref": "#/$defs/identity" },
+        "nonce": { "$ref": "#/$defs/hash" },
+        "receipt_sha256": { "$ref": "#/$defs/hash" },
+        "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/producer_environment" },
+        "conformance_record": { "$ref": "#/$defs/json_artifact" },
+        "source": { "$ref": "#/$defs/source_manifest" },
+        "intended_scenario_ids": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/scenario_id" }
+        }
+      }
+    }
+  }
+}

package/consumer-reference/schema/portable-tokens.schema.json

@@ -0,0 +1,104 @@
+{
+  "$id": "https://stylegallery.example/consumer-reference/schema/portable-tokens.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$defs": {
+    "alias": {
+      "pattern": "^\\{[a-z0-9]+(?:[.-][a-z0-9]+)*\\}$",
+      "type": "string"
+    },
+    "border": {
+      "additionalProperties": false,
+      "properties": {
+        "color": {
+          "oneOf": [
+            { "$ref": "#/$defs/alias" },
+            { "$ref": "#/$defs/color" }
+          ]
+        },
+        "style": { "const": "solid" },
+        "width": {
+          "oneOf": [
+            { "$ref": "#/$defs/alias" },
+            { "$ref": "#/$defs/dimension" }
+          ]
+        }
+      },
+      "required": ["color", "style", "width"],
+      "type": "object"
+    },
+    "color": {
+      "additionalProperties": false,
+      "properties": {
+        "alpha": { "maximum": 1, "minimum": 0, "type": "number" },
+        "colorSpace": { "const": "srgb" },
+        "components": {
+          "items": { "maximum": 1, "minimum": 0, "type": "number" },
+          "maxItems": 3,
+          "minItems": 3,
+          "type": "array"
+        }
+      },
+      "required": ["colorSpace", "components"],
+      "type": "object"
+    },
+    "dimension": {
+      "additionalProperties": false,
+      "properties": {
+        "unit": { "enum": ["px", "rem"] },
+        "value": { "type": "number" }
+      },
+      "required": ["unit", "value"],
+      "type": "object"
+    },
+    "duration": {
+      "additionalProperties": false,
+      "properties": {
+        "unit": { "enum": ["ms", "s"] },
+        "value": { "minimum": 0, "type": "number" }
+      },
+      "required": ["unit", "value"],
+      "type": "object"
+    },
+    "group": {
+      "additionalProperties": false,
+      "patternProperties": {
+        "^(?!\\$)(?!(?:__proto__|prototype|constructor)$)[a-z0-9]+(?:-[a-z0-9]+)*$": { "$ref": "#/$defs/node" }
+      },
+      "properties": {
+        "$description": { "type": "string" },
+        "$type": { "enum": ["border", "color", "dimension", "duration"] }
+      },
+      "type": "object"
+    },
+    "node": {
+      "oneOf": [
+        { "$ref": "#/$defs/token" },
+        { "$ref": "#/$defs/group" }
+      ]
+    },
+    "token": {
+      "additionalProperties": false,
+      "properties": {
+        "$description": { "type": "string" },
+        "$type": { "enum": ["border", "color", "dimension", "duration"] },
+        "$value": {
+          "oneOf": [
+            { "$ref": "#/$defs/alias" },
+            { "$ref": "#/$defs/border" },
+            { "$ref": "#/$defs/color" },
+            { "$ref": "#/$defs/dimension" },
+            { "$ref": "#/$defs/duration" }
+          ]
+        }
+      },
+      "required": ["$value"],
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "patternProperties": {
+    "^(?!\\$)(?!(?:__proto__|prototype|constructor)$)[a-z0-9]+(?:-[a-z0-9]+)*$": { "$ref": "#/$defs/node" }
+  },
+  "title": "StyleGallery portable design tokens",
+  "type": "object"
+}