test(a11y): add disclosure accessibility contract

[cixzhang]

Maintainer impact

People who use disclosure-style components need the exposed expanded state, controlled content, keyboard behavior, pointer behavior, and focus result to stay aligned. Contract authors and component maintainers now get one reusable failure signal instead of repeating partial assertions in each component.

Intended invariant

AST-020 governs accessibility contract authoring, AST-021 governs component binding, and the current Collapsible contract owns the first binding.

This PR preserves Collapsible runtime behavior and public API. It adds executable evidence only.

Change

Standalone Disclosure contract

Expectation	Authority	Evidence	Enforcement
disclosure.state.expanded	WCAG 2.2 4.1.2 + APG state	DOM	required
disclosure.relationship.controls	WCAG 2.2 1.3.1 + APG optional relationship	DOM	required when declared
disclosure.content.matches-state	WCAG 2.2 4.1.2 + APG state	DOM + Chromium	required
disclosure.state.pointer-round-trip	WCAG 2.2 4.1.2 + APG interaction	DOM + Chromium	required when operable
disclosure.state.enter-round-trip	WCAG 2.2 2.1.1 + APG Enter	DOM + Chromium	required when operable/focusable
disclosure.state.space-round-trip	WCAG 2.2 2.1.1 + APG Space	DOM + Chromium	required when operable/focusable
disclosure.state.survives-an-aborted-press	WCAG 2.2 2.5.2	DOM + Chromium	required when operable
disclosure.focus.stays-on-trigger	WCAG 2.2 3.2.2	DOM + Chromium	required when operable/focusable

Every expectation has at least one deliberately violating fixture. The contract records an explicit owner and verification path for every remaining AST-020 checklist dimension.

First binding: standalone Collapsible

State	Expanded	Owner	Availability	Position/direction
uncontrolled open	yes	internal	enabled	end / LTR
uncontrolled closed	no	internal	enabled	start / RTL
controlled open	yes	caller	enabled	end / LTR
controlled closed	no	caller	enabled	start / LTR
disabled open	yes	internal	unavailable	end / LTR
disabled closed	no	internal	unavailable	start / RTL

Component jsdom bindings use expectAccessibilitySpec; fixture, browser, and aggregate-reporting paths use checkAccessibilitySpec. Duplicate local assertions were removed only where the shared contract now provides the same or stronger proof.

Evidence

• Failure before the change: deliberate missing-state and broken-relationship fixtures passed when their assertions were replaced with no-ops. The earlier browser draft also exposed one-way, state-only, Enter, and Space fixtures as false passes.
• Success after the change: 19 Disclosure jsdom tests and 87 Collapsible tests pass, including all deliberate DOM mutations and all six component states.
• Browser proof: checked-in generic and Collapsible Chromium suites run every applicable expectation, reject every deliberate mutation, verify the binding facts, and require zero blocking results or unrun layers. Exact-head pr-a11y passed all 538 Chromium contract tests at 9ea2ef6abfcdf9e3bafcb23db605fe82ea8f5853.
• Known failures: none recorded. This PR does not convert failures to exemptions or known debt.
• Product/runtime behavior verified unchanged: no runtime implementation or exported API changed; existing component-specific callback, controlled-state, unavailable-state, group, styling, and chevron tests remain.

Scope

• No intended public API, product behavior, visual direction, or policy change.
• Product changes discovered during the work were removed or split.
• Public text and artifacts contain no internal Meta context.

Not adopted here: Accordion, CollapsibleGroup, Table, or SideNav. Generic button role, accessible name, focus navigation, and unavailable semantics remain owned by the button contract and existing Collapsible-local tests.

Open-work search found no competing standalone Disclosure contract. #6349 overlaps only shared package index/documentation files; #6232 is Table column-resize disclosure specification; #6065 is a Table template.

Testing

• pnpm vitest run --project node internal/a11y-spec/src/patterns/disclosure.jsdom.test.ts
• pnpm vitest run --project ui packages/core/src/Collapsible
• pnpm -F @astryxdesign/a11y-spec typecheck
• pnpm -F @astryxdesign/core typecheck
• pnpm -F @astryxdesign/storybook typecheck
• pnpm check:repo
• pnpm build
• pnpm storybook:build
• focused ESLint, Prettier, and git diff --check

Exact reviewed head: 9ea2ef6abfcdf9e3bafcb23db605fe82ea8f5853.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
astryx	Ready	Preview	Sep 19, 2026 8:59pm UTC

[astracat-bot]

AI review status for this pull request.

Review status	Updated
📝 Draft — not reviewed automatically (for maintainers only)	Sep 17, 2026, 11:55 AM UTC

[github-actions]

PR Analysis Report

Preview availability: Storybook and Sandbox were not published for this CI run.

No new or modified components detected.

Bundle Size Summary

Package	Size (ESM)	Size (CJS)	Gzipped
@astryxdesign/core	N/A	4.8KB	1.2KB

Accessibility Audit

Status: 36 accessibility violation(s) found — 2 critical, 34 serious.

Button pattern - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/18 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

ChatComposer - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/18 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

ChatComposerInput - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/14 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

ChatReasoning - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 4/5 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

ChatToolCalls - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 10/11 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Checkbox pattern - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 2/33 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

CheckboxList - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 4/17 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

ClickableCard - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/5 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

CodeEditor - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 3/7 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

CodeEditorPerf - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 2/2 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

CodeEditorTheme - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 13/14 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

CodeTheme - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 14/16 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

DateRangeInput - 1 issue(s)

• 🔴 critical: Ensure an element's role supports its ARIA attributes
  • Rule: aria-allowed-attr · Affects 1/21 stories · Learn more
  • WCAG: 4.1.2 (Level A)

FileInput - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 3/15 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

GridMasonry - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/3 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Heading - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/16 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Icon - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/18 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

LogStream - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 2/3 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

MediaTheme Auto - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/5 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

PowerSearch - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 2/26 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

ProgressBar - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 2/18 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Radio group pattern - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 3/26 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

RadioList - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 3/13 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

RichTextEditor - 2 issue(s)

• 🟠 serious: Ensure every ARIA input field has an accessible name
  • Rule: aria-input-field-name · Affects 2/18 stories · Learn more
  • WCAG: 4.1.2 (Level A)
• 🔴 critical: Ensure every form element has a label
  • Rule: label · Affects 1/18 stories · Learn more
  • WCAG: 4.1.2 (Level A)

SelectableCard - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/4 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Stepper - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/30 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

TableGroupedRows - 1 issue(s)

• 🟠 serious: Ensure ARIA attributes are used as described in the specification of the element's role
  • Rule: aria-conditional-attr · Affects 3/3 stories · Learn more
  • WCAG: 4.1.2 (Level A)

TableTree - 1 issue(s)

• 🟠 serious: Ensure ARIA attributes are used as described in the specification of the element's role
  • Rule: aria-conditional-attr · Affects 8/9 stories · Learn more
  • WCAG: 4.1.2 (Level A)

Text - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/23 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Theme - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/5 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

PopArt - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 3/6 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Thumbnail - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/12 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Timestamp - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 1/20 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Token - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 2/10 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

Tokenizer - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 2/24 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

---

_{Generated by PR Enrichment workflow | View full report}