@verndale/accessibility-standards 2.0.0 → 3.0.0

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

@@ -26,10 +26,10 @@
       ],
       "properties": {
         "_generated": { "type": "string" },
-        "package": { "type": "string" },
+        "package": { "const": "@verndale/accessibility-standards@3.0.0" },
         "profile": { "enum": ["conductor", "ai-orchestration"] },
-        "profile_version": { "type": "string" },
-        "schema_version": { "type": "integer" },
+        "profile_version": { "const": "3.0.0" },
+        "schema_version": { "const": 3 },
         "digests": {
           "type": "object",
           "required": ["source", "profile", "ui_design_brain_bindings", "config", "routes"],
@@ -50,8 +50,8 @@
       "required": ["_generated", "package", "schema_version", "source_digest", "profile_digests", "ui_design_brain", "profiles"],
       "properties": {
         "_generated": { "type": "string" },
-        "package": { "type": "string" },
-        "schema_version": { "type": "integer" },
+        "package": { "const": "@verndale/accessibility-standards@3.0.0" },
+        "schema_version": { "const": 3 },
         "source_digest": { "$ref": "#/$defs/digest" },
         "profile_digests": {
           "type": "object",
@@ -66,7 +66,7 @@
             "type": "object",
             "required": ["version", "profile_digest", "source_digest", "outputs"],
             "properties": {
-              "version": { "type": "string" },
+              "version": { "const": "3.0.0" },
               "profile_digest": { "$ref": "#/$defs/digest" },
               "source_digest": { "$ref": "#/$defs/digest" },
               "outputs": { "type": "object", "additionalProperties": { "$ref": "#/$defs/digest" } }

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/wcag-coverage.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "wcag-coverage.schema.json",
+  "$defs": {
+    "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"
+      ]
+    },
+    "criterion": {
+      "type": "object",
+      "required": ["id", "title", "level", "status", "semantic_ids"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "anyOf": [
+            { "$ref": "#/$defs/levelAIds" },
+            { "$ref": "#/$defs/levelAAIds" }
+          ]
+        },
+        "title": { "type": "string", "pattern": "\\S" },
+        "level": { "enum": ["A", "AA"] },
+        "status": { "enum": ["covered", "partial", "gap"] },
+        "semantic_ids": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^semantics\\.[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+          "uniqueItems": true
+        },
+        "note": { "type": "string", "pattern": "\\S" }
+      },
+      "allOf": [
+        {
+          "oneOf": [
+            { "properties": { "id": { "$ref": "#/$defs/levelAIds" }, "level": { "const": "A" } }, "required": ["id", "level"] },
+            { "properties": { "id": { "$ref": "#/$defs/levelAAIds" }, "level": { "const": "AA" } }, "required": ["id", "level"] }
+          ]
+        },
+        {
+          "if": { "properties": { "status": { "const": "gap" } }, "required": ["status"] },
+          "then": { "properties": { "semantic_ids": { "maxItems": 0 } } },
+          "else": { "properties": { "semantic_ids": { "minItems": 1 } } }
+        },
+        {
+          "if": { "properties": { "status": { "enum": ["partial", "gap"] } }, "required": ["status"] },
+          "then": { "required": ["note"] }
+        }
+      ]
+    }
+  },
+  "type": "object",
+  "required": ["version", "authority", "deferred_patterns", "criteria"],
+  "additionalProperties": false,
+  "properties": {
+    "version": { "const": 1 },
+    "authority": { "const": "wcag-2.2" },
+    "deferred_patterns": {
+      "type": "array",
+      "minItems": 5,
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "required": ["id", "reason"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "reason": { "type": "string", "pattern": "\\S" }
+        }
+      },
+      "allOf": [
+        { "contains": { "properties": { "id": { "const": "alert-dialog" } }, "required": ["id"] } },
+        { "contains": { "properties": { "id": { "const": "grid" } }, "required": ["id"] } },
+        { "contains": { "properties": { "id": { "const": "switch" } }, "required": ["id"] } },
+        { "contains": { "properties": { "id": { "const": "toolbar" } }, "required": ["id"] } },
+        { "contains": { "properties": { "id": { "const": "treegrid" } }, "required": ["id"] } }
+      ]
+    },
+    "criteria": {
+      "type": "array",
+      "minItems": 55,
+      "maxItems": 55,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/criterion" }
+    }
+  }
+}

package/src/applicability/facts.yml

