@verndale/accessibility-standards 1.0.0 → 3.0.0

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@verndale/accessibility-standards",
-  "version": "1.0.0",
+  "version": "3.0.0",
   "description": "Deterministic accessibility semantics, patterns, applicability, and consumer projections",
   "type": "module",
   "private": false,
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/verndale/accessibility-standards.git"
+  },
+  "packageManager": "pnpm@11.1.1",
   "engines": {
     "node": ">=24.14.0"
   },
@@ -21,26 +26,38 @@
     "README.md",
     "OPERATING.md"
   ],
+  "scripts": {
+    "build": "node bin/accessibility-standards.mjs build",
+    "check": "node bin/accessibility-standards.mjs validate",
+    "test": "node --test tests/unit/*.test.mjs && pnpm release:preflight:selftest",
+    "contract:version:check": "node scripts/check-package-contract.cjs",
+    "verify:ci": "pnpm contract:version:check && pnpm check && pnpm test && pnpm build && git diff --exit-code -- . ':!dist'",
+    "release:preflight": "node scripts/check-release-commit.cjs",
+    "release:preflight:selftest": "node scripts/check-release-commit.selftest.cjs",
+    "prepack": "node scripts/check-package-contract.cjs",
+    "graph:build": "node scripts/wiki/build-graph.cjs",
+    "graph:check": "node scripts/wiki/build-graph.cjs --check",
+    "wiki:check": "node scripts/wiki/check.cjs",
+    "prepare": "node scripts/install-hooks.mjs",
+    "pr:create": "ai-pr"
+  },
   "devDependencies": {
     "@semantic-release/changelog": "6.0.3",
+    "@semantic-release/commit-analyzer": "13.0.1",
     "@semantic-release/git": "10.0.1",
     "@semantic-release/github": "12.0.8",
     "@semantic-release/npm": "13.1.5",
     "@verndale/ai-commit": "2.7.0",
     "@verndale/ai-pr": "1.3.5",
+    "ajv": "8.20.0",
+    "conventional-changelog-conventionalcommits": "9.3.1",
     "semantic-release": "25.0.3"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "scripts": {
-    "build": "node bin/accessibility-standards.mjs build",
-    "check": "node bin/accessibility-standards.mjs validate",
-    "test": "node --test tests/unit/*.test.mjs",
-    "verify:ci": "pnpm check && pnpm test && pnpm build && git diff --exit-code -- . ':!dist'",
-    "graph:build": "node scripts/wiki/build-graph.cjs",
-    "graph:check": "node scripts/wiki/build-graph.cjs --check",
-    "wiki:check": "node scripts/wiki/check.cjs"
+  "dependencies": {
+    "dotenv": "^17.3.1"
   }
-}
+}

package/profiles/ai-orchestration/profile.json

@@ -1 +1 @@
-{"name":"ai-orchestration","version":"1.0.0","channels":["semantics","patterns","implementation","testing","review"]}
+{"name":"ai-orchestration","version":"3.0.0","channels":["ui-pattern-bindings","semantics","patterns","implementation","testing","review"]}

package/profiles/ai-orchestration/templates/patterns/README.md

@@ -1,3 +1,3 @@
 # Implementation patterns template
 
-Expand patterns to semantic dependencies and preserve source IDs.
+Expand patterns to semantic dependencies and preserve source IDs, activation, and informative APG references.

package/profiles/ai-orchestration/templates/review/README.md

@@ -1,3 +1,3 @@
 # Review template
 
-Review source authority, semantics, patterns, implementation, tests, and evidence in that order.
+Review source authority, WCAG coverage status, semantics, patterns, implementation, tests, and evidence in that order.

package/profiles/ai-orchestration/templates/semantics/README.md

@@ -1,3 +1,3 @@
 # Implementation semantics template
 
-Always load applicable semantic requirements before patterns.
+Always load applicable semantic requirements and their standards references before patterns.

package/profiles/ai-orchestration/templates/testing/README.md

@@ -1,3 +1,3 @@
 # Testing template
 
