@verndale/accessibility-standards 1.0.0 → 2.0.1

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

@@ -1,6 +1,19 @@
 <!-- GENERATED by @verndale/accessibility-standards; DO NOT EDIT -->
+<!-- package: @verndale/accessibility-standards@2.0.1; profile: ai-orchestration@2.0.1; schema: 2; source-digest: 5123634b229ba2ada6a8270b53276f3074ed628c8d8a32db26b88ae7688df49b; profile-digest: f8485b4e166fe305a4a779a00700f8b9fc7e8b8f49904d24ddcdac016a5792a3 -->
 # Accessibility implementation contract
 
+## foundation.conformance-boundary
+
+Automated checks provide evidence but do not establish conformance; every applicable outcome needs its declared proof routes.
+
+## foundation.standards-hierarchy
+
+Prefer native platform semantics; apply WCAG conformance, ARIA only where needed, APG interaction guidance, then non-conflicting product policy.
+
+## foundation.wcag-2.2
+
+Meet WCAG 2.2 Level A and AA. Target size minimum is 24 by 24 CSS pixels or an allowed exception; 44 by 44 is enhanced guidance only.
+
 ## semantics.accessible-name
 
 Every interactive or meaning-bearing control has a concise programmatic name derived from visible text when available.
@@ -155,175 +168,496 @@ Proof: e2e, human.
 
 Requires: semantics.native-elements, semantics.accessible-name, semantics.expanded-state, semantics.keyboard, semantics.focus.visible.
 
+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: unit, axe, e2e, human.
 
 ## pattern.alert
 
 Requires: semantics.alert.
 
+Scope: Urgent message.
+
 Behavior:
 - Announce once without moving focus
 
+Product decisions: urgency.
+
+Functional Spec bindings: messaging.
+
+Implementation outcomes: alert-announcement.
+
 Evidence: unit, human.
 
 ## pattern.carousel
 
 Requires: semantics.accessible-name, semantics.keyboard, semantics.focus.visible, semantics.motion-control, semantics.live-status.
 
+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: unit, axe, e2e, human.
 
 ## pattern.combobox
 
 Requires: semantics.accessible-name, semantics.expanded-state, semantics.selected-state, semantics.keyboard, semantics.live-status.
 
+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: unit, axe, e2e, human.
 
 ## pattern.consequential-submission
 
 Requires: semantics.consequential-action, semantics.form-error, semantics.keyboard.
 
+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: e2e, human.
 
 ## pattern.dialog
 
 Requires: semantics.native-dialog, semantics.accessible-name, semantics.keyboard.escape, semantics.focus.initial, semantics.focus.return.
 
+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: unit, axe, e2e, human.
 
 ## pattern.disclosure
 
 Requires: semantics.native-elements, semantics.accessible-name, semantics.expanded-state, semantics.keyboard.
 
+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: unit, axe, e2e.
 
 ## pattern.dynamic-status
 
 Requires: semantics.live-status.
 
+Scope: Asynchronous status message.
+
 Behavior:
 - Announce meaningful changes once
 
+Product decisions: announcement_copy.
+
+Functional Spec bindings: messaging, states.
+
+Implementation outcomes: status-live-region.
+
 Evidence: unit, e2e, human.
 
 ## pattern.field
 
 Requires: semantics.form-label, semantics.form-required, semantics.focus.visible.
 
+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: unit, axe, human.
 
 ## pattern.image
 
 Requires: semantics.non-text-alternative.
 
+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: axe, human.
 
 ## pattern.listbox
 
 Requires: semantics.accessible-name, semantics.selected-state, semantics.keyboard, semantics.focus.visible.
 
+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: unit, axe, e2e, human.
 
 ## pattern.media-player
 
 Requires: semantics.media-alternatives, semantics.accessible-name, semantics.keyboard, semantics.focus.visible, semantics.motion-control.
 
+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: axe, e2e, human.
 
 ## pattern.menu-button
 
 Requires: semantics.accessible-name, semantics.expanded-state, semantics.keyboard, semantics.focus.initial, semantics.focus.return.
 
+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: unit, e2e, human.
 
 ## pattern.pagination
 
 Requires: semantics.native-elements, semantics.accessible-name, semantics.landmarks, semantics.focus.visible.
 
+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: unit, axe, human.
 
 ## pattern.popover
 
 Requires: semantics.native-elements, semantics.accessible-name, semantics.keyboard.escape, semantics.focus.return.
 
+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: unit, e2e, human.
 
 ## pattern.progress
 
 Requires: semantics.name-role-value, semantics.live-status.
 
+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: unit, axe, human.
 
 ## pattern.tabs
 
 Requires: semantics.accessible-name, semantics.selected-state, semantics.keyboard, semantics.focus.visible.
 
