@verndale/accessibility-standards 1.0.0 → 3.0.0

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

@@ -1 +1,27 @@
-{"version":1,"facts":{"artifact.page_context":{"type":"boolean"},"content.has_non_text":{"type":"boolean"},"content.has_media":{"type":"boolean"},"component.has_form_fields":{"type":"boolean"},"component.submission_consequence":{"type":"array","items":"string"},"component.has_dynamic_status":{"type":"boolean"},"component.pattern":{"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_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"}}}
+{
+  "version": 1,
+  "facts": {
+    "artifact.page_context": { "type": "boolean" },
+    "content.has_non_text": { "type": "boolean" },
+    "content.has_media": { "type": "boolean" },
+    "component.ui_pattern_ids": { "type": "array", "items": "string", "source": "ui-design-brain" },
+    "component.accessibility_pattern_ids": { "type": "array", "items": "string", "derived": true },
+    "component.command_menu_trigger": { "type": "boolean" },
+    "component.has_form_fields": { "type": "boolean" },
+    "component.has_validation": { "type": "boolean" },
+    "component.submission_consequence": { "type": "array", "items": "string" },
+    "component.has_dynamic_status": { "type": "boolean" },
+    "component.message_urgency": { "type": "string" },
+    "component.overlay_model": { "type": "string" },
+    "component.selection_model": { "type": "string" },
+    "interaction.has_motion_or_timing": { "type": "boolean" },
+    "interaction.has_complex_pointer": { "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_repeated_help_across_page_set": { "type": "boolean" },
+    "component.has_data_table": { "type": "boolean" }
+  }
+}

package/src/applicability/matrix.yml

@@ -2,19 +2,18 @@
 {"id":"applicability.page-context","when":{"equals":{"fact":"artifact.page_context","value":true}},"outcomes":["semantics.headings","semantics.landmarks"],"evidence":["axe","human"]},
 {"id":"applicability.non-text-content","when":{"equals":{"fact":"content.has_non_text","value":true}},"outcomes":["pattern.image"],"evidence":["axe","human"]},
 {"id":"applicability.media","when":{"equals":{"fact":"content.has_media","value":true}},"outcomes":["pattern.media-player"],"evidence":["e2e","human"]},
-{"id":"applicability.forms","when":{"equals":{"fact":"component.has_form_fields","value":true}},"outcomes":["pattern.field","pattern.validation"],"evidence":["unit","axe","e2e"]},
+{"id":"applicability.forms","when":{"equals":{"fact":"component.has_form_fields","value":true}},"outcomes":["pattern.field"],"evidence":["unit","axe"]},
+{"id":"applicability.validation","when":{"equals":{"fact":"component.has_validation","value":true}},"outcomes":["pattern.validation"],"evidence":["unit","axe","e2e","human"]},
 {"id":"applicability.consequential-submission","when":{"contains":{"fact":"component.submission_consequence","value":"consequential"}},"outcomes":["pattern.consequential-submission"],"evidence":["e2e","human"]},
 {"id":"applicability.dynamic-status","when":{"equals":{"fact":"component.has_dynamic_status","value":true}},"outcomes":["pattern.dynamic-status"],"evidence":["unit","e2e","human"]},
-{"id":"applicability.overlays","when":{"contains":{"fact":"component.pattern","value":["dialog","popover","tooltip"]}},"outcomes":["semantics.keyboard.escape","semantics.focus.return"],"evidence":["e2e"]},
+{"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

@@ -0,0 +1,196 @@
+{
+  "version": 1,
+  "source": {
+    "package": "@verndale/ui-design-brain",
+    "package_version": "1.16.0",
+    "catalog_authority_version": "1.15.1",
+    "repository": "https://github.com/verndale/ui-design-brain",
+    "manifest_path": "skills/ui-design-brain/catalog-manifest.json",
+    "source_digest": "sha256:1eda596fe341786b5ada25742b6487bc06685fff17cbd582bc1b58302097e3ff",
+    "manifest_digest": "sha256:63a0bc8d9537d6d4c0aef8fd8a539bf4a9181a50d0761bd63eae6fe59b4eddc9",
+    "pattern_count": 80,
+    "tracking_issue": "https://github.com/verndale/ui-design-brain/issues/47"
+  },
+  "bindings": [
+    { "ui_pattern_id": "accordion", "classification": "direct", "pattern_ids": ["pattern.accordion"] },
+    {
+      "ui_pattern_id": "alert",
+      "classification": "candidate",
+      "discriminator_facts": ["component.has_dynamic_status", "component.message_urgency"],
+      "candidates": [
+        { "pattern_id": "pattern.alert", "when": { "equals": { "fact": "component.message_urgency", "value": "urgent" } } },
+        { "pattern_id": "pattern.dynamic-status", "when": { "equals": { "fact": "component.has_dynamic_status", "value": true } } }
+      ]
+    },
+    { "ui_pattern_id": "avatar", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.non-text-alternative"] },
+    {
+      "ui_pattern_id": "badge",
+      "classification": "candidate",
+      "discriminator_facts": ["component.has_dynamic_status"],
+      "candidates": [
+        { "pattern_id": "pattern.dynamic-status", "when": { "equals": { "fact": "component.has_dynamic_status", "value": true } } }
+      ]
+    },
+    { "ui_pattern_id": "breadcrumbs", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.landmarks", "semantics.native-elements"] },
+    { "ui_pattern_id": "button", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.accessible-name", "semantics.focus.visible", "semantics.keyboard", "semantics.name-role-value", "semantics.native-elements", "semantics.target-size"] },
+    { "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.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": "direct", "pattern_ids": ["pattern.menu"] },
+    { "ui_pattern_id": "date-input", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    {
+      "ui_pattern_id": "datepicker",
+      "classification": "candidate",
+      "pattern_ids": ["pattern.field"],
+      "discriminator_facts": ["component.overlay_model"],
+      "candidates": [
+        { "pattern_id": "pattern.dialog", "when": { "equals": { "fact": "component.overlay_model", "value": "modal" } } },
+        { "pattern_id": "pattern.popover", "when": { "equals": { "fact": "component.overlay_model", "value": "non-modal" } } }
+      ]
+    },
+    {
+      "ui_pattern_id": "drawer",
+      "classification": "candidate",
+      "discriminator_facts": ["component.overlay_model"],
+      "candidates": [
+        { "pattern_id": "pattern.dialog", "when": { "equals": { "fact": "component.overlay_model", "value": "modal" } } },
+        { "pattern_id": "pattern.disclosure", "when": { "equals": { "fact": "component.overlay_model", "value": "inline" } } },
+        { "pattern_id": "pattern.popover", "when": { "equals": { "fact": "component.overlay_model", "value": "non-modal" } } }
+      ]
+    },
+    { "ui_pattern_id": "dropdown-menu", "classification": "direct", "pattern_ids": ["pattern.menu", "pattern.menu-button"] },
+    {
+      "ui_pattern_id": "empty-state",
+      "classification": "candidate",
+      "discriminator_facts": ["component.has_dynamic_status"],
+      "candidates": [
+        { "pattern_id": "pattern.dynamic-status", "when": { "equals": { "fact": "component.has_dynamic_status", "value": true } } }
+      ]
+    },
+    { "ui_pattern_id": "error-message", "classification": "direct", "pattern_ids": ["pattern.validation"] },
+    { "ui_pattern_id": "eyebrow", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
+    { "ui_pattern_id": "fieldset", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    { "ui_pattern_id": "file", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
+    { "ui_pattern_id": "file-upload", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    {
+      "ui_pattern_id": "filter",
+      "classification": "candidate",
+      "discriminator_facts": ["component.has_form_fields"],
+      "candidates": [
+        { "pattern_id": "pattern.field", "when": { "equals": { "fact": "component.has_form_fields", "value": true } } }
+      ]
+    },
+    { "ui_pattern_id": "footer", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.landmarks"] },
+    { "ui_pattern_id": "form", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    { "ui_pattern_id": "header", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.landmarks"] },
+    { "ui_pattern_id": "heading", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.headings"] },
+    { "ui_pattern_id": "helper-text", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
+    { "ui_pattern_id": "hero", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.headings"] },
+    { "ui_pattern_id": "icon", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.non-text-alternative"] },
+    { "ui_pattern_id": "image", "classification": "direct", "pattern_ids": ["pattern.image"] },
+    { "ui_pattern_id": "in-page-navigation", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.accessible-name", "semantics.focus.visible", "semantics.keyboard", "semantics.landmarks", "semantics.native-elements"] },
+    { "ui_pattern_id": "label", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.form-label"] },
+    { "ui_pattern_id": "link", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.accessible-name", "semantics.focus.visible", "semantics.keyboard", "semantics.native-elements", "semantics.target-size"] },
+    { "ui_pattern_id": "list", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
+    { "ui_pattern_id": "logo-bar", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.non-text-alternative"] },
+    { "ui_pattern_id": "marquee", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.motion-control"] },
+    { "ui_pattern_id": "masthead", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.headings", "semantics.landmarks"] },
+    { "ui_pattern_id": "media-object", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.non-text-alternative"] },
+    {
+      "ui_pattern_id": "mega-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": "modal", "classification": "direct", "pattern_ids": ["pattern.dialog"] },
+    {
+      "ui_pattern_id": "navigation",
+      "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": "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", "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"] },
+    { "ui_pattern_id": "search-input", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    {
+      "ui_pattern_id": "search-overlay",
+      "classification": "candidate",
+      "discriminator_facts": ["component.overlay_model"],
+      "candidates": [
+        { "pattern_id": "pattern.dialog", "when": { "equals": { "fact": "component.overlay_model", "value": "modal" } } },
+        { "pattern_id": "pattern.popover", "when": { "equals": { "fact": "component.overlay_model", "value": "non-modal" } } }
+      ]
+    },
+    { "ui_pattern_id": "section-header", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.headings"] },
+    { "ui_pattern_id": "segmented-control", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.accessible-name", "semantics.focus.visible", "semantics.keyboard", "semantics.selected-state"] },
+    {
+      "ui_pattern_id": "select",
+      "classification": "candidate",
+      "pattern_ids": ["pattern.field"],
+      "discriminator_facts": ["component.selection_model"],
+      "candidates": [
+        { "pattern_id": "pattern.combobox", "when": { "equals": { "fact": "component.selection_model", "value": "combobox" } } },
+        { "pattern_id": "pattern.listbox", "when": { "equals": { "fact": "component.selection_model", "value": "listbox" } } }
+      ]
+    },
+    { "ui_pattern_id": "separator", "classification": "baseline-only", "baseline_semantic_ids": ["semantics.native-elements"] },
+    {
+      "ui_pattern_id": "sidebar",
+      "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": "skeleton",
+      "classification": "candidate",
+      "discriminator_facts": ["component.has_dynamic_status"],
+      "candidates": [
+        { "pattern_id": "pattern.dynamic-status", "when": { "equals": { "fact": "component.has_dynamic_status", "value": true } } }
+      ]
+    },
+    { "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", "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", "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"] },
+    { "ui_pattern_id": "textarea", "classification": "direct", "pattern_ids": ["pattern.field"] },
+    {
+      "ui_pattern_id": "toast",
+      "classification": "candidate",
+      "discriminator_facts": ["component.has_dynamic_status", "component.message_urgency"],
+      "candidates": [
+        { "pattern_id": "pattern.alert", "when": { "equals": { "fact": "component.message_urgency", "value": "urgent" } } },
+        { "pattern_id": "pattern.dynamic-status", "when": { "equals": { "fact": "component.has_dynamic_status", "value": true } } }
+      ]
+    },
+    { "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": "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"] },
+    { "ui_pattern_id": "wizard", "classification": "direct", "pattern_ids": ["pattern.field"] }
+  ]
+}

package/src/contract.yml

@@ -0,0 +1 @@
+{"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":{"fact":"component.pattern","equals":"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":{"fact":"component.pattern","equals":"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"]}

package/src/patterns/feedback/alert.yml

@@ -1 +1 @@
-{"id":"pattern.alert","version":"1.0.0","title":"Alert","kind":"pattern","requires":["semantics.alert"],"activation":{"fact":"component.pattern","equals":"alert"},"scope":"Urgent message","behavior":["Announce once without moving focus"],"product_decisions":["urgency"],"functional_spec_bindings":["messaging"],"implementation_outcomes":["alert-announcement"],"evidence_routes":["unit","human"]}
+{"id":"pattern.alert","version":"1.0.0","title":"Alert","kind":"pattern","standards_refs":[{"authority":"aria-apg","identifier":"alert","url":"https://www.w3.org/WAI/ARIA/apg/patterns/alert/","normative":false}],"requires":["semantics.alert"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.alert"}},"scope":"Urgent message","behavior":["Announce once without moving focus"],"product_decisions":["urgency"],"functional_spec_bindings":["messaging"],"implementation_outcomes":["alert-announcement"],"evidence_routes":["unit","human"]}

package/src/patterns/feedback/dynamic-status.yml

@@ -1 +1 @@
-{"id":"pattern.dynamic-status","version":"1.0.0","title":"Dynamic status","kind":"pattern","requires":["semantics.live-status"],"activation":{"fact":"component.has_dynamic_status","equals":true},"scope":"Asynchronous status message","behavior":["Announce meaningful changes once"],"product_decisions":["announcement_copy"],"functional_spec_bindings":["messaging","states"],"implementation_outcomes":["status-live-region"],"evidence_routes":["unit","e2e","human"]}
+{"id":"pattern.dynamic-status","version":"1.0.0","title":"Dynamic status","kind":"pattern","standards_refs":[{"authority":"wcag-2.2","identifier":"4.1.3","url":"https://www.w3.org/TR/WCAG22/#status-messages","normative":true,"level":"AA"}],"requires":["semantics.live-status"],"activation":{"equals":{"fact":"component.has_dynamic_status","value":true}},"scope":"Asynchronous status message","behavior":["Announce meaningful changes once"],"product_decisions":["announcement_copy"],"functional_spec_bindings":["messaging","states"],"implementation_outcomes":["status-live-region"],"evidence_routes":["unit","e2e","human"]}

package/src/patterns/feedback/progress.yml

@@ -1 +1 @@
-{"id":"pattern.progress","version":"1.0.0","title":"Progress","kind":"pattern","requires":["semantics.name-role-value","semantics.live-status"],"activation":{"fact":"component.pattern","equals":"progress"},"scope":"Determinate or indeterminate progress","behavior":["Expose value and completion changes without announcement noise"],"product_decisions":["determinate"],"functional_spec_bindings":["states","messaging"],"implementation_outcomes":["progress-value"],"evidence_routes":["unit","axe","human"]}
+{"id":"pattern.progress","version":"1.0.0","title":"Progress","kind":"pattern","standards_refs":[{"authority":"wai-aria-1.2","identifier":"progressbar","url":"https://www.w3.org/TR/wai-aria-1.2/#progressbar","normative":true},{"authority":"wcag-2.2","identifier":"4.1.2","url":"https://www.w3.org/TR/WCAG22/#name-role-value","normative":true,"level":"A"}],"requires":["semantics.name-role-value","semantics.live-status"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.progress"}},"scope":"Determinate or indeterminate progress","behavior":["Expose value and completion changes without announcement noise"],"product_decisions":["determinate"],"functional_spec_bindings":["states","messaging"],"implementation_outcomes":["progress-value"],"evidence_routes":["unit","axe","human"]}

package/src/patterns/forms/consequential-submission.yml

@@ -1 +1 @@
-{"id":"pattern.consequential-submission","version":"1.0.0","title":"Consequential submission","kind":"pattern","requires":["semantics.consequential-action","semantics.form-error","semantics.keyboard"],"activation":{"fact":"component.submission_consequence","contains":"consequential"},"scope":"Legal, financial, destructive, or irreversible submission","behavior":["Support review, correction, confirmation, or reversal"],"product_decisions":["safeguard","reversal_window"],"functional_spec_bindings":["submission","confirmation"],"implementation_outcomes":["submission-safeguard"],"evidence_routes":["e2e","human"]}
+{"id":"pattern.consequential-submission","version":"1.0.0","title":"Consequential submission","kind":"pattern","standards_refs":[{"authority":"wcag-2.2","identifier":"3.3.4","url":"https://www.w3.org/TR/WCAG22/#error-prevention-legal-financial-data","normative":true,"level":"AA"}],"requires":["semantics.consequential-action","semantics.form-error","semantics.keyboard"],"activation":{"contains":{"fact":"component.submission_consequence","value":"consequential"}},"scope":"Legal commitments, financial transactions, stored user-controllable data changes, or user test-response submissions","behavior":["Provide at least one declared safeguard: make the submission reversible; check user-entered data for errors and let the user correct them; or let the user review, confirm, and correct information before finalizing"],"product_decisions":["safeguard","reversal_window"],"functional_spec_bindings":["submission","confirmation"],"implementation_outcomes":["submission-safeguard"],"evidence_routes":["e2e","human"]}

package/src/patterns/forms/field.yml

@@ -1 +1 @@
-{"id":"pattern.field","version":"1.0.0","title":"Form field","kind":"pattern","requires":["semantics.form-label","semantics.form-required","semantics.focus.visible"],"activation":{"fact":"component.has_form_fields","equals":true},"scope":"Labeled form input","behavior":["Expose label, instructions, and requiredness before interaction"],"product_decisions":["required","instructions"],"functional_spec_bindings":["fields","requiredness"],"implementation_outcomes":["field-associations"],"evidence_routes":["unit","axe","human"]}
+{"id":"pattern.field","version":"1.0.0","title":"Form field","kind":"pattern","standards_refs":[{"authority":"wcag-2.2","identifier":"3.3.2","url":"https://www.w3.org/TR/WCAG22/#labels-or-instructions","normative":true,"level":"A"},{"authority":"wcag-2.2","identifier":"4.1.2","url":"https://www.w3.org/TR/WCAG22/#name-role-value","normative":true,"level":"A"}],"requires":["semantics.form-label","semantics.form-required","semantics.focus.visible"],"activation":{"any":[{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.field"}},{"equals":{"fact":"component.has_form_fields","value":true}}]},"scope":"Labeled form input","behavior":["Expose label, instructions, and requiredness before interaction"],"product_decisions":["required","instructions"],"functional_spec_bindings":["fields","requiredness"],"implementation_outcomes":["field-associations"],"evidence_routes":["unit","axe","human"]}

package/src/patterns/forms/spinbutton.yml

@@ -0,0 +1 @@
+{"id":"pattern.spinbutton","version":"1.0.0","title":"Spinbutton","kind":"pattern","standards_refs":[{"authority":"aria-apg","identifier":"spinbutton","url":"https://www.w3.org/WAI/ARIA/apg/patterns/spinbutton/","normative":false}],"requires":["semantics.accessible-name","semantics.focus.visible","semantics.form-label","semantics.keyboard","semantics.name-role-value","semantics.native-elements","semantics.roles-states-properties"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.spinbutton"}},"scope":"Value input constrained to a discrete set or range, with optional direct text editing","behavior":["Use a native number input when it supplies the required range, step, editing, labeling, and validation behavior; otherwise expose a named spinbutton with synchronized current, minimum, maximum, user-friendly value text, and invalid state when a value is outside the allowed range","Keep focus on the spinbutton while Up and Down change its value, Home and End apply known bounds, and optional Page Up and Page Down apply the declared larger step","Treat the editable decision as permission for direct text entry, not as whether the spinbutton is adjustable; when direct editing is disabled, the declared increment and decrement controls still change the value and the spinbutton is not exposed as read-only","When direct editing is allowed, preserve platform text editing commands and do not intercept keys needed to enter, navigate, select, or modify text"],"product_decisions":["editable","large_step","native_or_custom","range_bounds","step","value_text"],"functional_spec_bindings":["fields","states","keyboard","validation"],"implementation_outcomes":["spinbutton-keyboard-model","spinbutton-native-control-selection","spinbutton-range-state","spinbutton-validation"],"evidence_routes":["unit","axe","e2e","human"]}

package/src/patterns/forms/validation.yml

@@ -1 +1 @@
-{"id":"pattern.validation","version":"1.0.0","title":"Form validation","kind":"pattern","requires":["semantics.form-error","semantics.live-status","semantics.focus.initial"],"activation":{"fact":"component.has_validation","equals":true},"scope":"Client or server validation","behavior":["Identify, associate, summarize, and focus errors deterministically"],"product_decisions":["validation_timing","error_summary"],"functional_spec_bindings":["validation","messaging","focus"],"implementation_outcomes":["validation-associations","error-summary"],"evidence_routes":["unit","axe","e2e","human"]}
+{"id":"pattern.validation","version":"1.0.0","title":"Form validation","kind":"pattern","standards_refs":[{"authority":"wcag-2.2","identifier":"3.3.1","url":"https://www.w3.org/TR/WCAG22/#error-identification","normative":true,"level":"A"},{"authority":"wcag-2.2","identifier":"3.3.3","url":"https://www.w3.org/TR/WCAG22/#error-suggestion","normative":true,"level":"AA"}],"requires":["semantics.form-error","semantics.live-status","semantics.focus.initial"],"activation":{"any":[{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.validation"}},{"equals":{"fact":"component.has_validation","value":true}}]},"scope":"Client or server validation","behavior":["Identify, associate, summarize, and focus errors deterministically"],"product_decisions":["validation_timing","error_summary"],"functional_spec_bindings":["validation","messaging","focus"],"implementation_outcomes":["validation-associations","error-summary"],"evidence_routes":["unit","axe","e2e","human"]}

package/src/patterns/media/carousel.yml

@@ -1 +1 @@
-{"id":"pattern.carousel","version":"1.0.0","title":"Carousel","kind":"pattern","requires":["semantics.accessible-name","semantics.keyboard","semantics.focus.visible","semantics.motion-control","semantics.live-status"],"activation":{"fact":"component.pattern","equals":"carousel"},"scope":"Rotating content set","behavior":["Pause rotation on interaction","Provide named controls and current position"],"product_decisions":["auto_rotation","looping"],"functional_spec_bindings":["behavior","states","controls"],"implementation_outcomes":["carousel-controls","carousel-rotation"],"evidence_routes":["unit","axe","e2e","human"]}
+{"id":"pattern.carousel","version":"1.0.0","title":"Carousel","kind":"pattern","standards_refs":[{"authority":"aria-apg","identifier":"carousel","url":"https://www.w3.org/WAI/ARIA/apg/patterns/carousel/","normative":false}],"requires":["semantics.accessible-name","semantics.keyboard","semantics.focus.visible","semantics.motion-control","semantics.live-status"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.carousel"}},"scope":"Rotating content set","behavior":["Pause rotation on interaction","Provide named controls and current position"],"product_decisions":["auto_rotation","looping"],"functional_spec_bindings":["behavior","states","controls"],"implementation_outcomes":["carousel-controls","carousel-rotation"],"evidence_routes":["unit","axe","e2e","human"]}

package/src/patterns/media/image.yml

@@ -1 +1 @@
-{"id":"pattern.image","version":"1.0.0","title":"Image","kind":"pattern","requires":["semantics.non-text-alternative"],"activation":{"fact":"content.has_non_text","equals":true},"scope":"Informative, functional, complex, or decorative image","behavior":["Alternative follows image purpose"],"product_decisions":["purpose","long_description"],"functional_spec_bindings":["content"],"implementation_outcomes":["image-alternative"],"evidence_routes":["axe","human"]}
+{"id":"pattern.image","version":"1.0.0","title":"Image","kind":"pattern","standards_refs":[{"authority":"wcag-2.2","identifier":"1.1.1","url":"https://www.w3.org/TR/WCAG22/#non-text-content","normative":true,"level":"A"}],"requires":["semantics.non-text-alternative"],"activation":{"any":[{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.image"}},{"equals":{"fact":"content.has_non_text","value":true}}]},"scope":"Informative, functional, complex, or decorative image","behavior":["Alternative follows image purpose"],"product_decisions":["purpose","long_description"],"functional_spec_bindings":["content"],"implementation_outcomes":["image-alternative"],"evidence_routes":["axe","human"]}

package/src/patterns/media/media-player.yml

@@ -1 +1 @@
-{"id":"pattern.media-player","version":"1.0.0","title":"Media player","kind":"pattern","requires":["semantics.media-alternatives","semantics.accessible-name","semantics.keyboard","semantics.focus.visible","semantics.motion-control"],"activation":{"fact":"content.has_media","equals":true},"scope":"Audio or video playback","behavior":["Provide keyboard-operable named controls and required alternatives"],"product_decisions":["captions","transcript","audio_description","autoplay"],"functional_spec_bindings":["content","controls","behavior"],"implementation_outcomes":["media-alternatives","media-controls"],"evidence_routes":["axe","e2e","human"]}
+{"id":"pattern.media-player","version":"1.0.0","title":"Media player","kind":"pattern","standards_refs":[{"authority":"wcag-2.2","identifier":"1.2.1","url":"https://www.w3.org/TR/WCAG22/#audio-only-and-video-only-prerecorded","normative":true,"level":"A"},{"authority":"wcag-2.2","identifier":"1.2.2","url":"https://www.w3.org/TR/WCAG22/#captions-prerecorded","normative":true,"level":"A"},{"authority":"wcag-2.2","identifier":"1.2.3","url":"https://www.w3.org/TR/WCAG22/#audio-description-or-media-alternative-prerecorded","normative":true,"level":"A"},{"authority":"wcag-2.2","identifier":"1.2.5","url":"https://www.w3.org/TR/WCAG22/#audio-description-prerecorded","normative":true,"level":"AA"}],"requires":["semantics.media-alternatives","semantics.accessible-name","semantics.keyboard","semantics.focus.visible","semantics.motion-control"],"activation":{"any":[{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.media-player"}},{"equals":{"fact":"content.has_media","value":true}}]},"scope":"Audio or video playback","behavior":["Provide keyboard-operable named controls and required alternatives"],"product_decisions":["captions","transcript","audio_description","autoplay"],"functional_spec_bindings":["content","controls","behavior"],"implementation_outcomes":["media-alternatives","media-controls"],"evidence_routes":["axe","e2e","human"]}

package/src/patterns/navigation/menu-button.yml

@@ -1 +1 @@
-{"id":"pattern.menu-button","version":"1.0.0","title":"Menu button","kind":"pattern","requires":["semantics.accessible-name","semantics.expanded-state","semantics.keyboard","semantics.focus.initial","semantics.focus.return"],"activation":{"fact":"component.pattern","equals":"menu-button"},"scope":"Button opening a command menu","behavior":["Open and navigate menu by keyboard"],"product_decisions":["focus_strategy"],"functional_spec_bindings":["behavior","keyboard","focus"],"implementation_outcomes":["menu-button-keyboard"],"evidence_routes":["unit","e2e","human"]}
+{"id":"pattern.menu-button","version":"1.0.0","title":"Menu button","kind":"pattern","standards_refs":[{"authority":"aria-apg","identifier":"menu-button","url":"https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/","normative":false}],"requires":["semantics.accessible-name","semantics.expanded-state","semantics.keyboard","semantics.focus.initial","semantics.focus.return"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.menu-button"}},"scope":"Button opening a command menu","behavior":["Open and navigate menu by keyboard"],"product_decisions":["focus_strategy"],"functional_spec_bindings":["behavior","keyboard","focus"],"implementation_outcomes":["menu-button-keyboard"],"evidence_routes":["unit","e2e","human"]}

package/src/patterns/navigation/menu.yml

@@ -0,0 +1 @@
+{"id":"pattern.menu","version":"1.0.0","title":"Menu and menubar","kind":"pattern","standards_refs":[{"authority":"aria-apg","identifier":"menubar","url":"https://www.w3.org/WAI/ARIA/apg/patterns/menubar/","normative":false}],"requires":["semantics.accessible-name","semantics.expanded-state","semantics.focus.initial","semantics.focus.return","semantics.focus.visible","semantics.keyboard","semantics.keyboard.escape","semantics.roles-states-properties"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.menu"}},"scope":"Command menus, submenus, and persistent menubars","behavior":["Expose menu or menubar containers with menuitem, menuitemcheckbox, or menuitemradio children; synchronize submenu expanded state, checkable-item checked state, orientation, and disabled state","When a popup menu opens, move focus to its first item; when a persistent menubar receives focus through Tab or Shift+Tab, restore its declared last-focused item or use its first enabled item; Tab and Shift+Tab do not move among items and, from an item, exit the composite and close all open menus","For the default horizontal menubar with vertical popup menus, Right and Left move among menubar items, Down opens a submenu and focuses its first item, Up may open it and focus its last item, Down and Up move among popup items, Right opens a child submenu, and Left closes a child submenu and returns focus to its parent item; reverse the declared axes for alternate orientations","Enter opens an item's submenu and focuses its first item, or otherwise activates the item and closes the menu; declare whether Space mirrors Enter on plain items, toggles menuitemcheckbox without closing, and checks a menuitemradio while unchecking its group peers without closing","Keep disabled menu items focusable but non-activatable, keep separators non-focusable, and apply Home, End, optional type-ahead, and the declared wrapping policy within the current menu or menubar","Escape closes the menu containing focus and restores focus to its parent item, menu button, or invoking context"],"product_decisions":["entry_focus","focus_strategy","menu_or_menubar","orientation","space_behavior","submenu_model","typeahead","wrap_navigation"],"functional_spec_bindings":["behavior","states","keyboard","focus"],"implementation_outcomes":["menu-composite-focus","menu-keyboard-model","menu-state-model"],"evidence_routes":["unit","axe","e2e","human"]}

package/src/patterns/navigation/pagination.yml

@@ -1 +1 @@
-{"id":"pattern.pagination","version":"1.0.0","title":"Pagination","kind":"pattern","requires":["semantics.native-elements","semantics.accessible-name","semantics.landmarks","semantics.focus.visible"],"activation":{"fact":"component.pattern","equals":"pagination"},"scope":"Paged result navigation","behavior":["Expose current page and named navigation"],"product_decisions":["url_behavior"],"functional_spec_bindings":["states","navigation"],"implementation_outcomes":["pagination-current-page"],"evidence_routes":["unit","axe","human"]}
+{"id":"pattern.pagination","version":"1.0.0","title":"Pagination","kind":"pattern","standards_refs":[{"authority":"wcag-2.2","identifier":"2.4.4","url":"https://www.w3.org/TR/WCAG22/#link-purpose-in-context","normative":true,"level":"A"}],"requires":["semantics.native-elements","semantics.accessible-name","semantics.landmarks","semantics.focus.visible"],"activation":{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.pagination"}},"scope":"Paged result navigation","behavior":["Expose current page and named navigation"],"product_decisions":["url_behavior"],"functional_spec_bindings":["states","navigation"],"implementation_outcomes":["pagination-current-page"],"evidence_routes":["unit","axe","human"]}