-Route each outcome to its exact unit, axe, E2E, and human lanes.
+Route each outcome and WCAG coverage claim to its exact unit, axe, E2E, and human lanes.

package/profiles/conductor/profile.json

@@ -1 +1 @@
-{"name":"conductor","version":"1.0.0","channels":["semantics","patterns","applicability","evidence"]}
+{"name":"conductor","version":"3.0.0","channels":["ui-pattern-bindings","semantics","patterns","applicability","evidence"]}

package/profiles/conductor/templates/evidence/README.md

@@ -1,3 +1,3 @@
 # Conductor evidence template
 
-Bind each applicable outcome to proof kinds and artifact evidence references.
+Bind each applicable outcome and WCAG coverage claim to proof kinds and artifact evidence references.

package/profiles/conductor/templates/patterns/README.md

@@ -1,3 +1,3 @@
 # Conductor patterns template
 
-Render activation, behavior, decisions, bindings, outcomes, and evidence without restating semantic rules.
+Render standards references, activation, behavior, decisions, bindings, outcomes, and evidence without restating semantic rules.

package/profiles/conductor/templates/semantics/README.md

@@ -1,3 +1,3 @@
 # Conductor semantics template
 
-Render requirements in stable semantic ID order for Functional Specification authors.
+Render requirements and normalized standards references in stable semantic ID order for Functional Specification authors.

package/schemas/consumer-config.schema.json

@@ -1 +1 @@
-{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"consumer-config.schema.json","type":"object","required":["package","profile","routes"],"properties":{"package":{"const":"@verndale/accessibility-standards@1.0.0"},"profile":{"enum":["conductor","ai-orchestration"]},"routes":{"type":"string"},"outputRoot":{"type":"string"}},"additionalProperties":false}
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"consumer-config.schema.json","type":"object","required":["package","profile","routes"],"properties":{"package":{"const":"@verndale/accessibility-standards@3.0.0"},"profile":{"enum":["conductor","ai-orchestration"]},"routes":{"type":"string"},"outputRoot":{"type":"string"}},"additionalProperties":false}

package/schemas/contract.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"contract.schema.json","type":"object","required":["schema_version","package_version"],"additionalProperties":false,"properties":{"schema_version":{"type":"integer","const":3},"package_version":{"type":"string","const":"3.0.0"}}}

package/schemas/manifest.schema.json

