stylegallery 0.1.0

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

@@ -0,0 +1,365 @@
+{
+  "$defs": {
+    "adoptionMapping": {
+      "additionalProperties": false,
+      "properties": {
+        "consumer_target": { "$ref": "#/$defs/consumerTarget" },
+        "debt": {
+          "items": { "$ref": "#/$defs/debt" },
+          "type": "array"
+        },
+        "deviations": {
+          "items": { "$ref": "#/$defs/deviation" },
+          "type": "array"
+        },
+        "local_decision": { "$ref": "#/$defs/localDecision" },
+        "scenario_ids": { "$ref": "#/$defs/scenarioIds" },
+        "stylegallery": { "$ref": "#/$defs/stylegallerySource" }
+      },
+      "required": [
+        "consumer_target",
+        "debt",
+        "deviations",
+        "local_decision",
+        "scenario_ids",
+        "stylegallery"
+      ],
+      "type": "object"
+    },
+    "consumerTarget": {
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "identity": {
+              "pattern": "^[A-Z][A-Za-z0-9]*(?:[._/-][A-Za-z0-9_-]+)*$",
+              "type": "string"
+            },
+            "kind": { "const": "component" }
+          },
+          "required": ["identity", "kind"],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "identity": {
+              "pattern": "^(?:[.#][A-Za-z_][A-Za-z0-9_-]*|\\[[A-Za-z_:][-A-Za-z0-9_:.]*(?:=[^\\]\\r\\n]+)?\\])$",
+              "type": "string"
+            },
+            "kind": { "const": "selector" }
+          },
+          "required": ["identity", "kind"],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "identity": { "$ref": "#/$defs/repositoryPath" },
+            "kind": { "const": "module" }
+          },
+          "required": ["identity", "kind"],
+          "type": "object"
+        }
+      ]
+    },
+    "debt": {
+      "additionalProperties": false,
+      "properties": {
+        "owner": { "minLength": 1, "type": "string" },
+        "review_by": { "format": "date-time", "type": "string" },
+        "review_trigger": { "$ref": "#/$defs/sentence" },
+        "summary": { "$ref": "#/$defs/sentence" }
+      },
+      "required": ["owner", "review_by", "review_trigger", "summary"],
+      "type": "object"
+    },
+    "deviation": {
+      "additionalProperties": false,
+      "properties": {
+        "reason": { "$ref": "#/$defs/sentence" },
+        "summary": { "$ref": "#/$defs/sentence" }
+      },
+      "required": ["reason", "summary"],
+      "type": "object"
+    },
+    "dimension": {
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "scenario_ids": { "$ref": "#/$defs/scenarioIds" },
+            "status": { "const": "applicable" }
+          },
+          "required": ["scenario_ids", "status"],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "reason": { "$ref": "#/$defs/sentence" },
+            "status": { "const": "not_applicable" }
+          },
+          "required": ["reason", "status"],
+          "type": "object"
+        }
+      ]
+    },
+    "jsonPath": {
+      "pattern": "^(?!/)(?!.*//)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?![A-Za-z][A-Za-z0-9+.-]*:)(?!.*\\/$)[^\\\\?#]+\\.json$",
+      "type": "string"
+    },
+    "localDecision": {
+      "additionalProperties": false,
+      "properties": {
+        "decision": { "$ref": "#/$defs/sentence" },
+        "identity": {
+          "minLength": 1,
+          "pattern": "^\\S(?:.*\\S)?$",
+          "type": "string"
+        },
+        "kind": { "enum": ["token", "unit"] }
+      },
+      "required": ["decision", "identity", "kind"],
+      "type": "object"
+    },
+    "pageEvidence": {
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "manifest": { "$ref": "#/$defs/jsonPath" },
+            "status": { "const": "applicable" }
+          },
+          "required": ["manifest", "status"],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "reason": { "$ref": "#/$defs/sentence" },
+            "status": { "const": "not_applicable" }
+          },
+          "required": ["reason", "status"],
+          "type": "object"
+        }
+      ]
+    },
+    "repositoryPath": {
+      "pattern": "^(?!/)(?!.*//)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?![A-Za-z][A-Za-z0-9+.-]*:)(?!.*\\/$)[^\\\\?#]+$",
+      "type": "string"
+    },
+    "argv": {
+      "items": { "minLength": 1, "type": "string" },
+      "maxItems": 64,
+      "minItems": 1,
+      "type": "array"
+    },
+    "runtimeResult": {
+      "additionalProperties": false,
+      "properties": {
+        "argv": { "$ref": "#/$defs/argv" },
+        "evidence_method": { "enum": ["unit", "integration", "browser"] },
+        "exit_code": { "const": 0 },
+        "record_kind": { "const": "consumer_migration_scenario_result" },
+        "recorded_at": { "format": "date-time", "type": "string" },
+        "repository": { "minLength": 3, "pattern": "^\\S+/\\S+$", "type": "string" },
+        "revision": { "pattern": "^[a-f0-9]{40}$", "type": "string" },
+        "run_id": { "minLength": 1, "pattern": "^\\S+$", "type": "string" },
+        "scenario_id": { "$ref": "#/$defs/slug" },
+        "schema_version": { "const": "1.0" },
+        "session_id": { "minLength": 1, "pattern": "^\\S+$", "type": "string" },
+        "source_digest": { "$ref": "#/$defs/sha256" },
+        "status": { "const": "passed" }
+      },
+      "required": [
+        "argv",
+        "evidence_method",
+        "exit_code",
+        "record_kind",
+        "recorded_at",
+        "repository",
+        "revision",
+        "run_id",
+        "scenario_id",
+        "schema_version",
+        "session_id",
+        "source_digest",
+        "status"
+      ],
+      "type": "object"
+    },
+    "scenario": {
+      "additionalProperties": false,
+      "properties": {
+        "assertions": {
+          "items": { "minLength": 1, "type": "string" },
+          "minItems": 1,
+          "type": "array"
+        },
+        "argv": { "$ref": "#/$defs/argv" },
+        "evidence_method": { "enum": ["unit", "integration", "browser"] },
+        "exit_code": { "const": 0 },
+        "id": { "$ref": "#/$defs/slug" },
+        "observable_actions": {
+          "items": { "minLength": 1, "type": "string" },
+          "minItems": 1,
+          "type": "array"
+        },
+        "result_artifact": { "$ref": "#/$defs/jsonPath" },
+        "run_id": { "minLength": 1, "pattern": "^\\S+$", "type": "string" },
+        "session_id": { "minLength": 1, "pattern": "^\\S+$", "type": "string" },
+        "source_digest": { "$ref": "#/$defs/sha256" }
+      },
+      "required": [
+        "assertions",
+        "argv",
+        "evidence_method",
+        "exit_code",
+        "id",
+        "observable_actions",
+        "result_artifact",
+        "run_id",
+        "session_id",
+        "source_digest"
+      ],
+      "type": "object"
+    },
+    "scenarioIds": {
+      "items": { "$ref": "#/$defs/slug" },
+      "minItems": 1,
+      "type": "array",
+      "uniqueItems": true
+    },
+    "sentence": {
+      "minLength": 10,
+      "pattern": "^\\S+(?:\\s+\\S+){2,}\\s*[.!?]$",
+      "type": "string"
+    },
+    "sha256": {
+      "pattern": "^[a-f0-9]{64}$",
+      "type": "string"
+    },
+    "slug": {
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "type": "string"
+    },
+    "stylegallerySource": {
+      "additionalProperties": false,
+      "properties": {
+        "anchor": {
+          "pattern": "^#[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "type": "string"
+        },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "revision": {
+          "pattern": "^[a-f0-9]{40}$",
+          "type": "string"
+        }
+      },
+      "required": ["anchor", "path", "revision"],
+      "type": "object"
+    }
+  },
+  "$id": "https://stylegallery.example/consumer-reference/schema/consumer-conformance-record.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "adoption_mappings": {
+      "items": { "$ref": "#/$defs/adoptionMapping" },
+      "maxItems": 256,
+      "minItems": 1,
+      "type": "array"
+    },
+    "claim_boundary": {
+      "additionalProperties": false,
+      "properties": {
+        "certifies_accessibility": { "const": false },
+        "certifies_product_correctness": { "const": false },
+        "scope": { "$ref": "#/$defs/sentence" }
+      },
+      "required": ["certifies_accessibility", "certifies_product_correctness", "scope"],
+      "type": "object"
+    },
+    "consumer": {
+      "additionalProperties": false,
+      "properties": {
+        "relevant_sources": {
+          "items": { "$ref": "#/$defs/repositoryPath" },
+          "maxItems": 1024,
+          "minItems": 1,
+          "type": "array",
+          "uniqueItems": true
+        },
+        "repository": {
+          "minLength": 3,
+          "pattern": "^\\S+/\\S+$",
+          "type": "string"
+        },
+        "revision": {
+          "pattern": "^[a-f0-9]{40}$",
+          "type": "string"
+        }
+      },
+      "required": ["relevant_sources", "repository", "revision"],
+      "type": "object"
+    },
+    "id": { "$ref": "#/$defs/slug" },
+    "migration_dimensions": {
+      "additionalProperties": false,
+      "properties": {
+        "action_parity": { "$ref": "#/$defs/dimension" },
+        "atomic_batch_behavior": { "$ref": "#/$defs/dimension" },
+        "behavior_inventory": { "$ref": "#/$defs/dimension" },
+        "contract_precedence": { "$ref": "#/$defs/dimension" },
+        "defaults_tri_state_mapping": { "$ref": "#/$defs/dimension" },
+        "direct_mutation": { "$ref": "#/$defs/dimension" },
+        "exact_time_boundary": { "$ref": "#/$defs/dimension" },
+        "field_parity": { "$ref": "#/$defs/dimension" },
+        "indirect_mutation": { "$ref": "#/$defs/dimension" },
+        "persistence_round_trip": { "$ref": "#/$defs/dimension" },
+        "reset_boundary": { "$ref": "#/$defs/dimension" },
+        "route_parity": { "$ref": "#/$defs/dimension" },
+        "state_transitions": { "$ref": "#/$defs/dimension" }
+      },
+      "required": [
+        "action_parity",
+        "atomic_batch_behavior",
+        "behavior_inventory",
+        "contract_precedence",
+        "defaults_tri_state_mapping",
+        "direct_mutation",
+        "exact_time_boundary",
+        "field_parity",
+        "indirect_mutation",
+        "persistence_round_trip",
+        "reset_boundary",
+        "route_parity",
+        "state_transitions"
+      ],
+      "type": "object"
+    },
+    "page_evidence": { "$ref": "#/$defs/pageEvidence" },
+    "record_kind": { "const": "consumer_migration_conformance" },
+    "scenarios": {
+      "items": { "$ref": "#/$defs/scenario" },
+      "maxItems": 256,
+      "minItems": 1,
+      "type": "array"
+    },
+    "schema_version": { "const": "1.0" }
+  },
+  "required": [
+    "adoption_mappings",
+    "claim_boundary",
+    "consumer",
+    "id",
+    "migration_dimensions",
+    "page_evidence",
+    "record_kind",
+    "scenarios",
+    "schema_version"
+  ],
+  "title": "Consumer migration conformance record",
+  "type": "object"
+}

