@verndale/accessibility-standards 1.0.0 → 3.0.0

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

@@ -1,9 +1,38 @@
 <!-- GENERATED by @verndale/accessibility-standards; DO NOT EDIT -->
+<!-- package: @verndale/accessibility-standards@3.0.0; profile: ai-orchestration@3.0.0; schema: 3; source-digest: 708ac82783bfb5ebcce31e4dada15d8580863f5e37b32d1807adf61e415ed5af; profile-digest: de396e9a23010dff2e8abf3ae7e8500153599583ffa31a595b3a94fbe9df3da4 -->
 # 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-authentication
+
+Do not require a cognitive function test at any authentication step unless that step provides a non-cognitive alternative or an assistive mechanism such as password-manager support or copy and paste, including pasting a complete one-time code, or the test is limited to the object-recognition or user-provided personal-content exception.
+
+Standards:
+- [wcag-2.2 3.3.8](<https://www.w3.org/TR/WCAG22/#accessible-authentication-minimum>) (Level AA) — normative
+- [wcag-2.2-understanding 3.3.8](<https://www.w3.org/WAI/WCAG22/Understanding/accessible-authentication-minimum.html>) (Level AA) — informative
+
+Proof: e2e, human.
+
 ## semantics.accessible-name
 
-Every interactive or meaning-bearing control has a concise programmatic name derived from visible text when available.
+Every interactive or meaning-bearing control has a concise programmatic name. For user interface components whose visible labels include text or images of text, the accessible name contains the text presented visually; preserve that text's order where practical.
+
+Standards:
+- [wcag-2.2 2.5.3](<https://www.w3.org/TR/WCAG22/#label-in-name>) (Level A) — normative
+- [wcag-2.2 4.1.2](<https://www.w3.org/TR/WCAG22/#name-role-value>) (Level A) — normative
+- [wcag-2.2-understanding 2.5.3](<https://www.w3.org/WAI/WCAG22/Understanding/label-in-name.html>) (Level A) — informative
+- [wcag-2.2-understanding 4.1.2](<https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html>) (Level A) — informative
 
 Proof: unit, axe, human.
 
@@ -11,47 +40,105 @@ Proof: unit, axe, human.
 
 Use alert semantics only for urgent, time-sensitive messages that require immediate announcement.
 
+Standards:
+- [aria-apg alert](<https://www.w3.org/WAI/ARIA/apg/patterns/alert/>) — informative
+- [wai-aria-1.2 alert](<https://www.w3.org/TR/wai-aria-1.2/#alert>) — normative
+- [wcag-2.2 4.1.3](<https://www.w3.org/TR/WCAG22/#status-messages>) (Level AA) — normative
+- [wcag-2.2-understanding 4.1.3](<https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html>) (Level AA) — informative
+
 Proof: unit, human.
 
 ## semantics.consequential-action
 
-Legal, financial, destructive, or data-submitting actions support review, confirmation, or reversal as required.
+For web pages that cause legal commitments or financial transactions, modify or delete user-controllable data in data storage systems, or submit user test responses, at least one safeguard is provided: submissions are reversible; user-entered data is checked for input errors and the user can correct them; or a mechanism lets the user review, confirm, and correct information before finalizing the submission.
+
+Standards:
+- [wcag-2.2 3.3.4](<https://www.w3.org/TR/WCAG22/#error-prevention-legal-financial-data>) (Level AA) — normative
+- [wcag-2.2-understanding 3.3.4](<https://www.w3.org/WAI/WCAG22/Understanding/error-prevention-legal-financial-data.html>) (Level AA) — informative
+
+Proof: e2e, human.
+
+## semantics.consistent-help
+
+When human contact details or mechanisms, self-help, or fully automated contact mechanisms repeat across pages in the same set, they occur in the same serialized order relative to other content for the same page variation unless the user initiates a change. This does not require adding help.
+
+Standards:
+- [wcag-2.2 3.2.6](<https://www.w3.org/TR/WCAG22/#consistent-help>) (Level A) — normative
+- [wcag-2.2-understanding 3.2.6](<https://www.w3.org/WAI/WCAG22/Understanding/consistent-help.html>) (Level A) — informative
 
 Proof: e2e, human.
 
 ## semantics.data-table
 
-Tabular relationships use table markup with associated headers; interactive grids implement their full keyboard model.
+Tabular relationships use table semantics with programmatically associated row and column headers.
+
+Standards:
+- [aria-apg table](<https://www.w3.org/WAI/ARIA/apg/patterns/table/>) — informative
+- [wcag-2.2 1.3.1](<https://www.w3.org/TR/WCAG22/#info-and-relationships>) (Level A) — normative
+- [wcag-2.2-understanding 1.3.1](<https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html>) (Level A) — informative
 
 Proof: axe, e2e, human.
 
+## semantics.dragging-alternative
+
+Author-provided functionality operated by dragging also provides an equivalent single-pointer method that does not require dragging, unless dragging is essential or the functionality is determined by the user agent and not modified by the author.
+
+Standards:
+- [wcag-2.2 2.5.7](<https://www.w3.org/TR/WCAG22/#dragging-movements>) (Level AA) — normative
+- [wcag-2.2-understanding 2.5.7](<https://www.w3.org/WAI/WCAG22/Understanding/dragging-movements.html>) (Level AA) — informative
+
+Proof: e2e, human.
+
 ## semantics.expanded-state
 
 Expandable controls expose aria-expanded and identify the controlled region when needed.
 
+Standards:
+- [wai-aria-1.2 aria-expanded](<https://www.w3.org/TR/wai-aria-1.2/#aria-expanded>) — normative
+- [wcag-2.2 4.1.2](<https://www.w3.org/TR/WCAG22/#name-role-value>) (Level A) — normative
+- [wcag-2.2-understanding 4.1.2](<https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html>) (Level A) — informative
+
 Proof: unit, axe, e2e.
 
 ## semantics.focus.initial
 
 On activation, focus moves to the deterministic target appropriate to the pattern.
 
+Standards:
+- [aria-apg dialog-modal](<https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/#keyboard_interaction>) — informative
+
 Proof: unit, e2e.
 
 ## semantics.focus.return
 
 On dismissal, focus returns to the invoking control or a documented logical successor.
 
+Standards:
+- [aria-apg dialog-modal](<https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/#keyboard_interaction>) — informative
+
 Proof: unit, e2e.
 
 ## semantics.focus.visible
 
-Keyboard focus is visible, sufficiently contrasted, and not fully obscured.
+A visible keyboard focus indicator is available, and focused components are not entirely hidden by author-created content.
+
+Standards:
+- [wcag-2.2 2.4.11](<https://www.w3.org/TR/WCAG22/#focus-not-obscured-minimum>) (Level AA) — normative
+- [wcag-2.2 2.4.7](<https://www.w3.org/TR/WCAG22/#focus-visible>) (Level AA) — normative
+- [wcag-2.2-understanding 2.4.11](<https://www.w3.org/WAI/WCAG22/Understanding/focus-not-obscured-minimum.html>) (Level AA) — informative
+- [wcag-2.2-understanding 2.4.7](<https://www.w3.org/WAI/WCAG22/Understanding/focus-visible.html>) (Level AA) — informative
 
 Proof: e2e, human.
 
 ## semantics.form-error
 
-Identify errors in text, associate them with fields, and provide correction guidance.
+When an input error is automatically detected, identify the item in error and describe the error to the user in text. When correction suggestions are known, provide them unless doing so would jeopardize the security or purpose of the content.
+
+Standards:
+- [wcag-2.2 3.3.1](<https://www.w3.org/TR/WCAG22/#error-identification>) (Level A) — normative
+- [wcag-2.2 3.3.3](<https://www.w3.org/TR/WCAG22/#error-suggestion>) (Level AA) — normative
+- [wcag-2.2-understanding 3.3.1](<https://www.w3.org/WAI/WCAG22/Understanding/error-identification.html>) (Level A) — informative
+- [wcag-2.2-understanding 3.3.3](<https://www.w3.org/WAI/WCAG22/Understanding/error-suggestion.html>) (Level AA) — informative
 
 Proof: unit, axe, e2e, human.
 
@@ -59,41 +146,78 @@ Proof: unit, axe, e2e, human.
 
 Every form control has a persistent programmatically associated label.
 
+Standards:
+- [wcag-2.2 1.3.1](<https://www.w3.org/TR/WCAG22/#info-and-relationships>) (Level A) — normative
+- [wcag-2.2 3.3.2](<https://www.w3.org/TR/WCAG22/#labels-or-instructions>) (Level A) — normative
+- [wcag-2.2-understanding 1.3.1](<https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html>) (Level A) — informative
+- [wcag-2.2-understanding 3.3.2](<https://www.w3.org/WAI/WCAG22/Understanding/labels-or-instructions.html>) (Level A) — informative
+
 Proof: unit, axe.
 
 ## semantics.form-required
 
 Requiredness is communicated visually and programmatically before submission.
 
+Standards:
+- [wcag-2.2 1.3.1](<https://www.w3.org/TR/WCAG22/#info-and-relationships>) (Level A) — normative
+- [wcag-2.2 3.3.2](<https://www.w3.org/TR/WCAG22/#labels-or-instructions>) (Level A) — normative
+- [wcag-2.2-understanding 1.3.1](<https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html>) (Level A) — informative
+- [wcag-2.2-understanding 3.3.2](<https://www.w3.org/WAI/WCAG22/Understanding/labels-or-instructions.html>) (Level A) — informative
+
 Proof: unit, axe.
 
 ## semantics.headings
 
 Headings describe document structure without choosing levels for visual appearance.
 
+Standards:
+- [wcag-2.2 1.3.1](<https://www.w3.org/TR/WCAG22/#info-and-relationships>) (Level A) — normative
+- [wcag-2.2 2.4.6](<https://www.w3.org/TR/WCAG22/#headings-and-labels>) (Level AA) — normative
+- [wcag-2.2-understanding 1.3.1](<https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html>) (Level A) — informative
+- [wcag-2.2-understanding 2.4.6](<https://www.w3.org/WAI/WCAG22/Understanding/headings-and-labels.html>) (Level AA) — informative
+
 Proof: axe, human.
 
 ## semantics.keyboard
 
 All functionality is operable with a keyboard without traps.
 
+Standards:
+- [wcag-2.2 2.1.1](<https://www.w3.org/TR/WCAG22/#keyboard>) (Level A) — normative
+- [wcag-2.2 2.1.2](<https://www.w3.org/TR/WCAG22/#no-keyboard-trap>) (Level A) — normative
+- [wcag-2.2-understanding 2.1.1](<https://www.w3.org/WAI/WCAG22/Understanding/keyboard.html>) (Level A) — informative
+- [wcag-2.2-understanding 2.1.2](<https://www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html>) (Level A) — informative
+
 Proof: e2e, human.
 
 ## semantics.keyboard.escape
 
 Escape closes the topmost dismissible overlay without activating its trigger.
 
+Standards:
+- [aria-apg dialog-modal](<https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/#keyboard_interaction>) — informative
+
 Proof: unit, e2e.
 
 ## semantics.landmarks
 
 Use native landmarks and name repeated landmarks only when a name is required to distinguish them.
 
+Standards:
+- [aria-apg landmark-regions](<https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/>) — informative
+- [wcag-2.2 1.3.1](<https://www.w3.org/TR/WCAG22/#info-and-relationships>) (Level A) — normative
+- [wcag-2.2-understanding 1.3.1](<https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html>) (Level A) — informative
+
 Proof: axe, human.
 
 ## semantics.live-status
 
-Important asynchronous status updates are exposed through a correctly scoped, non-duplicative live region.
+Status messages that can be programmatically determined are exposed to assistive technology through appropriate roles or properties without receiving focus, using correctly scoped and non-duplicative live regions where needed.
+
+Standards:
+- [wai-aria-1.2 status](<https://www.w3.org/TR/wai-aria-1.2/#status>) — normative
+- [wcag-2.2 4.1.3](<https://www.w3.org/TR/WCAG22/#status-messages>) (Level AA) — normative
+- [wcag-2.2-understanding 4.1.3](<https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html>) (Level AA) — informative
 
 Proof: unit, e2e, human.
 
@@ -101,17 +225,37 @@ Proof: unit, e2e, human.
 
 Prerecorded media provides applicable captions, transcripts, and audio description.
 
+Standards:
+- [wcag-2.2 1.2.1](<https://www.w3.org/TR/WCAG22/#audio-only-and-video-only-prerecorded>) (Level A) — normative
+- [wcag-2.2 1.2.2](<https://www.w3.org/TR/WCAG22/#captions-prerecorded>) (Level A) — normative
+- [wcag-2.2 1.2.3](<https://www.w3.org/TR/WCAG22/#audio-description-or-media-alternative-prerecorded>) (Level A) — normative
+- [wcag-2.2 1.2.5](<https://www.w3.org/TR/WCAG22/#audio-description-prerecorded>) (Level AA) — normative
+- [wcag-2.2-understanding 1.2.1](<https://www.w3.org/WAI/WCAG22/Understanding/audio-only-and-video-only-prerecorded.html>) (Level A) — informative
+- [wcag-2.2-understanding 1.2.2](<https://www.w3.org/WAI/WCAG22/Understanding/captions-prerecorded.html>) (Level A) — informative
+- [wcag-2.2-understanding 1.2.3](<https://www.w3.org/WAI/WCAG22/Understanding/audio-description-or-media-alternative-prerecorded.html>) (Level A) — informative
+- [wcag-2.2-understanding 1.2.5](<https://www.w3.org/WAI/WCAG22/Understanding/audio-description-prerecorded.html>) (Level AA) — informative
+
 Proof: human.
 
 ## semantics.motion-control
 
-Respect reduced-motion preferences and provide controls for moving or time-limited content where required.
+Moving, blinking, or scrolling content that starts automatically, lasts more than five seconds, and appears alongside other content provides pause, stop, or hide controls unless essential. Automatically starting, parallel auto-updating content provides pause, stop, or hide controls or lets the user control update frequency unless essential. Honor reduced-motion preferences as a mechanism for disabling non-essential interaction-triggered animation.
+
+Standards:
+- [wcag-2.2 2.2.2](<https://www.w3.org/TR/WCAG22/#pause-stop-hide>) (Level A) — normative
+- [wcag-2.2 2.3.3](<https://www.w3.org/TR/WCAG22/#animation-from-interactions>) (Level AAA) — normative
+- [wcag-2.2-understanding 2.2.2](<https://www.w3.org/WAI/WCAG22/Understanding/pause-stop-hide.html>) (Level A) — informative
+- [wcag-2.2-understanding 2.3.3](<https://www.w3.org/WAI/WCAG22/Understanding/animation-from-interactions.html>) (Level AAA) — informative
 
 Proof: e2e, human.
 
 ## semantics.name-role-value
 
-Expose the correct accessible name, role, value, and state through the platform accessibility API.
+For every user interface component, the name and role can be programmatically determined; states, properties, and values that users can set can be programmatically set; and notification of changes to these items is available to user agents, including assistive technologies.
+
+Standards:
+- [wcag-2.2 4.1.2](<https://www.w3.org/TR/WCAG22/#name-role-value>) (Level A) — normative
+- [wcag-2.2-understanding 4.1.2](<https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html>) (Level A) — informative
 
 Proof: unit, axe, human.
 
@@ -119,211 +263,882 @@ Proof: unit, axe, human.
 
 Use dialog semantics with a programmatic name and modal state only when interaction is modal.
 
+Standards:
+- [aria-apg dialog-modal](<https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/>) — informative
+- [wai-aria-1.2 dialog](<https://www.w3.org/TR/wai-aria-1.2/#dialog>) — normative
+- [wcag-2.2 4.1.2](<https://www.w3.org/TR/WCAG22/#name-role-value>) (Level A) — normative
+- [wcag-2.2-understanding 4.1.2](<https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html>) (Level A) — informative
+
 Proof: axe, e2e, human.
 
 ## semantics.native-elements
 
 Use the native HTML element whose semantics and behavior match the control before adding ARIA.
 
+Standards:
+- [aria-apg read-me-first](<https://www.w3.org/WAI/ARIA/apg/practices/read-me-first/>) — informative
+- [wai-aria-1.2 host\_general\_conflict](<https://www.w3.org/TR/wai-aria-1.2/#host_general_conflict>) — normative
+
 Proof: axe, human.
 
 ## semantics.non-text-alternative
 
 Meaningful non-text content has an equivalent alternative and decorative content is ignored by assistive technology.
 
+Standards:
+- [wcag-2.2 1.1.1](<https://www.w3.org/TR/WCAG22/#non-text-content>) (Level A) — normative
+- [wcag-2.2-understanding 1.1.1](<https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html>) (Level A) — informative
+
 Proof: axe, human.
 
+## semantics.redundant-entry
+
+Information previously entered by or provided to the user and required again in the same process is auto-populated or available to select, unless re-entry is essential, required for security, or the prior information is no longer valid.
+
+Standards:
+- [wcag-2.2 3.3.7](<https://www.w3.org/TR/WCAG22/#redundant-entry>) (Level A) — normative
+- [wcag-2.2-understanding 3.3.7](<https://www.w3.org/WAI/WCAG22/Understanding/redundant-entry.html>) (Level A) — informative
+
+Proof: e2e, human.
+
 ## semantics.roles-states-properties
 
 Apply only valid ARIA roles, states, and properties and keep exposed state synchronized with rendered behavior.
 
+Standards:
+- [wai-aria-1.2 roles](<https://www.w3.org/TR/wai-aria-1.2/#roles>) — normative
+- [wcag-2.2 4.1.2](<https://www.w3.org/TR/WCAG22/#name-role-value>) (Level A) — normative
+- [wcag-2.2-understanding 4.1.2](<https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html>) (Level A) — informative
+
 Proof: unit, axe, e2e.
 
 ## semantics.selected-state
 
 Selection widgets expose current selection with the state required by their role.
 
+Standards:
+- [wai-aria-1.2 aria-selected](<https://www.w3.org/TR/wai-aria-1.2/#aria-selected>) — normative
+- [wcag-2.2 4.1.2](<https://www.w3.org/TR/WCAG22/#name-role-value>) (Level A) — normative
+- [wcag-2.2-understanding 4.1.2](<https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html>) (Level A) — informative
+
 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.
+Each pointer target contains an axis-aligned 24 by 24 CSS pixel square unless one of these exceptions applies: an undersized target is positioned so that a 24 CSS pixel diameter circle centered on its bounding box does not intersect another target or the corresponding circle for another undersized target; an equivalent control on the same page meets this criterion; the target is in a sentence or its size is otherwise constrained by the line-height of non-target text; the target size is determined by an unmodified user agent; or the target's particular presentation is essential or legally required for the information being conveyed.
+
+Standards:
+- [wcag-2.2 2.5.8](<https://www.w3.org/TR/WCAG22/#target-size-minimum>) (Level AA) — normative
+- [wcag-2.2-understanding 2.5.8](<https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html>) (Level AA) — informative
 
 Proof: e2e, human.
 
 ## pattern.accordion
 
+Standards:
+- [aria-apg accordion](<https://www.w3.org/WAI/ARIA/apg/patterns/accordion/>) — informative
+
 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: unit, axe, e2e, human.
 
 ## pattern.alert
 
+Standards:
+- [aria-apg alert](<https://www.w3.org/WAI/ARIA/apg/patterns/alert/>) — informative
+
 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: unit, human.
 
 ## pattern.carousel
 
+Standards:
+- [aria-apg carousel](<https://www.w3.org/WAI/ARIA/apg/patterns/carousel/>) — informative
+
 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: unit, axe, e2e, human.
+
+## pattern.checkbox
+
+Standards:
+- [aria-apg checkbox](<https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/>) — informative
+
+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.checkbox"}}`
+
+Scope: Standalone, grouped, dual-state, or tri-state checkboxes.
+
+Behavior:
+- Use a native checkbox when it provides the required behavior; otherwise expose checkbox semantics and synchronize checked, unchecked, or mixed state
+- Space toggles the focused checkbox without changing unrelated controls
+- Associate logical groups and any relevant descriptions with programmatic group labels
+
+Product decisions: dual_or_tri_state, group_labeling, mixed_state_cycle.
+
+Functional Spec bindings: fields, states, keyboard.
+
+Implementation outcomes: checkbox-group-semantics, checkbox-state-machine.
+
 Evidence: unit, axe, e2e, human.
 
 ## pattern.combobox
 
+Standards:
+- [aria-apg combobox](<https://www.w3.org/WAI/ARIA/apg/patterns/combobox/>) — informative
+
 Requires: semantics.accessible-name, semantics.expanded-state, semantics.selected-state, semantics.keyboard, semantics.live-status.
 
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.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: unit, axe, e2e, human.
 
 ## pattern.consequential-submission
 
+Standards:
+- [wcag-2.2 3.3.4](<https://www.w3.org/TR/WCAG22/#error-prevention-legal-financial-data>) (Level AA) — normative
+
 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:
-- Support review, correction, confirmation, or reversal
+- 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: e2e, human.
 
 ## pattern.dialog
 
+Standards:
+- [aria-apg dialog-modal](<https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/>) — informative
+
 Requires: semantics.native-dialog, semantics.accessible-name, semantics.keyboard.escape, semantics.focus.initial, semantics.focus.return.
 
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.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: unit, axe, e2e, human.
 
 ## pattern.disclosure
 
+Standards:
+- [aria-apg disclosure](<https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/>) — informative
+
 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: unit, axe, e2e.
 
 ## pattern.dynamic-status
 
+Standards:
+- [wcag-2.2 4.1.3](<https://www.w3.org/TR/WCAG22/#status-messages>) (Level AA) — normative
+
 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: unit, e2e, human.
 
 ## pattern.field
 
+Standards:
+- [wcag-2.2 3.3.2](<https://www.w3.org/TR/WCAG22/#labels-or-instructions>) (Level A) — normative
+- [wcag-2.2 4.1.2](<https://www.w3.org/TR/WCAG22/#name-role-value>) (Level A) — normative
+
 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: unit, axe, human.
 
 ## pattern.image
 
+Standards:
+- [wcag-2.2 1.1.1](<https://www.w3.org/TR/WCAG22/#non-text-content>) (Level A) — normative
+
 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: axe, human.
 
 ## pattern.listbox
 
+Standards:
+- [aria-apg listbox](<https://www.w3.org/WAI/ARIA/apg/patterns/listbox/>) — informative
+
 Requires: semantics.accessible-name, semantics.selected-state, semantics.keyboard, semantics.focus.visible.
 
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.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: unit, axe, e2e, human.
 
 ## pattern.media-player
 
+Standards:
+- [wcag-2.2 1.2.1](<https://www.w3.org/TR/WCAG22/#audio-only-and-video-only-prerecorded>) (Level A) — normative
+- [wcag-2.2 1.2.2](<https://www.w3.org/TR/WCAG22/#captions-prerecorded>) (Level A) — normative
+- [wcag-2.2 1.2.3](<https://www.w3.org/TR/WCAG22/#audio-description-or-media-alternative-prerecorded>) (Level A) — normative
+- [wcag-2.2 1.2.5](<https://www.w3.org/TR/WCAG22/#audio-description-prerecorded>) (Level AA) — normative
+
 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: axe, e2e, human.
 
+## pattern.menu
+
+Standards:
+- [aria-apg menubar](<https://www.w3.org/WAI/ARIA/apg/patterns/menubar/>) — informative
+
+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: unit, axe, e2e, human.
+
 ## pattern.menu-button
 
+Standards:
+- [aria-apg menu-button](<https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/>) — informative
+
 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: unit, e2e, human.
 
 ## pattern.pagination
 
+Standards:
+- [wcag-2.2 2.4.4](<https://www.w3.org/TR/WCAG22/#link-purpose-in-context>) (Level A) — normative
+
 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: unit, axe, human.
 
 ## pattern.popover
 
+Standards:
+- [wcag-2.2 2.1.1](<https://www.w3.org/TR/WCAG22/#keyboard>) (Level A) — normative
+- [wcag-2.2 2.4.3](<https://www.w3.org/TR/WCAG22/#focus-order>) (Level A) — normative
+
 Requires: semantics.native-elements, semantics.accessible-name, semantics.keyboard.escape, semantics.focus.return.
 
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.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: unit, e2e, human.
 
 ## pattern.progress
 
+Standards:
+- [wai-aria-1.2 progressbar](<https://www.w3.org/TR/wai-aria-1.2/#progressbar>) — normative
+- [wcag-2.2 4.1.2](<https://www.w3.org/TR/WCAG22/#name-role-value>) (Level A) — normative
+
 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: unit, axe, human.
 
+## pattern.radio-group
+
+Standards:
+- [aria-apg radio](<https://www.w3.org/WAI/ARIA/apg/patterns/radio/>) — informative
+
+Requires: semantics.accessible-name, semantics.focus.visible, semantics.form-label, semantics.keyboard, semantics.native-elements, semantics.roles-states-properties.
+
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.radio-group"}}`
+
+Scope: Mutually exclusive choices presented as a radio group.
+
+Behavior:
+- Use native grouped radio inputs when they provide the required behavior; otherwise expose a named radiogroup containing named radio controls with exactly one checked item when selected
+- Use one tab stop for group entry, focusing the checked radio or the first radio when none is checked
+- Outside a toolbar, Space selects the focused radio and arrow keys move focus and selection with wrapping; inside a toolbar, toolbar navigation moves focus without changing selection, while Space or optionally Enter checks the focused radio
+
+Product decisions: initial_selection, native_or_custom, toolbar_context, wrap_navigation.
+
+Functional Spec bindings: fields, states, keyboard, focus.
+
+Implementation outcomes: radio-group-keyboard-model, radio-group-labeling, radio-group-selection-model.
+
+Evidence: unit, axe, e2e, human.
+
+## pattern.slider
+
+Standards:
+- [aria-apg slider](<https://www.w3.org/WAI/ARIA/apg/patterns/slider/>) — informative
+- [aria-apg slider-multithumb](<https://www.w3.org/WAI/ARIA/apg/patterns/slider-multithumb/>) — informative
+
+Requires: semantics.accessible-name, semantics.dragging-alternative, semantics.focus.visible, semantics.keyboard, semantics.name-role-value, semantics.native-elements, semantics.roles-states-properties.
+
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.slider"}}`
+
+Scope: Single-thumb or multi-thumb bounded range input.
+
+Behavior:
+- Use a native input[type=range] for a single-thumb slider when it supplies the required range, step, orientation, labeling, and value presentation; use a custom slider only when native behavior cannot satisfy the declared interaction
+- Expose every focusable thumb as a distinct named slider with synchronized current, minimum, maximum, orientation, and user-friendly value text when the numeric value is insufficient
+- Right and Up increase by one step while Left and Down decrease by one step unless a documented orientation and value presentation makes reversal more intuitive; Home and End move to range bounds, and optional Page Up and Page Down apply the declared larger step
+- Provide an equivalent single-pointer method for every drag operation that does not require dragging, such as track activation or an adjacent value input
+- Keep every thumb in a constant tab order for multi-thumb sliders and update dependent thumb bounds whenever another thumb changes them
+- Verify operation with touch-based assistive technology on target devices before production use
+
+Product decisions: direction_mapping, large_step, native_or_custom, orientation, single_or_multi_thumb, step, thumb_constraints, value_text.
+
+Functional Spec bindings: fields, states, keyboard, controls.
+
+Implementation outcomes: slider-keyboard-model, slider-native-control-selection, slider-range-state, slider-touch-at-compatibility.
+
+Evidence: unit, axe, e2e, human.
+
+## pattern.spinbutton
+
+Standards:
+- [aria-apg spinbutton](<https://www.w3.org/WAI/ARIA/apg/patterns/spinbutton/>) — informative
+
+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: unit, axe, e2e, human.
+
 ## pattern.tabs
 
+Standards:
+- [aria-apg tabs](<https://www.w3.org/WAI/ARIA/apg/patterns/tabs/>) — informative
+
 Requires: semantics.accessible-name, semantics.selected-state, semantics.keyboard, semantics.focus.visible.
 
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.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: unit, axe, e2e, human.
 
 ## pattern.tooltip
 
+Standards:
+- [aria-apg tooltip](<https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/>) — informative
+
 Requires: semantics.accessible-name, semantics.keyboard.escape.
 
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.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: unit, e2e, human.
 
+## pattern.tree-view
+
+Standards:
+- [aria-apg treeview](<https://www.w3.org/WAI/ARIA/apg/patterns/treeview/>) — informative
+
+Requires: semantics.accessible-name, semantics.expanded-state, semantics.focus.visible, semantics.keyboard, semantics.roles-states-properties, semantics.selected-state.
+
+Activation: `{"contains":{"fact":"component.accessibility_pattern_ids","value":"pattern.tree-view"}}`
+
+Scope: Hierarchical single-select or multi-select tree widgets.
+
+Behavior:
+- Expose tree, treeitem, and group relationships, set aria-multiselectable for a multi-select tree, and provide level, position, and set-size metadata when the complete hierarchy is not represented in the DOM
+- On tree entry, focus the selected node or first selected node when one exists and otherwise focus the first node; keep one composite tab stop and keep focus visually distinct from selection
+- In a vertical tree, Right Arrow opens a closed parent without moving focus, moves from an open parent to its first child, and does nothing on an end node; Left Arrow closes an open parent, moves from a closed parent or end node to its parent, and does nothing on a root node that cannot close
+- In a vertical tree, Down Arrow moves to the next visible focusable node and Up Arrow moves to the previous visible focusable node without changing expansion; Home and End move to the first and last visible focusable nodes, Enter performs the node's declared default action, and type-ahead moves to the next matching node
+- For a horizontal tree, remap Down Arrow to the vertical Right Arrow behavior, Right Arrow to vertical Down Arrow, Up Arrow to vertical Left Arrow, and Left Arrow to vertical Up Arrow
+- Keep focus distinct from selection and synchronize expansion and the declared aria-selected or aria-checked state model without exposing both states for the same selection purpose
+- For a multi-select tree using the recommended modifier-free model, navigation does not clear selection, Space toggles selection of the focused node, and declared Shift combinations extend contiguous selection; for the alternative modifier-required model, unmodified navigation selects only the focused node while Control plus an arrow moves focus without changing selection and Control plus Space toggles the focused node
+
+Product decisions: focus_strategy, multi_select_keyboard_model, orientation, selection_follows_focus, selection_state, single_or_multi_select, typeahead, virtualization.
+
+Functional Spec bindings: behavior, states, keyboard, focus.
+
+Implementation outcomes: tree-hierarchy-semantics, tree-keyboard-model, tree-selection-model.
+
+Evidence: unit, axe, e2e, human.
+
 ## pattern.validation
 
+Standards:
+- [wcag-2.2 3.3.1](<https://www.w3.org/TR/WCAG22/#error-identification>) (Level A) — normative
+- [wcag-2.2 3.3.3](<https://www.w3.org/TR/WCAG22/#error-suggestion>) (Level AA) — normative
+
 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: 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.dragging-alternative
+
+When: `{"equals":{"fact":"interaction.has_dragging","value":true}}`
+
+Outcomes: semantics.dragging-alternative.
+
+Evidence: e2e, 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.accessible-authentication
+
+When: `{"equals":{"fact":"flow.has_authentication","value":true}}`
+
+Outcomes: semantics.accessible-authentication.
+
+Evidence: e2e, human.
+
+## applicability.redundant-entry
+
+When: `{"equals":{"fact":"flow.repeats_entry","value":true}}`
+
+Outcomes: semantics.form-label, semantics.redundant-entry.
+
+Evidence: e2e, human.
+
+## applicability.consistent-help
+
+When: `{"equals":{"fact":"artifact.has_repeated_help_across_page_set","value":true}}`
+
+Outcomes: semantics.consistent-help.
+
+Evidence: e2e, human.
+
+## applicability.data-table
+
+When: `{"equals":{"fact":"component.has_data_table","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.
+
+## WCAG 2.2 Level A/AA coverage
+
+Coverage is criterion-level traceability, not a conformance claim: 16 covered, 8 partial, and 31 gaps.
+
+| Criterion | Title | Level | Status | Semantic IDs | Note |
+| --- | --- | --- | --- | --- | --- |
+| 1.1.1 | Non-text Content | A | partial | semantics.non-text-alternative | 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. |
+| 1.2.1 | Audio-only and Video-only (Prerecorded) | A | partial | semantics.media-alternatives | The shared media rule does not distinguish every audio-only and video-only alternative. |
+| 1.2.2 | Captions (Prerecorded) | A | partial | semantics.media-alternatives | Captions are required broadly, without a criterion-specific prerecorded contract. |
+| 1.2.3 | Audio Description or Media Alternative (Prerecorded) | A | partial | semantics.media-alternatives | The shared media rule covers both alternatives but does not encode the criterion's conditional choice. |
+| 1.2.4 | Captions (Live) | AA | gap | — | No semantic rule requires live captions. |
+| 1.2.5 | Audio Description (Prerecorded) | AA | partial | semantics.media-alternatives | Audio description is named, but prerecorded applicability is not represented independently. |
+| 1.3.1 | Info and Relationships | A | partial | semantics.data-table, semantics.form-label, semantics.form-required, semantics.headings, semantics.landmarks | Several structural cases are covered, but the general criterion is broader than the current rules. |
+| 1.3.2 | Meaningful Sequence | A | gap | — | No semantic rule explicitly preserves meaningful reading sequence. |
+| 1.3.3 | Sensory Characteristics | A | gap | — | No semantic rule prevents instructions from relying only on sensory characteristics. |
+| 1.3.4 | Orientation | AA | gap | — | No semantic rule prevents unnecessary orientation restrictions. |
+| 1.3.5 | Identify Input Purpose | AA | gap | — | No semantic rule requires programmatic input-purpose tokens. |
+| 1.4.1 | Use of Color | A | gap | — | No semantic rule prohibits color-only communication. |
+| 1.4.2 | Audio Control | A | gap | — | No semantic rule requires independent control of automatically playing audio. |
+| 1.4.3 | Contrast (Minimum) | AA | gap | — | No semantic rule defines minimum text contrast. |
+| 1.4.4 | Resize Text | AA | gap | — | No semantic rule defines text resizing behavior. |
+| 1.4.5 | Images of Text | AA | gap | — | Text alternatives do not replace a rule limiting images of text. |
+| 1.4.10 | Reflow | AA | gap | — | No semantic rule defines responsive reflow requirements. |
+| 1.4.11 | Non-text Contrast | AA | gap | — | No semantic rule defines contrast for controls, states, or graphical objects. |
+| 1.4.12 | Text Spacing | AA | gap | — | No semantic rule protects content under user-adjusted text spacing. |
+| 1.4.13 | Content on Hover or Focus | AA | gap | — | Pattern behavior exists for tooltips, but no semantic rule covers dismissibility, hoverability, and persistence together. |
+| 2.1.1 | Keyboard | A | covered | semantics.keyboard | — |
+| 2.1.2 | No Keyboard Trap | A | covered | semantics.keyboard | — |
+| 2.1.4 | Character Key Shortcuts | A | gap | — | Keyboard operability does not define shortcut remapping or deactivation. |
+| 2.2.1 | Timing Adjustable | A | gap | — | No semantic rule encodes timing adjustment and its exceptions. |
+| 2.2.2 | Pause, Stop, Hide | A | covered | semantics.motion-control | — |
+| 2.3.1 | Three Flashes or Below Threshold | A | gap | — | No semantic rule limits flashing content. |
+| 2.4.1 | Bypass Blocks | A | gap | — | Landmarks alone do not establish a required bypass mechanism. |
+| 2.4.2 | Page Titled | A | gap | — | No semantic rule requires descriptive page titles. |
+| 2.4.3 | Focus Order | A | gap | — | Pattern focus lifecycles do not establish document-wide focus order. |
+| 2.4.4 | Link Purpose (In Context) | A | gap | — | No semantic rule explicitly defines contextual link purpose. |
+| 2.4.5 | Multiple Ways | AA | gap | — | No semantic rule requires multiple ways to locate pages. |
+| 2.4.6 | Headings and Labels | AA | partial | semantics.headings | Heading structure is covered, but a unified descriptive-purpose rule for all headings and labels is absent. |
+| 2.4.7 | Focus Visible | AA | covered | semantics.focus.visible | — |
+| 2.4.11 | Focus Not Obscured (Minimum) | AA | covered | semantics.focus.visible | — |
+| 2.5.1 | Pointer Gestures | A | gap | — | Keyboard operation does not guarantee a single-pointer alternative to multipoint or path-based gestures. |
+| 2.5.2 | Pointer Cancellation | A | gap | — | No semantic rule defines down-event cancellation behavior. |
+| 2.5.3 | Label in Name | A | covered | semantics.accessible-name | — |
+| 2.5.4 | Motion Actuation | A | gap | — | No semantic rule addresses device or user motion actuation. |
+| 2.5.7 | Dragging Movements | AA | covered | semantics.dragging-alternative | — |
+| 2.5.8 | Target Size (Minimum) | AA | covered | semantics.target-size | — |
+| 3.1.1 | Language of Page | A | gap | — | No semantic rule explicitly requires the default page language. |
+| 3.1.2 | Language of Parts | AA | gap | — | No semantic rule explicitly identifies changes in human language. |
+| 3.2.1 | On Focus | A | gap | — | No semantic rule prohibits unexpected context changes on focus. |
+| 3.2.2 | On Input | A | gap | — | No semantic rule prohibits unexpected context changes on input. |
+| 3.2.3 | Consistent Navigation | AA | gap | — | Landmarks do not establish consistent repeated navigation order. |
+| 3.2.4 | Consistent Identification | AA | gap | — | No semantic rule requires consistent identification of repeated components. |
+| 3.2.6 | Consistent Help | A | covered | semantics.consistent-help | — |
+| 3.3.1 | Error Identification | A | covered | semantics.form-error | — |
+| 3.3.2 | Labels or Instructions | A | partial | semantics.form-label, semantics.form-required | Labels and requiredness are covered, but a dedicated rule for format and task-specific input instructions is absent. |
+| 3.3.3 | Error Suggestion | AA | covered | semantics.form-error | — |
+| 3.3.4 | Error Prevention (Legal, Financial, Data) | AA | covered | semantics.consequential-action | — |
+| 3.3.7 | Redundant Entry | A | covered | semantics.redundant-entry | — |
+| 3.3.8 | Accessible Authentication (Minimum) | AA | covered | semantics.accessible-authentication | — |
+| 4.1.2 | Name, Role, Value | A | covered | semantics.accessible-name, semantics.expanded-state, semantics.name-role-value, semantics.native-dialog, semantics.roles-states-properties, semantics.selected-state | — |
+| 4.1.3 | Status Messages | AA | covered | semantics.alert, semantics.live-status | — |
+
+### Deferred APG patterns
+
+- alert-dialog: Deferred until dialog purpose distinguishes urgent confirmation or attention from a general modal dialog.
+- grid: Deferred until a static-versus-interactive grid discriminator and keyboard interaction model are defined.
+- switch: Deferred until a binary toggle model distinguishes switch behavior from a generic form field.
+- toolbar: Deferred until control-group behavior and its focus-management model are defined.
+- treegrid: Deferred until static-versus-interactive grid selection and the hierarchical tree interaction model are defined.
+
+## Evidence routing
+
+Tool availability changes the evidence route, never requirement applicability. A missing required capability is a blocker.
+
+- axe: automated rule evidence; capability: axe
+- e2e: keyboard, focus, and integrated behavior; capability: e2e
+- human: judgment, assistive technology, content, and visual evidence; capability: human
+- unit: semantic state and deterministic resolver behavior; capability: unit