@@ -1 +1 @@
-{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"manifest.schema.json","type":"object","required":["package","schema_version","records"],"properties":{"package":{"type":"string"},"schema_version":{"type":"integer"},"records":{"type":"array","items":{"type":"object","required":["id","digest"]}}}}
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"manifest.schema.json","type":"object","required":["_generated","package","schema_version","source_digest","profile_digests","ui_design_brain","records"],"properties":{"_generated":{"type":"string"},"package":{"const":"@verndale/accessibility-standards@3.0.0"},"schema_version":{"const":3},"source_digest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"profile_digests":{"type":"object"},"ui_design_brain":{"type":"object","required":["package","package_version","catalog_authority_version","source_digest","manifest_digest","binding_digest"]},"records":{"type":"array","items":{"type":"object","required":["id","digest"]}}}}

package/schemas/pattern.schema.json

@@ -1 +1,98 @@
-{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"pattern.schema.json","allOf":[{"$ref":"record.schema.json"},{"type":"object","required":["kind","requires","activation","scope","behavior","product_decisions","functional_spec_bindings","implementation_outcomes","evidence_routes"],"properties":{"kind":{"const":"pattern"},"requires":{"type":"array","items":{"type":"string","pattern":"^semantics\\."},"minItems":1,"uniqueItems":true}}}]}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "pattern.schema.json",
+  "$defs": {
+    "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" },
+    "operand": {
+      "type": "object",
+      "required": ["fact", "value"],
+      "additionalProperties": false,
+      "properties": { "fact": { "$ref": "#/$defs/fact" }, "value": {} }
+    },
+    "existsOperand": {
+      "type": "object",
+      "required": ["fact"],
+      "additionalProperties": false,
+      "properties": { "fact": { "$ref": "#/$defs/fact" } }
+    },
+    "expression": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["all"],
+          "additionalProperties": false,
+          "properties": { "all": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/expression" } } }
+        },
+        {
+          "type": "object",
+          "required": ["any"],
+          "additionalProperties": false,
+          "properties": { "any": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/expression" } } }
+        },
+        {
+          "type": "object",
+          "required": ["not"],
+          "additionalProperties": false,
+          "properties": { "not": { "$ref": "#/$defs/expression" } }
+        },
+        {
+          "type": "object",
+          "required": ["equals"],
+          "additionalProperties": false,
+          "properties": { "equals": { "$ref": "#/$defs/operand" } }
+        },
+        {
+          "type": "object",
+          "required": ["contains"],
+          "additionalProperties": false,
+          "properties": { "contains": { "$ref": "#/$defs/operand" } }
+        },
+        {
+          "type": "object",
+          "required": ["exists"],
+          "additionalProperties": false,
+          "properties": { "exists": { "$ref": "#/$defs/existsOperand" } }
+        }
+      ]
+    },
+    "nonBlankStrings": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "\\S" },
+      "minItems": 1,
+      "uniqueItems": true
+    }
+  },
+  "type": "object",
+  "required": ["id", "version", "title", "kind", "standards_refs", "requires", "activation", "scope", "behavior", "product_decisions", "functional_spec_bindings", "implementation_outcomes", "evidence_routes"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "pattern": "^pattern\\.[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+    "title": { "type": "string", "pattern": "\\S" },
+    "kind": { "const": "pattern" },
+    "standards_refs": {
+      "type": "array",
+      "items": { "$ref": "standards-reference.schema.json" },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "requires": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^semantics\\.[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "activation": { "$ref": "#/$defs/expression" },
+    "scope": { "type": "string", "pattern": "\\S" },
+    "behavior": { "$ref": "#/$defs/nonBlankStrings" },
+    "product_decisions": { "$ref": "#/$defs/nonBlankStrings" },
+    "functional_spec_bindings": { "$ref": "#/$defs/nonBlankStrings" },
+    "implementation_outcomes": { "$ref": "#/$defs/nonBlankStrings" },
+    "evidence_routes": {
+      "type": "array",
+      "items": { "enum": ["unit", "axe", "e2e", "human"] },
+      "minItems": 1,
+      "uniqueItems": true
+    }
+  }
+}

package/schemas/profile.schema.json

@@ -1 +1 @@
-{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"profile.schema.json","type":"object","required":["name","version","channels"],"properties":{"name":{"enum":["conductor","ai-orchestration"]},"version":{"type":"string"},"channels":{"type":"array","items":{"type":"string"},"uniqueItems":true}},"additionalProperties":false}
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"profile.schema.json","type":"object","required":["name","version","channels"],"properties":{"name":{"enum":["conductor","ai-orchestration"]},"version":{"const":"3.0.0"},"channels":{"type":"array","items":{"type":"string"},"uniqueItems":true}},"additionalProperties":false}

package/schemas/projection-manifest.schema.json