package/consumer-reference/schema/dom-evidence.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/dom-evidence.schema.json",
+  "title": "Closed DOM capture artifact",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "channel", "capture_session", "captured_at", "profile_id", "scenario_id", "semantic_mode", "role", "active", "activation_key", "activation_count", "attributes", "visual_states"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "channel": { "const": "dom" },
+    "capture_session": { "$ref": "https://stylegallery.local/consumer-reference/schema/capture-session.schema.json#/$defs/session_link" },
+    "captured_at": { "type": "string", "format": "date-time" },
+    "profile_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "scenario_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "semantic_mode": { "enum": ["action", "toggle", "disclosure", "switch"] },
+    "role": { "enum": ["button", "link", "switch"] },
+    "active": { "type": "boolean" },
+    "activation_key": { "enum": ["Enter", "Space"] },
+    "activation_count": { "type": "integer", "minimum": 0 },
+    "attributes": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "aria-busy": { "enum": ["true", "false"] },
+        "aria-disabled": { "enum": ["true", "false"] },
+        "aria-expanded": { "enum": ["true", "false"] },
+        "aria-pressed": { "enum": ["true", "false"] },
+        "disabled": { "enum": ["true", "false"] }
+      }
+    },
+    "visual_states": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "enum": ["ready", "focus", "pressed", "expanded", "loading", "busy", "disabled"] }
+    }
+  }
+}

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

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/evidence-record.schema.json",
+  "title": "Claim-scoped consumer component evidence",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "component_id", "profile_id", "claim_boundary", "passes"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "component_id": { "const": "button" },
+    "profile_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "claim_boundary": { "const": "Scenario artifacts are evidence, not visual regression baselines or accessibility certification." },
+    "passes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "scenario_id", "artifact", "recorded_at", "environment", "run", "session", "scope", "channel", "result"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "scenario_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "artifact": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "sha256", "byte_length", "media_type"],
+            "properties": {
+              "path": { "type": "string", "minLength": 1 },
+              "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+              "byte_length": { "type": "integer", "minimum": 1 },
+              "media_type": { "enum": ["image/png", "application/json"] },
+              "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"] }
+              }
+            ]
+          },
+          "recorded_at": { "type": "string", "format": "date-time" },
+          "environment": { "$ref": "https://stylegallery.local/consumer-reference/schema/capture-session.schema.json#/$defs/environment" },
+          "run": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "source", "repository", "revision", "attempt"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "source": { "enum": ["local", "github_actions"] },
+              "repository": { "type": "string", "minLength": 1 },
+              "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+              "attempt": { "type": "integer", "minimum": 1 }
+            }
+          },
+          "session": { "$ref": "https://stylegallery.local/consumer-reference/schema/capture-session.schema.json#/$defs/session_link" },
+          "scope": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["component", "semantic_mode", "state_set"],
+            "properties": {
+              "component": { "const": "button" },
+              "semantic_mode": { "enum": ["action", "toggle", "disclosure", "switch"] },
+              "state_set": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } }
+            }
+          },
+          "channel": { "enum": ["static", "browser", "visual", "dom", "ax", "human"] },
+          "result": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["status", "observed"],
+            "properties": {
+              "status": { "const": "passed" },
+              "observed": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/fixture-manifest.schema.json",
+  "title": "Consumer component runtime fixture manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "fixture_id", "component_id", "profile_id", "component_record", "state_record", "scenarios"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "fixture_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "component_id": { "const": "button" },
+    "profile_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "component_record": { "const": "../components/button.component.json" },
+    "state_record": { "const": "../states/button.states.json" },
+    "scenarios": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "semantic_mode", "label", "activation_key", "required_channels"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "semantic_mode": { "enum": ["action", "toggle", "disclosure", "switch"] },
+          "label": { "type": "string", "minLength": 1 },
+          "activation_key": { "enum": ["Enter", "Space"] },
+          "required_channels": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["static", "browser", "visual", "dom", "ax", "human"] } }
+        }
+      }
+    }
+  }
+}