@@ -16,14 +16,12 @@
     "component.selection_model": { "type": "string" },
     "interaction.has_motion_or_timing": { "type": "boolean" },
     "interaction.has_complex_pointer": { "type": "boolean" },
-    "interaction.has_character_shortcuts": { "type": "boolean" },
-    "content.uses_orientation_or_sensory_cues": { "type": "boolean" },
+    "interaction.has_dragging": { "type": "boolean" },
     "interaction.has_pointer_targets": { "type": "boolean" },
     "interaction.can_obscure_focus": { "type": "boolean" },
     "flow.has_authentication": { "type": "boolean" },
     "flow.repeats_entry": { "type": "boolean" },
-    "artifact.has_help": { "type": "boolean" },
-    "content.has_locale_or_bidi": { "type": "boolean" },
-    "component.has_data_table_or_grid": { "type": "boolean" }
+    "artifact.has_repeated_help_across_page_set": { "type": "boolean" },
+    "component.has_data_table": { "type": "boolean" }
   }
 }

package/src/applicability/matrix.yml

@@ -9,13 +9,11 @@
 {"id":"applicability.overlays","when":{"any":[{"contains":{"fact":"component.ui_pattern_ids","value":"modal"}},{"contains":{"fact":"component.ui_pattern_ids","value":"popover"}},{"contains":{"fact":"component.ui_pattern_ids","value":"tooltip"}}]},"outcomes":["semantics.keyboard.escape","semantics.focus.return"],"evidence":["e2e"]},
 {"id":"applicability.motion-timing","when":{"equals":{"fact":"interaction.has_motion_or_timing","value":true}},"outcomes":["semantics.motion-control"],"evidence":["e2e","human"]},
 {"id":"applicability.complex-pointer","when":{"equals":{"fact":"interaction.has_complex_pointer","value":true}},"outcomes":["semantics.keyboard"],"evidence":["e2e","human"]},
-{"id":"applicability.character-shortcuts","when":{"equals":{"fact":"interaction.has_character_shortcuts","value":true}},"outcomes":["semantics.keyboard"],"evidence":["unit","e2e"]},
-{"id":"applicability.orientation-sensory","when":{"equals":{"fact":"content.uses_orientation_or_sensory_cues","value":true}},"outcomes":["semantics.name-role-value"],"evidence":["human"]},
+{"id":"applicability.dragging-alternative","when":{"equals":{"fact":"interaction.has_dragging","value":true}},"outcomes":["semantics.dragging-alternative"],"evidence":["e2e","human"]},
 {"id":"applicability.target-size","when":{"equals":{"fact":"interaction.has_pointer_targets","value":true}},"outcomes":["semantics.target-size"],"evidence":["e2e","human"]},
 {"id":"applicability.focus-obstruction","when":{"equals":{"fact":"interaction.can_obscure_focus","value":true}},"outcomes":["semantics.focus.visible"],"evidence":["e2e","human"]},
-{"id":"applicability.authentication-captcha","when":{"equals":{"fact":"flow.has_authentication","value":true}},"outcomes":["semantics.form-label","semantics.form-error"],"evidence":["axe","e2e","human"]},
-{"id":"applicability.redundant-entry","when":{"equals":{"fact":"flow.repeats_entry","value":true}},"outcomes":["semantics.form-label"],"evidence":["e2e","human"]},
-{"id":"applicability.consistent-help","when":{"equals":{"fact":"artifact.has_help","value":true}},"outcomes":["semantics.landmarks"],"evidence":["human"]},
-{"id":"applicability.locale-bidi","when":{"equals":{"fact":"content.has_locale_or_bidi","value":true}},"outcomes":["semantics.native-elements"],"evidence":["unit","human"]},
-{"id":"applicability.data-table-grid","when":{"equals":{"fact":"component.has_data_table_or_grid","value":true}},"outcomes":["semantics.data-table"],"evidence":["axe","e2e","human"]}
+{"id":"applicability.accessible-authentication","when":{"equals":{"fact":"flow.has_authentication","value":true}},"outcomes":["semantics.accessible-authentication"],"evidence":["e2e","human"]},
+{"id":"applicability.redundant-entry","when":{"equals":{"fact":"flow.repeats_entry","value":true}},"outcomes":["semantics.form-label","semantics.redundant-entry"],"evidence":["e2e","human"]},
+{"id":"applicability.consistent-help","when":{"equals":{"fact":"artifact.has_repeated_help_across_page_set","value":true}},"outcomes":["semantics.consistent-help"],"evidence":["e2e","human"]},
+{"id":"applicability.data-table","when":{"equals":{"fact":"component.has_data_table","value":true}},"outcomes":["semantics.data-table"],"evidence":["axe","e2e","human"]}
 ]}

