@verndale/accessibility-standards 1.0.0

package/dist/profiles/ai-orchestration/semantics.json

@@ -0,0 +1,289 @@
+{
+  "_generated": "GENERATED by @verndale/accessibility-standards; DO NOT EDIT",
+  "schema_version": 1,
+  "semantics": [
+    {
+      "id": "semantics.accessible-name",
+      "version": "1.0.0",
+      "title": "Accessible name",
+      "kind": "semantic",
+      "requirement": "Every interactive or meaning-bearing control has a concise programmatic name derived from visible text when available.",
+      "proof": [
+        "unit",
+        "axe",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.alert",
+      "version": "1.0.0",
+      "title": "Urgent alert",
+      "kind": "semantic",
+      "requirement": "Use alert semantics only for urgent, time-sensitive messages that require immediate announcement.",
+      "proof": [
+        "unit",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.consequential-action",
+      "version": "1.0.0",
+      "title": "Consequential action",
+      "kind": "semantic",
+      "requirement": "Legal, financial, destructive, or data-submitting actions support review, confirmation, or reversal as required.",
+      "proof": [
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.data-table",
+      "version": "1.0.0",
+      "title": "Data table",
+      "kind": "semantic",
+      "requirement": "Tabular relationships use table markup with associated headers; interactive grids implement their full keyboard model.",
+      "proof": [
+        "axe",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.expanded-state",
+      "version": "1.0.0",
+      "title": "Expanded state",
+      "kind": "semantic",
+      "requirement": "Expandable controls expose aria-expanded and identify the controlled region when needed.",
+      "proof": [
+        "unit",
+        "axe",
+        "e2e"
+      ]
+    },
+    {
+      "id": "semantics.focus.initial",
+      "version": "1.0.0",
+      "title": "Initial focus",
+      "kind": "semantic",
+      "requirement": "On activation, focus moves to the deterministic target appropriate to the pattern.",
+      "proof": [
+        "unit",
+        "e2e"
+      ]
+    },
+    {
+      "id": "semantics.focus.return",
+      "version": "1.0.0",
+      "title": "Focus return",
+      "kind": "semantic",
+      "requirement": "On dismissal, focus returns to the invoking control or a documented logical successor.",
+      "proof": [
+        "unit",
+        "e2e"
+      ]
+    },
+    {
+      "id": "semantics.focus.visible",
+      "version": "1.0.0",
+      "title": "Visible focus",
+      "kind": "semantic",
+      "requirement": "Keyboard focus is visible, sufficiently contrasted, and not fully obscured.",
+      "proof": [
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.form-error",
+      "version": "1.0.0",
+      "title": "Form error",
+      "kind": "semantic",
+      "requirement": "Identify errors in text, associate them with fields, and provide correction guidance.",
+      "proof": [
+        "unit",
+        "axe",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.form-label",
+      "version": "1.0.0",
+      "title": "Form label",
+      "kind": "semantic",
+      "requirement": "Every form control has a persistent programmatically associated label.",
+      "proof": [
+        "unit",
+        "axe"
+      ]
+    },
+    {
+      "id": "semantics.form-required",
+      "version": "1.0.0",
+      "title": "Required field",
+      "kind": "semantic",
+      "requirement": "Requiredness is communicated visually and programmatically before submission.",
+      "proof": [
+        "unit",
+        "axe"
+      ]
+    },
+    {
+      "id": "semantics.headings",
+      "version": "1.0.0",
+      "title": "Heading structure",
+      "kind": "semantic",
+      "requirement": "Headings describe document structure without choosing levels for visual appearance.",
+      "proof": [
+        "axe",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.keyboard",
+      "version": "1.0.0",
+      "title": "Keyboard operation",
+      "kind": "semantic",
+      "requirement": "All functionality is operable with a keyboard without traps.",
+      "proof": [
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.keyboard.escape",
+      "version": "1.0.0",
+      "title": "Escape dismissal",
+      "kind": "semantic",
+      "requirement": "Escape closes the topmost dismissible overlay without activating its trigger.",
+      "proof": [
+        "unit",
+        "e2e"
+      ]
+    },
+    {
+      "id": "semantics.landmarks",
+      "version": "1.0.0",
+      "title": "Landmarks",
+      "kind": "semantic",
+      "requirement": "Use native landmarks and name repeated landmarks only when a name is required to distinguish them.",
+      "proof": [
+        "axe",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.live-status",
+      "version": "1.0.0",
+      "title": "Status announcements",
+      "kind": "semantic",
+      "requirement": "Important asynchronous status updates are exposed through a correctly scoped, non-duplicative live region.",
+      "proof": [
+        "unit",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.media-alternatives",
+      "version": "1.0.0",
+      "title": "Media alternatives",
+      "kind": "semantic",
+      "requirement": "Prerecorded media provides applicable captions, transcripts, and audio description.",
+      "proof": [
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.motion-control",
+      "version": "1.0.0",
+      "title": "Motion control",
+      "kind": "semantic",
+      "requirement": "Respect reduced-motion preferences and provide controls for moving or time-limited content where required.",
+      "proof": [
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.name-role-value",
+      "version": "1.0.0",
+      "title": "Name role value",
+      "kind": "semantic",
+      "requirement": "Expose the correct accessible name, role, value, and state through the platform accessibility API.",
+      "proof": [
+        "unit",
+        "axe",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.native-dialog",
+      "version": "1.0.0",
+      "title": "Native dialog semantics",
+      "kind": "semantic",
+      "requirement": "Use dialog semantics with a programmatic name and modal state only when interaction is modal.",
+      "proof": [
+        "axe",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.native-elements",
+      "version": "1.0.0",
+      "title": "Native elements",
+      "kind": "semantic",
+      "requirement": "Use the native HTML element whose semantics and behavior match the control before adding ARIA.",
+      "proof": [
+        "axe",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.non-text-alternative",
+      "version": "1.0.0",
+      "title": "Non-text alternative",
+      "kind": "semantic",
+      "requirement": "Meaningful non-text content has an equivalent alternative and decorative content is ignored by assistive technology.",
+      "proof": [
+        "axe",
+        "human"
+      ]
+    },
+    {
+      "id": "semantics.roles-states-properties",
+      "version": "1.0.0",
+      "title": "Roles states and properties",
+      "kind": "semantic",
+      "requirement": "Apply only valid ARIA roles, states, and properties and keep exposed state synchronized with rendered behavior.",
+      "proof": [
+        "unit",
+        "axe",
+        "e2e"
+      ]
+    },
+    {
+      "id": "semantics.selected-state",
+      "version": "1.0.0",
+      "title": "Selected state",
+      "kind": "semantic",
+      "requirement": "Selection widgets expose current selection with the state required by their role.",
+      "proof": [
+        "unit",
+        "e2e"
+      ]
+    },
+    {
+      "id": "semantics.target-size",
+      "version": "1.0.0",
+      "title": "Target size",
+      "kind": "semantic",
+      "requirement": "Pointer targets meet 24 by 24 CSS pixels or a WCAG 2.5.8 exception; 44 by 44 is an enhanced recommendation.",
+      "proof": [
+        "e2e",
+        "human"
+      ]
+    }
+  ]
+}

package/dist/profiles/ai-orchestration/testing/accessibility.md

@@ -0,0 +1,138 @@
+<!-- GENERATED by @verndale/accessibility-standards; DO NOT EDIT -->
+# Accessibility testing contract
+
+## axe
+
+- pattern.accordion
+- pattern.carousel
+- pattern.combobox
+- pattern.dialog
+- pattern.disclosure
+- pattern.field
+- pattern.image
+- pattern.listbox
+- pattern.media-player
+- pattern.pagination
+- pattern.progress
+- pattern.tabs
+- pattern.validation
+- semantics.accessible-name
+- semantics.data-table
+- semantics.expanded-state
+- semantics.form-error
+- semantics.form-label
+- semantics.form-required
+- semantics.headings
+- semantics.landmarks
+- semantics.name-role-value
+- semantics.native-dialog
+- semantics.native-elements
+- semantics.non-text-alternative
+- semantics.roles-states-properties
+
+## e2e
+
+- pattern.accordion
+- pattern.carousel
+- pattern.combobox
+- pattern.consequential-submission
+- pattern.dialog
+- pattern.disclosure
+- pattern.dynamic-status
+- pattern.field
+- pattern.listbox
+- pattern.media-player
+- pattern.menu-button
+- pattern.popover
+- pattern.tabs
+- pattern.tooltip
+- pattern.validation
+- semantics.consequential-action
+- semantics.data-table
+- semantics.expanded-state
+- semantics.focus.initial
+- semantics.focus.return
+- semantics.focus.visible
+- semantics.form-error
+- semantics.form-label
+- semantics.keyboard
+- semantics.keyboard.escape
+- semantics.live-status
+- semantics.motion-control
+- semantics.native-dialog
+- semantics.roles-states-properties
+- semantics.selected-state
+- semantics.target-size
+
+## human
+
+- pattern.accordion
+- pattern.alert
+- pattern.carousel
+- pattern.combobox
+- pattern.consequential-submission
+- pattern.dialog
+- pattern.dynamic-status
+- pattern.field
+- pattern.image
+- pattern.listbox
+- pattern.media-player
+- pattern.menu-button
+- pattern.pagination
+- pattern.popover
+- pattern.progress
+- pattern.tabs
+- pattern.tooltip
+- pattern.validation
+- semantics.accessible-name
+- semantics.alert
+- semantics.consequential-action
+- semantics.data-table
+- semantics.focus.visible
+- semantics.form-error
+- semantics.form-label
+- semantics.headings
+- semantics.keyboard
+- semantics.landmarks
+- semantics.live-status
+- semantics.media-alternatives
+- semantics.motion-control
+- semantics.name-role-value
+- semantics.native-dialog
+- semantics.native-elements
+- semantics.non-text-alternative
+- semantics.target-size
+
+## unit
+
+- pattern.accordion
+- pattern.alert
+- pattern.carousel
+- pattern.combobox
+- pattern.dialog
+- pattern.disclosure
+- pattern.dynamic-status
+- pattern.field
+- pattern.listbox
+- pattern.menu-button
+- pattern.pagination
+- pattern.popover
+- pattern.progress
+- pattern.tabs
+- pattern.tooltip
+- pattern.validation
+- semantics.accessible-name
+- semantics.alert
+- semantics.expanded-state
+- semantics.focus.initial
+- semantics.focus.return
+- semantics.form-error
+- semantics.form-label
+- semantics.form-required
+- semantics.keyboard
+- semantics.keyboard.escape
+- semantics.live-status
+- semantics.name-role-value
+- semantics.native-elements
+- semantics.roles-states-properties
+- semantics.selected-state

package/dist/profiles/conductor/a11y-semantics.md

@@ -0,0 +1,152 @@
+<!-- GENERATED by @verndale/accessibility-standards; DO NOT EDIT -->
+# Accessibility semantics
+
+## semantics.accessible-name
+
+Every interactive or meaning-bearing control has a concise programmatic name derived from visible text when available.
+
+Proof: unit, axe, human.
+
+## semantics.alert
+
+Use alert semantics only for urgent, time-sensitive messages that require immediate announcement.
+
+Proof: unit, human.
+
+## semantics.consequential-action
+
+Legal, financial, destructive, or data-submitting actions support review, confirmation, or reversal as required.
+
+Proof: e2e, human.
+
+## semantics.data-table
+
+Tabular relationships use table markup with associated headers; interactive grids implement their full keyboard model.
+
+Proof: axe, e2e, human.
+
+## semantics.expanded-state
+
+Expandable controls expose aria-expanded and identify the controlled region when needed.
+
+Proof: unit, axe, e2e.
+
+## semantics.focus.initial
+
+On activation, focus moves to the deterministic target appropriate to the pattern.
+
+Proof: unit, e2e.
+
+## semantics.focus.return
+
+On dismissal, focus returns to the invoking control or a documented logical successor.
+
+Proof: unit, e2e.
+
+## semantics.focus.visible
+
+Keyboard focus is visible, sufficiently contrasted, and not fully obscured.
+
+Proof: e2e, human.
+
+## semantics.form-error
+
+Identify errors in text, associate them with fields, and provide correction guidance.
+
+Proof: unit, axe, e2e, human.
+
+## semantics.form-label
+
+Every form control has a persistent programmatically associated label.
+
+Proof: unit, axe.
+
+## semantics.form-required
+
+Requiredness is communicated visually and programmatically before submission.
+
+Proof: unit, axe.
+
+## semantics.headings
+
+Headings describe document structure without choosing levels for visual appearance.
+
+Proof: axe, human.
+
+## semantics.keyboard
+
+All functionality is operable with a keyboard without traps.
+
+Proof: e2e, human.
+
+## semantics.keyboard.escape
+
+Escape closes the topmost dismissible overlay without activating its trigger.
+
+Proof: unit, e2e.
+
+## semantics.landmarks
+
+Use native landmarks and name repeated landmarks only when a name is required to distinguish them.
+
+Proof: axe, human.
+
+## semantics.live-status
+
+Important asynchronous status updates are exposed through a correctly scoped, non-duplicative live region.
+
+Proof: unit, e2e, human.
+
+## semantics.media-alternatives
+
+Prerecorded media provides applicable captions, transcripts, and audio description.
+
+Proof: human.
+
+## semantics.motion-control
+
+Respect reduced-motion preferences and provide controls for moving or time-limited content where required.
+
+Proof: e2e, human.
+
+## semantics.name-role-value
+
+Expose the correct accessible name, role, value, and state through the platform accessibility API.
+
+Proof: unit, axe, human.
+
+## semantics.native-dialog
+
+Use dialog semantics with a programmatic name and modal state only when interaction is modal.
+
+Proof: axe, e2e, human.
+
+## semantics.native-elements
+
+Use the native HTML element whose semantics and behavior match the control before adding ARIA.
+
+Proof: axe, human.
+
+## semantics.non-text-alternative
+
+Meaningful non-text content has an equivalent alternative and decorative content is ignored by assistive technology.
+
+Proof: axe, human.
+
+## semantics.roles-states-properties
+
+Apply only valid ARIA roles, states, and properties and keep exposed state synchronized with rendered behavior.
+
+Proof: unit, axe, e2e.
+
+## semantics.selected-state
+
+Selection widgets expose current selection with the state required by their role.
+
+Proof: unit, e2e.
+
+## semantics.target-size
+
+Pointer targets meet 24 by 24 CSS pixels or a WCAG 2.5.8 exception; 44 by 44 is an enhanced recommendation.
+
+Proof: e2e, human.