@@ -1 +1,84 @@
-{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"projection-manifest.schema.json","type":"object","required":["package","profile","digests","projected_ids","lane_coverage"],"properties":{"package":{"type":"string"},"profile":{"type":"string"},"digests":{"type":"object"},"projected_ids":{"type":"array","items":{"type":"string"}},"lane_coverage":{"type":"object"}}}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "projection-manifest.schema.json",
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "uiDesignBrain": {
+      "type": "object",
+      "required": ["package", "package_version", "catalog_authority_version", "source_digest", "manifest_digest", "binding_digest"]
+    },
+    "consumer": {
+      "type": "object",
+      "required": [
+        "_generated",
+        "package",
+        "profile",
+        "profile_version",
+        "schema_version",
+        "digests",
+        "ui_design_brain",
+        "ui_pattern_ids",
+        "projected_ids",
+        "lane_coverage",
+        "output_paths",
+        "output_digests",
+        "manifest_digest"
+      ],
+      "properties": {
+        "_generated": { "type": "string" },
+        "package": { "const": "@verndale/accessibility-standards@3.0.0" },
+        "profile": { "enum": ["conductor", "ai-orchestration"] },
+        "profile_version": { "const": "3.0.0" },
+        "schema_version": { "const": 3 },
+        "digests": {
+          "type": "object",
+          "required": ["source", "profile", "ui_design_brain_bindings", "config", "routes"],
+          "additionalProperties": { "$ref": "#/$defs/digest" }
+        },
+        "ui_design_brain": { "$ref": "#/$defs/uiDesignBrain" },
+        "ui_pattern_ids": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "projected_ids": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "lane_coverage": { "type": "object" },
+        "output_paths": { "type": "object", "additionalProperties": { "type": "string" } },
+        "output_digests": { "type": "object", "additionalProperties": { "$ref": "#/$defs/digest" } },
+        "manifest_digest": { "$ref": "#/$defs/digest" }
+      },
+      "additionalProperties": true
+    },
+    "distribution": {
+      "type": "object",
+      "required": ["_generated", "package", "schema_version", "source_digest", "profile_digests", "ui_design_brain", "profiles"],
+      "properties": {
+        "_generated": { "type": "string" },
+        "package": { "const": "@verndale/accessibility-standards@3.0.0" },
+        "schema_version": { "const": 3 },
+        "source_digest": { "$ref": "#/$defs/digest" },
+        "profile_digests": {
+          "type": "object",
+          "required": ["conductor", "ai-orchestration"],
+          "additionalProperties": { "$ref": "#/$defs/digest" }
+        },
+        "ui_design_brain": { "$ref": "#/$defs/uiDesignBrain" },
+        "profiles": {
+          "type": "object",
+          "required": ["conductor", "ai-orchestration"],
+          "additionalProperties": {
+            "type": "object",
+            "required": ["version", "profile_digest", "source_digest", "outputs"],
+            "properties": {
+              "version": { "const": "3.0.0" },
+              "profile_digest": { "$ref": "#/$defs/digest" },
+              "source_digest": { "$ref": "#/$defs/digest" },
+              "outputs": { "type": "object", "additionalProperties": { "$ref": "#/$defs/digest" } }
+            }
+          }
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "oneOf": [
+    { "$ref": "#/$defs/consumer" },
+    { "$ref": "#/$defs/distribution" }
+  ]
+}

package/schemas/semantic.schema.json

@@ -1 +1,26 @@
-{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"semantic.schema.json","allOf":[{"$ref":"record.schema.json"},{"type":"object","required":["kind","requirement","proof"],"properties":{"kind":{"const":"semantic"},"requirement":{"type":"string"},"proof":{"type":"array","items":{"enum":["unit","axe","e2e","human"]},"minItems":1,"uniqueItems":true}}}]}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "semantic.schema.json",
+  "type": "object",
+  "required": ["id", "version", "title", "kind", "requirement", "proof", "standards_refs"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "pattern": "^semantics\\.[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+    "title": { "type": "string", "pattern": "\\S" },
+    "kind": { "const": "semantic" },
+    "requirement": { "type": "string", "pattern": "\\S" },
+    "proof": {
+      "type": "array",
+      "items": { "enum": ["unit", "axe", "e2e", "human"] },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "standards_refs": {
+      "type": "array",
+      "items": { "$ref": "standards-reference.schema.json" },
+      "minItems": 1,
+      "uniqueItems": true
+    }
+  }
+}

package/schemas/standards-reference.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "standards-reference.schema.json",
+  "$defs": {
+    "criterionId": {
+      "enum": [
+        "1.1.1", "1.2.1", "1.2.2", "1.2.3", "1.2.4", "1.2.5", "1.2.6", "1.2.7", "1.2.8", "1.2.9",
+        "1.3.1", "1.3.2", "1.3.3", "1.3.4", "1.3.5", "1.3.6",
+        "1.4.1", "1.4.2", "1.4.3", "1.4.4", "1.4.5", "1.4.6", "1.4.7", "1.4.8", "1.4.9", "1.4.10", "1.4.11", "1.4.12", "1.4.13",
+        "2.1.1", "2.1.2", "2.1.3", "2.1.4",
+        "2.2.1", "2.2.2", "2.2.3", "2.2.4", "2.2.5", "2.2.6",
+        "2.3.1", "2.3.2", "2.3.3",
+        "2.4.1", "2.4.2", "2.4.3", "2.4.4", "2.4.5", "2.4.6", "2.4.7", "2.4.8", "2.4.9", "2.4.10", "2.4.11", "2.4.12", "2.4.13",
+        "2.5.1", "2.5.2", "2.5.3", "2.5.4", "2.5.5", "2.5.6", "2.5.7", "2.5.8",
+        "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6",
+        "3.2.1", "3.2.2", "3.2.3", "3.2.4", "3.2.5", "3.2.6",
+        "3.3.1", "3.3.2", "3.3.3", "3.3.4", "3.3.5", "3.3.6", "3.3.7", "3.3.8", "3.3.9",
+        "4.1.2", "4.1.3"
+      ]
+    },
+    "levelAIds": {
+      "enum": [
+        "1.1.1", "1.2.1", "1.2.2", "1.2.3", "1.3.1", "1.3.2", "1.3.3", "1.4.1", "1.4.2",
+        "2.1.1", "2.1.2", "2.1.4", "2.2.1", "2.2.2", "2.3.1", "2.4.1", "2.4.2", "2.4.3", "2.4.4",
+        "2.5.1", "2.5.2", "2.5.3", "2.5.4", "3.1.1", "3.2.1", "3.2.2", "3.2.6", "3.3.1", "3.3.2", "3.3.7", "4.1.2"
+      ]
+    },
+    "levelAAIds": {
+      "enum": [
+        "1.2.4", "1.2.5", "1.3.4", "1.3.5", "1.4.3", "1.4.4", "1.4.5", "1.4.10", "1.4.11", "1.4.12", "1.4.13",
+        "2.4.5", "2.4.6", "2.4.7", "2.4.11", "2.5.7", "2.5.8", "3.1.2", "3.2.3", "3.2.4", "3.3.3", "3.3.4", "3.3.8", "4.1.3"
+      ]
+    },
+    "levelAAAIds": {
+      "enum": [
+        "1.2.6", "1.2.7", "1.2.8", "1.2.9", "1.3.6", "1.4.6", "1.4.7", "1.4.8", "1.4.9",
+        "2.1.3", "2.2.3", "2.2.4", "2.2.5", "2.2.6", "2.3.2", "2.3.3", "2.4.8", "2.4.9", "2.4.10", "2.4.12", "2.4.13", "2.5.5", "2.5.6",
+        "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.2.5", "3.3.5", "3.3.6", "3.3.9"
+      ]
+    },
+    "levelMatch": {
+      "oneOf": [
+        { "properties": { "identifier": { "$ref": "#/$defs/levelAIds" }, "level": { "const": "A" } }, "required": ["identifier", "level"] },
+        { "properties": { "identifier": { "$ref": "#/$defs/levelAAIds" }, "level": { "const": "AA" } }, "required": ["identifier", "level"] },
+        { "properties": { "identifier": { "$ref": "#/$defs/levelAAAIds" }, "level": { "const": "AAA" } }, "required": ["identifier", "level"] }
+      ]
+    },
+    "wcagUrl": {
+      "type": "string",
+      "pattern": "^https://www\\.w3\\.org/TR/WCAG22/#(?:non-text-content|audio-only-and-video-only-prerecorded|captions-prerecorded|audio-description-or-media-alternative-prerecorded|captions-live|audio-description-prerecorded|sign-language-prerecorded|extended-audio-description-prerecorded|media-alternative-prerecorded|audio-only-live|info-and-relationships|meaningful-sequence|sensory-characteristics|orientation|identify-input-purpose|identify-purpose|use-of-color|audio-control|contrast-minimum|resize-text|images-of-text|contrast-enhanced|low-or-no-background-audio|visual-presentation|images-of-text-no-exception|reflow|non-text-contrast|text-spacing|content-on-hover-or-focus|keyboard|no-keyboard-trap|keyboard-no-exception|character-key-shortcuts|timing-adjustable|pause-stop-hide|no-timing|interruptions|re-authenticating|timeouts|three-flashes-or-below-threshold|three-flashes|animation-from-interactions|bypass-blocks|page-titled|focus-order|link-purpose-in-context|multiple-ways|headings-and-labels|focus-visible|location|link-purpose-link-only|section-headings|focus-not-obscured-minimum|focus-not-obscured-enhanced|focus-appearance|pointer-gestures|pointer-cancellation|label-in-name|motion-actuation|target-size-enhanced|concurrent-input-mechanisms|dragging-movements|target-size-minimum|language-of-page|language-of-parts|unusual-words|abbreviations|reading-level|pronunciation|on-focus|on-input|consistent-navigation|consistent-identification|change-on-request|consistent-help|error-identification|labels-or-instructions|error-suggestion|error-prevention-legal-financial-data|help|error-prevention-all|redundant-entry|accessible-authentication-minimum|accessible-authentication-enhanced|name-role-value|status-messages)$"
+    },
+    "understandingUrl": {
+      "type": "string",
+      "pattern": "^https://www\\.w3\\.org/WAI/WCAG22/Understanding/(?:non-text-content|audio-only-and-video-only-prerecorded|captions-prerecorded|audio-description-or-media-alternative-prerecorded|captions-live|audio-description-prerecorded|sign-language-prerecorded|extended-audio-description-prerecorded|media-alternative-prerecorded|audio-only-live|info-and-relationships|meaningful-sequence|sensory-characteristics|orientation|identify-input-purpose|identify-purpose|use-of-color|audio-control|contrast-minimum|resize-text|images-of-text|contrast-enhanced|low-or-no-background-audio|visual-presentation|images-of-text-no-exception|reflow|non-text-contrast|text-spacing|content-on-hover-or-focus|keyboard|no-keyboard-trap|keyboard-no-exception|character-key-shortcuts|timing-adjustable|pause-stop-hide|no-timing|interruptions|re-authenticating|timeouts|three-flashes-or-below-threshold|three-flashes|animation-from-interactions|bypass-blocks|page-titled|focus-order|link-purpose-in-context|multiple-ways|headings-and-labels|focus-visible|location|link-purpose-link-only|section-headings|focus-not-obscured-minimum|focus-not-obscured-enhanced|focus-appearance|pointer-gestures|pointer-cancellation|label-in-name|motion-actuation|target-size-enhanced|concurrent-input-mechanisms|dragging-movements|target-size-minimum|language-of-page|language-of-parts|unusual-words|abbreviations|reading-level|pronunciation|on-focus|on-input|consistent-navigation|consistent-identification|change-on-request|consistent-help|error-identification|labels-or-instructions|error-suggestion|error-prevention-legal-financial-data|help|error-prevention-all|redundant-entry|accessible-authentication-minimum|accessible-authentication-enhanced|name-role-value|status-messages)\\.html$"
+    }
+  },
+  "type": "object",
+  "required": ["authority", "identifier", "url", "normative"],
+  "additionalProperties": false,
+  "properties": {
+    "authority": { "enum": ["wcag-2.2", "wcag-2.2-understanding", "wai-aria-1.2", "aria-apg"] },
+    "identifier": { "type": "string", "pattern": "\\S" },
+    "url": { "type": "string", "pattern": "^https://" },
+    "normative": { "type": "boolean" },
+    "level": { "enum": ["A", "AA", "AAA"] }
+  },
+  "oneOf": [
+    {
+      "properties": {
+        "authority": { "const": "wcag-2.2" },
+        "identifier": { "$ref": "#/$defs/criterionId" },
+        "url": { "$ref": "#/$defs/wcagUrl" },
+        "normative": { "const": true }
+      },
+      "required": ["level"],
+      "allOf": [{ "$ref": "#/$defs/levelMatch" }]
+    },
+    {
+      "properties": {
+        "authority": { "const": "wcag-2.2-understanding" },
+        "identifier": { "$ref": "#/$defs/criterionId" },
+        "url": { "$ref": "#/$defs/understandingUrl" },
+        "normative": { "const": false }
+      },
+      "required": ["level"],
+      "allOf": [{ "$ref": "#/$defs/levelMatch" }]
+    },
+    {
+      "properties": {
+        "authority": { "const": "wai-aria-1.2" },
+        "url": { "type": "string", "pattern": "^https://www\\.w3\\.org/TR/wai-aria-1\\.2/" },
+        "normative": { "const": true }
+      },
+      "not": { "required": ["level"] }
+    },
+    {
+      "properties": {
+        "authority": { "const": "aria-apg" },
+        "url": { "type": "string", "pattern": "^https://www\\.w3\\.org/WAI/ARIA/apg/" },
+        "normative": { "const": false }
+      },
+      "not": { "required": ["level"] }
+    }
+  ]
+}

package/schemas/ui-design-brain-bindings.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ui-design-brain-bindings.schema.json",
+  "type": "object",
+  "required": ["version", "source", "bindings"],
+  "additionalProperties": false,
+  "properties": {
+    "version": { "type": "integer", "const": 1 },
+    "source": {
+      "type": "object",
+      "required": ["package", "package_version", "catalog_authority_version", "repository", "manifest_path", "source_digest", "manifest_digest", "pattern_count", "tracking_issue"],
+      "additionalProperties": false,
+      "properties": {
+        "package": { "const": "@verndale/ui-design-brain" },
+        "package_version": { "const": "1.16.0" },
+        "catalog_authority_version": { "const": "1.15.1" },
+        "repository": { "const": "https://github.com/verndale/ui-design-brain" },
+        "manifest_path": { "const": "skills/ui-design-brain/catalog-manifest.json" },
+        "source_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "manifest_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "pattern_count": { "type": "integer", "minimum": 1 },
+        "tracking_issue": { "const": "https://github.com/verndale/ui-design-brain/issues/47" }
+      }
+    },
+    "bindings": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["ui_pattern_id", "classification"],
+        "additionalProperties": false,
+        "properties": {
+          "ui_pattern_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "classification": { "enum": ["direct", "candidate", "baseline-only"] },
+          "pattern_ids": {
+            "type": "array",
+            "items": { "type": "string", "pattern": "^pattern\\." },
+            "uniqueItems": true
+          },
+          "baseline_semantic_ids": {
+            "type": "array",
+            "items": { "type": "string", "pattern": "^semantics\\." },
+            "minItems": 1,
+            "uniqueItems": true
+          },
+          "discriminator_facts": {
+            "type": "array",
+            "items": { "type": "string" },
+            "minItems": 1,
+            "uniqueItems": true
+          },
+          "candidates": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": ["pattern_id", "when"],
+              "additionalProperties": false,
+              "properties": {
+                "pattern_id": { "type": "string", "pattern": "^pattern\\." },
+                "when": { "type": "object", "minProperties": 1, "maxProperties": 1 }
+              }
+            }
+          }
+        },
+        "allOf": [
+          {
+            "if": { "properties": { "classification": { "const": "direct" } } },
+            "then": { "required": ["pattern_ids"], "not": { "anyOf": [{ "required": ["candidates"] }, { "required": ["discriminator_facts"] }] } }
+          },
+          {
+            "if": { "properties": { "classification": { "const": "candidate" } } },
+            "then": { "required": ["discriminator_facts", "candidates"] }
+          },
+          {
+            "if": { "properties": { "classification": { "const": "baseline-only" } } },
+            "then": {
+              "required": ["baseline_semantic_ids"],
+              "not": { "anyOf": [{ "required": ["pattern_ids"] }, { "required": ["candidates"] }, { "required": ["discriminator_facts"] }] }
+            }
+          }
+        ]
+      }
+    }
+  }
+}