package/src/applicability/ui-design-brain-bindings.yml

@@ -36,18 +36,11 @@
     { "ui_pattern_id": "button-group", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.accessible-name", "semantics.focus.visible", "semantics.keyboard", "semantics.native-elements"] },
     { "ui_pattern_id": "card", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
     { "ui_pattern_id": "carousel", "classification": "direct", "pattern_ids": ["pattern.carousel"] },
-    { "ui_pattern_id": "checkbox", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    { "ui_pattern_id": "checkbox", "classification": "direct", "pattern_ids": ["pattern.checkbox", "pattern.field"] },
     { "ui_pattern_id": "color-picker", "classification": "direct", "pattern_ids": ["pattern.field"] },
     { "ui_pattern_id": "combobox", "classification": "direct", "pattern_ids": ["pattern.combobox", "pattern.field"] },
     { "ui_pattern_id": "comparison-table", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.data-table"] },
-    {
-      "ui_pattern_id": "context-menu",
-      "classification": "candidate",
-      "discriminator_facts": ["component.command_menu_trigger"],
-      "candidates": [
-        { "pattern_id": "pattern.menu-button", "when": { "equals": { "fact": "component.command_menu_trigger", "value": true } } }
-      ]
-    },
+    { "ui_pattern_id": "context-menu", "classification": "direct", "pattern_ids": ["pattern.menu"] },
     { "ui_pattern_id": "date-input", "classification": "direct", "pattern_ids": ["pattern.field"] },
     {
       "ui_pattern_id": "datepicker",
@@ -69,14 +62,7 @@
         { "pattern_id": "pattern.popover", "when": { "equals": { "fact": "component.overlay_model", "value": "non-modal" } } }
       ]
     },
-    {
-      "ui_pattern_id": "dropdown-menu",
-      "classification": "candidate",
-      "discriminator_facts": ["component.command_menu_trigger"],
-      "candidates": [
-        { "pattern_id": "pattern.menu-button", "when": { "equals": { "fact": "component.command_menu_trigger", "value": true } } }
-      ]
-    },
+    { "ui_pattern_id": "dropdown-menu", "classification": "direct", "pattern_ids": ["pattern.menu", "pattern.menu-button"] },
     {
       "ui_pattern_id": "empty-state",
       "classification": "candidate",
@@ -131,13 +117,13 @@
         { "pattern_id": "pattern.menu-button", "when": { "equals": { "fact": "component.command_menu_trigger", "value": true } } }
       ]
     },
-    { "ui_pattern_id": "number-input", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    { "ui_pattern_id": "number-input", "classification": "direct", "pattern_ids": ["pattern.field", "pattern.spinbutton"] },
     { "ui_pattern_id": "pagination", "classification": "direct", "pattern_ids": ["pattern.pagination"] },
     { "ui_pattern_id": "popover", "classification": "direct", "pattern_ids": ["pattern.popover"] },
     { "ui_pattern_id": "progress-bar", "classification": "direct", "pattern_ids": ["pattern.progress"] },
     { "ui_pattern_id": "progress-indicator", "classification": "direct", "pattern_ids": ["pattern.progress"] },
     { "ui_pattern_id": "quote", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
-    { "ui_pattern_id": "radio-button", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    { "ui_pattern_id": "radio-button", "classification": "direct", "pattern_ids": ["pattern.field", "pattern.radio-group"] },
     { "ui_pattern_id": "rating", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.name-role-value"] },
     { "ui_pattern_id": "rich-text", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.headings", "semantics.native-elements"] },
     { "ui_pattern_id": "rich-text-editor", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.accessible-name", "semantics.focus.visible", "semantics.keyboard", "semantics.name-role-value"] },
@@ -181,11 +167,11 @@
       ]
     },
     { "ui_pattern_id": "skip-link", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.accessible-name", "semantics.focus.visible", "semantics.keyboard", "semantics.native-elements"] },
-    { "ui_pattern_id": "slider", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    { "ui_pattern_id": "slider", "classification": "direct", "pattern_ids": ["pattern.field", "pattern.slider"] },
     { "ui_pattern_id": "spinner", "classification": "direct", "pattern_ids": ["pattern.progress"] },
     { "ui_pattern_id": "stack", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
     { "ui_pattern_id": "stat", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
-    { "ui_pattern_id": "stepper", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    { "ui_pattern_id": "stepper", "classification": "direct", "pattern_ids": ["pattern.field", "pattern.spinbutton"] },
     { "ui_pattern_id": "table", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.data-table"] },
     { "ui_pattern_id": "tabs", "classification": "direct", "pattern_ids": ["pattern.tabs"] },
     { "ui_pattern_id": "text-input", "classification": "direct", "pattern_ids": ["pattern.field"] },
@@ -201,7 +187,7 @@
     },
     { "ui_pattern_id": "toggle", "classification": "direct", "pattern_ids": ["pattern.field"] },
     { "ui_pattern_id": "tooltip", "classification": "direct", "pattern_ids": ["pattern.tooltip"] },
-    { "ui_pattern_id": "tree-view", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.accessible-name", "semantics.focus.visible", "semantics.keyboard", "semantics.roles-states-properties", "semantics.selected-state"] },
+    { "ui_pattern_id": "tree-view", "classification": "direct", "pattern_ids": ["pattern.tree-view"] },
     { "ui_pattern_id": "utility-bar", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.landmarks"] },
     { "ui_pattern_id": "video", "classification": "direct", "pattern_ids": ["pattern.media-player"] },
     { "ui_pattern_id": "visually-hidden", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },

package/src/contract.yml

@@ -1 +1 @@
-{"schema_version":2,"package_version":"2.0.0"}
+{"schema_version":3,"package_version":"3.0.0"}

package/src/coverage/wcag-2.2.yml

@@ -0,0 +1,68 @@
+{
+  "version": 1,
+  "authority": "wcag-2.2",
+  "deferred_patterns": [
+    {"id":"alert-dialog","reason":"Deferred until dialog purpose distinguishes urgent confirmation or attention from a general modal dialog."},
+    {"id":"grid","reason":"Deferred until a static-versus-interactive grid discriminator and keyboard interaction model are defined."},
+    {"id":"switch","reason":"Deferred until a binary toggle model distinguishes switch behavior from a generic form field."},
+    {"id":"toolbar","reason":"Deferred until control-group behavior and its focus-management model are defined."},
+    {"id":"treegrid","reason":"Deferred until static-versus-interactive grid selection and the hierarchical tree interaction model are defined."}
+  ],
+  "criteria": [
+    {"id":"1.1.1","title":"Non-text Content","level":"A","status":"partial","semantic_ids":["semantics.non-text-alternative"],"note":"Meaningful and decorative non-text content are covered, but dedicated obligations for controls and input, time-based media identification, tests, sensory experiences, and CAPTCHA alternatives are not all represented."},
+    {"id":"1.2.1","title":"Audio-only and Video-only (Prerecorded)","level":"A","status":"partial","semantic_ids":["semantics.media-alternatives"],"note":"The shared media rule does not distinguish every audio-only and video-only alternative."},
+    {"id":"1.2.2","title":"Captions (Prerecorded)","level":"A","status":"partial","semantic_ids":["semantics.media-alternatives"],"note":"Captions are required broadly, without a criterion-specific prerecorded contract."},
+    {"id":"1.2.3","title":"Audio Description or Media Alternative (Prerecorded)","level":"A","status":"partial","semantic_ids":["semantics.media-alternatives"],"note":"The shared media rule covers both alternatives but does not encode the criterion's conditional choice."},
+    {"id":"1.2.4","title":"Captions (Live)","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule requires live captions."},
+    {"id":"1.2.5","title":"Audio Description (Prerecorded)","level":"AA","status":"partial","semantic_ids":["semantics.media-alternatives"],"note":"Audio description is named, but prerecorded applicability is not represented independently."},
+    {"id":"1.3.1","title":"Info and Relationships","level":"A","status":"partial","semantic_ids":["semantics.data-table","semantics.form-label","semantics.form-required","semantics.headings","semantics.landmarks"],"note":"Several structural cases are covered, but the general criterion is broader than the current rules."},
+    {"id":"1.3.2","title":"Meaningful Sequence","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule explicitly preserves meaningful reading sequence."},
+    {"id":"1.3.3","title":"Sensory Characteristics","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule prevents instructions from relying only on sensory characteristics."},
+    {"id":"1.3.4","title":"Orientation","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule prevents unnecessary orientation restrictions."},
+    {"id":"1.3.5","title":"Identify Input Purpose","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule requires programmatic input-purpose tokens."},
+    {"id":"1.4.1","title":"Use of Color","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule prohibits color-only communication."},
+    {"id":"1.4.2","title":"Audio Control","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule requires independent control of automatically playing audio."},
+    {"id":"1.4.3","title":"Contrast (Minimum)","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule defines minimum text contrast."},
+    {"id":"1.4.4","title":"Resize Text","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule defines text resizing behavior."},
+    {"id":"1.4.5","title":"Images of Text","level":"AA","status":"gap","semantic_ids":[],"note":"Text alternatives do not replace a rule limiting images of text."},
+    {"id":"1.4.10","title":"Reflow","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule defines responsive reflow requirements."},
+    {"id":"1.4.11","title":"Non-text Contrast","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule defines contrast for controls, states, or graphical objects."},
+    {"id":"1.4.12","title":"Text Spacing","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule protects content under user-adjusted text spacing."},
+    {"id":"1.4.13","title":"Content on Hover or Focus","level":"AA","status":"gap","semantic_ids":[],"note":"Pattern behavior exists for tooltips, but no semantic rule covers dismissibility, hoverability, and persistence together."},
+    {"id":"2.1.1","title":"Keyboard","level":"A","status":"covered","semantic_ids":["semantics.keyboard"]},
+    {"id":"2.1.2","title":"No Keyboard Trap","level":"A","status":"covered","semantic_ids":["semantics.keyboard"]},
+    {"id":"2.1.4","title":"Character Key Shortcuts","level":"A","status":"gap","semantic_ids":[],"note":"Keyboard operability does not define shortcut remapping or deactivation."},
+    {"id":"2.2.1","title":"Timing Adjustable","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule encodes timing adjustment and its exceptions."},
+    {"id":"2.2.2","title":"Pause, Stop, Hide","level":"A","status":"covered","semantic_ids":["semantics.motion-control"]},
+    {"id":"2.3.1","title":"Three Flashes or Below Threshold","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule limits flashing content."},
+    {"id":"2.4.1","title":"Bypass Blocks","level":"A","status":"gap","semantic_ids":[],"note":"Landmarks alone do not establish a required bypass mechanism."},
+    {"id":"2.4.2","title":"Page Titled","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule requires descriptive page titles."},
+    {"id":"2.4.3","title":"Focus Order","level":"A","status":"gap","semantic_ids":[],"note":"Pattern focus lifecycles do not establish document-wide focus order."},
+    {"id":"2.4.4","title":"Link Purpose (In Context)","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule explicitly defines contextual link purpose."},
+    {"id":"2.4.5","title":"Multiple Ways","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule requires multiple ways to locate pages."},
+    {"id":"2.4.6","title":"Headings and Labels","level":"AA","status":"partial","semantic_ids":["semantics.headings"],"note":"Heading structure is covered, but a unified descriptive-purpose rule for all headings and labels is absent."},
+    {"id":"2.4.7","title":"Focus Visible","level":"AA","status":"covered","semantic_ids":["semantics.focus.visible"]},
+    {"id":"2.4.11","title":"Focus Not Obscured (Minimum)","level":"AA","status":"covered","semantic_ids":["semantics.focus.visible"]},
+    {"id":"2.5.1","title":"Pointer Gestures","level":"A","status":"gap","semantic_ids":[],"note":"Keyboard operation does not guarantee a single-pointer alternative to multipoint or path-based gestures."},
+    {"id":"2.5.2","title":"Pointer Cancellation","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule defines down-event cancellation behavior."},
+    {"id":"2.5.3","title":"Label in Name","level":"A","status":"covered","semantic_ids":["semantics.accessible-name"]},
+    {"id":"2.5.4","title":"Motion Actuation","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule addresses device or user motion actuation."},
+    {"id":"2.5.7","title":"Dragging Movements","level":"AA","status":"covered","semantic_ids":["semantics.dragging-alternative"]},
+    {"id":"2.5.8","title":"Target Size (Minimum)","level":"AA","status":"covered","semantic_ids":["semantics.target-size"]},
+    {"id":"3.1.1","title":"Language of Page","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule explicitly requires the default page language."},
+    {"id":"3.1.2","title":"Language of Parts","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule explicitly identifies changes in human language."},
+    {"id":"3.2.1","title":"On Focus","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule prohibits unexpected context changes on focus."},
+    {"id":"3.2.2","title":"On Input","level":"A","status":"gap","semantic_ids":[],"note":"No semantic rule prohibits unexpected context changes on input."},
+    {"id":"3.2.3","title":"Consistent Navigation","level":"AA","status":"gap","semantic_ids":[],"note":"Landmarks do not establish consistent repeated navigation order."},
+    {"id":"3.2.4","title":"Consistent Identification","level":"AA","status":"gap","semantic_ids":[],"note":"No semantic rule requires consistent identification of repeated components."},
+    {"id":"3.2.6","title":"Consistent Help","level":"A","status":"covered","semantic_ids":["semantics.consistent-help"]},
+    {"id":"3.3.1","title":"Error Identification","level":"A","status":"covered","semantic_ids":["semantics.form-error"]},
+    {"id":"3.3.2","title":"Labels or Instructions","level":"A","status":"partial","semantic_ids":["semantics.form-label","semantics.form-required"],"note":"Labels and requiredness are covered, but a dedicated rule for format and task-specific input instructions is absent."},
+    {"id":"3.3.3","title":"Error Suggestion","level":"AA","status":"covered","semantic_ids":["semantics.form-error"]},
+    {"id":"3.3.4","title":"Error Prevention (Legal, Financial, Data)","level":"AA","status":"covered","semantic_ids":["semantics.consequential-action"]},
+    {"id":"3.3.7","title":"Redundant Entry","level":"A","status":"covered","semantic_ids":["semantics.redundant-entry"]},
+    {"id":"3.3.8","title":"Accessible Authentication (Minimum)","level":"AA","status":"covered","semantic_ids":["semantics.accessible-authentication"]},
+    {"id":"4.1.2","title":"Name, Role, Value","level":"A","status":"covered","semantic_ids":["semantics.accessible-name","semantics.expanded-state","semantics.name-role-value","semantics.native-dialog","semantics.roles-states-properties","semantics.selected-state"]},
+    {"id":"4.1.3","title":"Status Messages","level":"AA","status":"covered","semantic_ids":["semantics.alert","semantics.live-status"]}
+  ]
+}

package/src/patterns/disclosure/accordion.yml

@@ -1 +1 @@
-{"id":"pattern.accordion","version":"1.0.0","title":"Accordion","kind":"pattern","requires":["semantics.native-elements","semantics.accessible-name","semantics.expanded-state","semantics.keyboard","semantics.focus.visible"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.accordion"}},"scope":"Grouped disclosure sections","behavior":["Toggle only the controlled panel","Preserve DOM and focus order"],"product_decisions":["single_or_multiple_open"],"functional_spec_bindings":["behavior","states","keyboard"],"implementation_outcomes":["accordion-control","accordion-panel"],"evidence_routes":["unit","axe","e2e","human"]}
+{"id":"pattern.accordion","version":"1.0.0","title":"Accordion","kind":"pattern","standards_refs":[{"authority":"aria-apg","identifier":"accordion","url":"https://www.w3.org/WAI/ARIA/apg/patterns/accordion/","normative":false}],"requires":["semantics.native-elements","semantics.accessible-name","semantics.expanded-state","semantics.keyboard","semantics.focus.visible"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.accordion"}},"scope":"Grouped disclosure sections","behavior":["Toggle only the controlled panel","Preserve DOM and focus order"],"product_decisions":["single_or_multiple_open"],"functional_spec_bindings":["behavior","states","keyboard"],"implementation_outcomes":["accordion-control","accordion-panel"],"evidence_routes":["unit","axe","e2e","human"]}

package/src/patterns/disclosure/disclosure.yml

@@ -1 +1 @@
-{"id":"pattern.disclosure","version":"1.0.0","title":"Disclosure","kind":"pattern","requires":["semantics.native-elements","semantics.accessible-name","semantics.expanded-state","semantics.keyboard"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.disclosure"}},"scope":"Show and hide supplementary content","behavior":["Control toggles one region"],"product_decisions":["initial_state"],"functional_spec_bindings":["behavior","states"],"implementation_outcomes":["disclosure-control"],"evidence_routes":["unit","axe","e2e"]}
+{"id":"pattern.disclosure","version":"1.0.0","title":"Disclosure","kind":"pattern","standards_refs":[{"authority":"aria-apg","identifier":"disclosure","url":"https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/","normative":false}],"requires":["semantics.native-elements","semantics.accessible-name","semantics.expanded-state","semantics.keyboard"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.disclosure"}},"scope":"Show and hide supplementary content","behavior":["Control toggles one region"],"product_decisions":["initial_state"],"functional_spec_bindings":["behavior","states"],"implementation_outcomes":["disclosure-control"],"evidence_routes":["unit","axe","e2e"]}