+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: unit, axe, e2e, human.
 
 ## pattern.tooltip
 
 Requires: semantics.accessible-name, semantics.keyboard.escape.
 
+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: unit, e2e, human.
 
 ## pattern.validation
 
 Requires: semantics.form-error, semantics.live-status, semantics.focus.initial.
 
+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: unit, axe, e2e, human.
+
+## applicability.page-context
+
+When: `{"equals":{"fact":"artifact.page_context","value":true}}`
+
+Outcomes: semantics.headings, semantics.landmarks.
+
+Evidence: axe, human.
+
+## applicability.non-text-content
+
+When: `{"equals":{"fact":"content.has_non_text","value":true}}`
+
+Outcomes: pattern.image.
+
+Evidence: axe, human.
+
+## applicability.media
+
+When: `{"equals":{"fact":"content.has_media","value":true}}`
+
+Outcomes: pattern.media-player.
+
+Evidence: e2e, human.
+
+## applicability.forms
+
+When: `{"equals":{"fact":"component.has_form_fields","value":true}}`
+
+Outcomes: pattern.field.
+
+Evidence: unit, axe.
+
+## applicability.validation
+
+When: `{"equals":{"fact":"component.has_validation","value":true}}`
+
+Outcomes: pattern.validation.
+
+Evidence: unit, axe, e2e, human.
+
+## applicability.consequential-submission
+
+When: `{"contains":{"fact":"component.submission_consequence","value":"consequential"}}`
+
+Outcomes: pattern.consequential-submission.
+
+Evidence: e2e, human.
+
+## applicability.dynamic-status
+
+When: `{"equals":{"fact":"component.has_dynamic_status","value":true}}`
+
+Outcomes: pattern.dynamic-status.
+
+Evidence: unit, e2e, human.
+
+## 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.
+
+## applicability.motion-timing
+
+When: `{"equals":{"fact":"interaction.has_motion_or_timing","value":true}}`
+
+Outcomes: semantics.motion-control.
+
+Evidence: e2e, human.
+
+## applicability.complex-pointer
+
+When: `{"equals":{"fact":"interaction.has_complex_pointer","value":true}}`
+
+Outcomes: semantics.keyboard.
+
+Evidence: e2e, human.
+
+## applicability.character-shortcuts
+
+When: `{"equals":{"fact":"interaction.has_character_shortcuts","value":true}}`
+
+Outcomes: semantics.keyboard.
+
+Evidence: unit, e2e.
+
+## applicability.orientation-sensory
+
+When: `{"equals":{"fact":"content.uses_orientation_or_sensory_cues","value":true}}`
+
+Outcomes: semantics.name-role-value.
+
+Evidence: human.
+
+## applicability.target-size
+
+When: `{"equals":{"fact":"interaction.has_pointer_targets","value":true}}`
+
+Outcomes: semantics.target-size.
+
+Evidence: e2e, human.
+
+## applicability.focus-obstruction
+
+When: `{"equals":{"fact":"interaction.can_obscure_focus","value":true}}`
+
+Outcomes: semantics.focus.visible.
+
+Evidence: e2e, human.
+
+## applicability.authentication-captcha
+
+When: `{"equals":{"fact":"flow.has_authentication","value":true}}`
+
+Outcomes: semantics.form-label, semantics.form-error.
+
+Evidence: axe, e2e, human.
+
+## applicability.redundant-entry
+
+When: `{"equals":{"fact":"flow.repeats_entry","value":true}}`
+
+Outcomes: semantics.form-label.
+
+Evidence: e2e, human.
+
+## applicability.consistent-help
+
+When: `{"equals":{"fact":"artifact.has_help","value":true}}`
+
+Outcomes: semantics.landmarks.
+
+Evidence: human.
+
+## applicability.locale-bidi
+
+When: `{"equals":{"fact":"content.has_locale_or_bidi","value":true}}`
+
+Outcomes: semantics.native-elements.
+
+Evidence: unit, human.
+
+## applicability.data-table-grid
+
+When: `{"equals":{"fact":"component.has_data_table_or_grid","value":true}}`
+
+Outcomes: semantics.data-table.
+
+Evidence: axe, e2e, human.
+
+## policy.enhanced-quality
+
+Enhanced guidance is advisory and cannot be represented as a conformance failure unless the consumer explicitly adopts it as product policy.
+
+## policy.target-size
+
+Enforce WCAG 2.5.8 at 24 by 24 CSS pixels or a documented exception; report 44 by 44 as enhanced guidance, never as the AA minimum.
+
+## Evidence routing
+
+Tool availability changes the evidence route, never requirement applicability. A missing required capability is a blocker.
+
+- unit: semantic state and deterministic resolver behavior; capability: unit
+- axe: automated rule evidence; capability: axe
+- e2e: keyboard, focus, and integrated behavior; capability: e2e
+- human: judgment, assistive technology, content, and visual evidence; capability: human