@verndale/accessibility-standards 1.0.0

package/dist/profiles/conductor/accessibility-quality.md

@@ -0,0 +1,179 @@
+<!-- GENERATED by @verndale/accessibility-standards; DO NOT EDIT -->
+# Accessibility quality contract
+
+## pattern.accordion
+
+Requires: semantics.native-elements, semantics.accessible-name, semantics.expanded-state, semantics.keyboard, semantics.focus.visible.
+
+Behavior:
+- Toggle only the controlled panel
+- Preserve DOM and focus order
+
+Evidence: unit, axe, e2e, human.
+
+## pattern.alert
+
+Requires: semantics.alert.
+
+Behavior:
+- Announce once without moving focus
+
+Evidence: unit, human.
+
+## pattern.carousel
+
+Requires: semantics.accessible-name, semantics.keyboard, semantics.focus.visible, semantics.motion-control, semantics.live-status.
+
+Behavior:
+- Pause rotation on interaction
+- Provide named controls and current position
+
+Evidence: unit, axe, e2e, human.
+
+## pattern.combobox
+
+Requires: semantics.accessible-name, semantics.expanded-state, semantics.selected-state, semantics.keyboard, semantics.live-status.
+
+Behavior:
+- Keyboard controls popup, option, and input independently
+
+Evidence: unit, axe, e2e, human.
+
+## pattern.consequential-submission
+
+Requires: semantics.consequential-action, semantics.form-error, semantics.keyboard.
+
+Behavior:
+- Support review, correction, confirmation, or reversal
+
+Evidence: e2e, human.
+
+## pattern.dialog
+
+Requires: semantics.native-dialog, semantics.accessible-name, semantics.keyboard.escape, semantics.focus.initial, semantics.focus.return.
+
+Behavior:
+- Manage initial, contained, and return focus
+- Dismiss topmost dialog with Escape
+
+Evidence: unit, axe, e2e, human.
+
+## pattern.disclosure
+
+Requires: semantics.native-elements, semantics.accessible-name, semantics.expanded-state, semantics.keyboard.
+
+Behavior:
+- Control toggles one region
+
+Evidence: unit, axe, e2e.
+
+## pattern.dynamic-status
+
+Requires: semantics.live-status.
+
+Behavior:
+- Announce meaningful changes once
+
+Evidence: unit, e2e, human.
+
+## pattern.field
+
+Requires: semantics.form-label, semantics.form-required, semantics.focus.visible.
+
+Behavior:
+- Expose label, instructions, and requiredness before interaction
+
+Evidence: unit, axe, human.
+
+## pattern.image
+
+Requires: semantics.non-text-alternative.
+
+Behavior:
+- Alternative follows image purpose
+
+Evidence: axe, human.
+
+## pattern.listbox
+
+Requires: semantics.accessible-name, semantics.selected-state, semantics.keyboard, semantics.focus.visible.
+
+Behavior:
+- Arrow keys move active option
+- Selection follows declared model
+
+Evidence: unit, axe, e2e, human.
+
+## pattern.media-player
+
+Requires: semantics.media-alternatives, semantics.accessible-name, semantics.keyboard, semantics.focus.visible, semantics.motion-control.
+
+Behavior:
+- Provide keyboard-operable named controls and required alternatives
+
+Evidence: axe, e2e, human.
+
+## pattern.menu-button
+
+Requires: semantics.accessible-name, semantics.expanded-state, semantics.keyboard, semantics.focus.initial, semantics.focus.return.
+
+Behavior:
+- Open and navigate menu by keyboard
+
+Evidence: unit, e2e, human.
+
+## pattern.pagination
+
+Requires: semantics.native-elements, semantics.accessible-name, semantics.landmarks, semantics.focus.visible.
+
+Behavior:
+- Expose current page and named navigation
+
+Evidence: unit, axe, human.
+
+## pattern.popover
+
+Requires: semantics.native-elements, semantics.accessible-name, semantics.keyboard.escape, semantics.focus.return.
+
+Behavior:
+- Dismiss without trapping focus
+
+Evidence: unit, e2e, human.
+
+## pattern.progress
+
+Requires: semantics.name-role-value, semantics.live-status.
+
+Behavior:
+- Expose value and completion changes without announcement noise
+
+Evidence: unit, axe, human.
+
+## pattern.tabs
+
+Requires: semantics.accessible-name, semantics.selected-state, semantics.keyboard, semantics.focus.visible.
+
+Behavior:
+- Arrow keys move between tabs
+- Selection and activation follow the documented model
+
+Evidence: unit, axe, e2e, human.
+
+## pattern.tooltip
+
+Requires: semantics.accessible-name, semantics.keyboard.escape.
+
+Behavior:
+- Available on hover and focus
+- Never contains interactive content
+
+Evidence: unit, e2e, human.
+
+## pattern.validation
+
+Requires: semantics.form-error, semantics.live-status, semantics.focus.initial.
+
+Behavior:
+- Identify, associate, summarize, and focus errors deterministically
+
+Evidence: unit, axe, e2e, human.

package/dist/profiles/conductor/applicability-matrix.json

