@verndale/accessibility-standards 1.0.0

package/dist/profiles/ai-orchestration/pattern-contracts.json

@@ -0,0 +1,697 @@
+{
+  "_generated": "GENERATED by @verndale/accessibility-standards; DO NOT EDIT",
+  "schema_version": 1,
+  "patterns": [
+    {
+      "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.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.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.combobox",
+      "version": "1.0.0",
+      "title": "Combobox",
+      "kind": "pattern",
+      "requires": [
+        "semantics.accessible-name",
+        "semantics.expanded-state",
+        "semantics.selected-state",
+        "semantics.keyboard",
+        "semantics.live-status"
+      ],
+      "activation": {
+        "fact": "component.pattern",
+        "equals": "combobox"
+      },
+      "scope": "Input with selectable popup",
+      "behavior": [
+        "Keyboard controls popup, option, and input independently"
+      ],
+      "product_decisions": [
+        "editable",
+        "autocomplete",
+        "selection_commit"
+      ],
+      "functional_spec_bindings": [
+        "behavior",
+        "states",
+        "keyboard"
+      ],
+      "implementation_outcomes": [
+        "combobox-state-machine"
+      ],
+      "evidence_routes": [
+        "unit",
+        "axe",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "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.dialog",
+      "version": "1.0.0",
+      "title": "Dialog",
+      "kind": "pattern",
+      "requires": [
+        "semantics.native-dialog",
+        "semantics.accessible-name",
+        "semantics.keyboard.escape",
+        "semantics.focus.initial",
+        "semantics.focus.return"
+      ],
+      "activation": {
+        "fact": "component.pattern",
+        "equals": "dialog"
+      },
+      "scope": "Modal and non-modal dialogs",
+      "behavior": [
+        "Manage initial, contained, and return focus",
+        "Dismiss topmost dialog with Escape"
+      ],
+      "product_decisions": [
+        "modal",
+        "initial_focus",
+        "dismissal"
+      ],
+      "functional_spec_bindings": [
+        "behavior",
+        "states",
+        "focus",
+        "keyboard"
+      ],
+      "implementation_outcomes": [
+        "dialog-semantics",
+        "dialog-focus-lifecycle"
+      ],
+      "evidence_routes": [
+        "unit",
+        "axe",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "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.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.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.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.listbox",
+      "version": "1.0.0",
+      "title": "Listbox",
+      "kind": "pattern",
+      "requires": [
+        "semantics.accessible-name",
+        "semantics.selected-state",
+        "semantics.keyboard",
+        "semantics.focus.visible"
+      ],
+      "activation": {
+        "fact": "component.pattern",
+        "equals": "listbox"
+      },
+      "scope": "Single or multi-select option list",
+      "behavior": [
+        "Arrow keys move active option",
+        "Selection follows declared model"
+      ],
+      "product_decisions": [
+        "single_or_multi",
+        "selection_follows_focus"
+      ],
+      "functional_spec_bindings": [
+        "behavior",
+        "states",
+        "keyboard"
+      ],
+      "implementation_outcomes": [
+        "listbox-keyboard-model"
+      ],
+      "evidence_routes": [
+        "unit",
+        "axe",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "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.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.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.popover",
+      "version": "1.0.0",
+      "title": "Popover",
+      "kind": "pattern",
+      "requires": [
+        "semantics.native-elements",
+        "semantics.accessible-name",
+        "semantics.keyboard.escape",
+        "semantics.focus.return"
+      ],
+      "activation": {
+        "fact": "component.pattern",
+        "equals": "popover"
+      },
+      "scope": "Non-modal transient surface",
+      "behavior": [
+        "Dismiss without trapping focus"
+      ],
+      "product_decisions": [
+        "dismissal",
+        "focus_entry"
+      ],
+      "functional_spec_bindings": [
+        "behavior",
+        "focus"
+      ],
+      "implementation_outcomes": [
+        "popover-dismissal"
+      ],
+      "evidence_routes": [
+        "unit",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "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.tabs",
+      "version": "1.0.0",
+      "title": "Tabs",
+      "kind": "pattern",
+      "requires": [
+        "semantics.accessible-name",
+        "semantics.selected-state",
+        "semantics.keyboard",
+        "semantics.focus.visible"
+      ],
+      "activation": {
+        "fact": "component.pattern",
+        "equals": "tabs"
+      },
+      "scope": "Tabbed interfaces",
+      "behavior": [
+        "Arrow keys move between tabs",
+        "Selection and activation follow the documented model"
+      ],
+      "product_decisions": [
+        "automatic_or_manual_activation"
+      ],
+      "functional_spec_bindings": [
+        "behavior",
+        "states",
+        "keyboard"
+      ],
+      "implementation_outcomes": [
+        "tabs-keyboard-model"
+      ],
+      "evidence_routes": [
+        "unit",
+        "axe",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "id": "pattern.tooltip",
+      "version": "1.0.0",
+      "title": "Tooltip",
+      "kind": "pattern",
+      "requires": [
+        "semantics.accessible-name",
+        "semantics.keyboard.escape"
+      ],
+      "activation": {
+        "fact": "component.pattern",
+        "equals": "tooltip"
+      },
+      "scope": "Supplementary description",
+      "behavior": [
+        "Available on hover and focus",
+        "Never contains interactive content"
+      ],
+      "product_decisions": [
+        "delay"
+      ],
+      "functional_spec_bindings": [
+        "behavior"
+      ],
+      "implementation_outcomes": [
+        "tooltip-description"
+      ],
+      "evidence_routes": [
+        "unit",
+        "e2e",
+        "human"
+      ]
+    },
+    {
+      "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"
+      ]
+    }
+  ]
+}

package/dist/profiles/ai-orchestration/patterns/accordion.md

@@ -0,0 +1,12 @@
+<!-- GENERATED by @verndale/accessibility-standards; DO NOT EDIT -->
+# pattern.accordion
+
+## 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.