@@ -0,0 +1,428 @@
+{
+  "_generated": "GENERATED by @verndale/accessibility-standards; DO NOT EDIT",
+  "schema_version": 1,
+  "trigger_states": [
+    "unobserved",
+    "not_applicable",
+    "candidate",
+    "applicable"
+  ],
+  "resolution_states": [
+    "skipped",
+    "needs_confirmation",
+    "needs_input",
+    "resolved",
+    "deferred",
+    "conflict"
+  ],
+  "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"
+    }
+  },
+  "rows": [
+    {
+      "id": "applicability.page-context",
+      "when": {
+        "equals": {
+          "fact": "artifact.page_context",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.headings",
+        "semantics.landmarks"
+      ],
+      "evidence": [
+        "axe",
+        "human"
+      ],
+      "order": 0,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.non-text-content",
+      "when": {
+        "equals": {
+          "fact": "content.has_non_text",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "pattern.image"
+      ],
+      "evidence": [
+        "axe",
+        "human"
+      ],
+      "order": 1,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.media",
+      "when": {
+        "equals": {
+          "fact": "content.has_media",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "pattern.media-player"
+      ],
+      "evidence": [
+        "e2e",
+        "human"
+      ],
+      "order": 2,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.forms",
+      "when": {
+        "equals": {
+          "fact": "component.has_form_fields",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "pattern.field",
+        "pattern.validation"
+      ],
+      "evidence": [
+        "unit",
+        "axe",
+        "e2e"
+      ],
+      "order": 3,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.consequential-submission",
+      "when": {
+        "contains": {
+          "fact": "component.submission_consequence",
+          "value": "consequential"
+        }
+      },
+      "outcomes": [
+        "pattern.consequential-submission"
+      ],
+      "evidence": [
+        "e2e",
+        "human"
+      ],
+      "order": 4,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.dynamic-status",
+      "when": {
+        "equals": {
+          "fact": "component.has_dynamic_status",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "pattern.dynamic-status"
+      ],
+      "evidence": [
+        "unit",
+        "e2e",
+        "human"
+      ],
+      "order": 5,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.overlays",
+      "when": {
+        "contains": {
+          "fact": "component.pattern",
+          "value": [
+            "dialog",
+            "popover",
+            "tooltip"
+          ]
+        }
+      },
+      "outcomes": [
+        "semantics.keyboard.escape",
+        "semantics.focus.return"
+      ],
+      "evidence": [
+        "e2e"
+      ],
+      "order": 6,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.motion-timing",
+      "when": {
+        "equals": {
+          "fact": "interaction.has_motion_or_timing",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.motion-control"
+      ],
+      "evidence": [
+        "e2e",
+        "human"
+      ],
+      "order": 7,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.complex-pointer",
+      "when": {
+        "equals": {
+          "fact": "interaction.has_complex_pointer",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.keyboard"
+      ],
+      "evidence": [
+        "e2e",
+        "human"
+      ],
+      "order": 8,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.character-shortcuts",
+      "when": {
+        "equals": {
+          "fact": "interaction.has_character_shortcuts",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.keyboard"
+      ],
+      "evidence": [
+        "unit",
+        "e2e"
+      ],
+      "order": 9,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.orientation-sensory",
+      "when": {
+        "equals": {
+          "fact": "content.uses_orientation_or_sensory_cues",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.name-role-value"
+      ],
+      "evidence": [
+        "human"
+      ],
+      "order": 10,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.target-size",
+      "when": {
+        "equals": {
+          "fact": "interaction.has_pointer_targets",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.target-size"
+      ],
+      "evidence": [
+        "e2e",
+        "human"
+      ],
+      "order": 11,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.focus-obstruction",
+      "when": {
+        "equals": {
+          "fact": "interaction.can_obscure_focus",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.focus.visible"
+      ],
+      "evidence": [
+        "e2e",
+        "human"
+      ],
+      "order": 12,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.authentication-captcha",
+      "when": {
+        "equals": {
+          "fact": "flow.has_authentication",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.form-label",
+        "semantics.form-error"
+      ],
+      "evidence": [
+        "axe",
+        "e2e",
+        "human"
+      ],
+      "order": 13,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.redundant-entry",
+      "when": {
+        "equals": {
+          "fact": "flow.repeats_entry",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.form-label"
+      ],
+      "evidence": [
+        "e2e",
+        "human"
+      ],
+      "order": 14,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.consistent-help",
+      "when": {
+        "equals": {
+          "fact": "artifact.has_help",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.landmarks"
+      ],
+      "evidence": [
+        "human"
+      ],
+      "order": 15,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.locale-bidi",
+      "when": {
+        "equals": {
+          "fact": "content.has_locale_or_bidi",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.native-elements"
+      ],
+      "evidence": [
+        "unit",
+        "human"
+      ],
+      "order": 16,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    },
+    {
+      "id": "applicability.data-table-grid",
+      "when": {
+        "equals": {
+          "fact": "component.has_data_table_or_grid",
+          "value": true
+        }
+      },
+      "outcomes": [
+        "semantics.data-table"
+      ],
+      "evidence": [
+        "axe",
+        "e2e",
+        "human"
+      ],
+      "order": 17,
+      "trigger_state": "unobserved",
+      "resolution_state": "needs_input"
+    }
+  ]
+}