Skip to content

Choose a tag to compare

@bmatar bmatar released this 17 Jun 06:43

Tactual 0.5.0 is a major capability release focused on modern SPA capture, embedded-frame accessibility trees, richer AT navigation modeling, and release-grade calibration evidence.

Highlights

  • SPA capture reliability: framework-aware settling, convergence polling, route-change tracking, lazy-content auto-scroll, banner dismissal, hover-content probing, tab-order walking, and desktop/mobile viewport diffs.
  • Cross-origin iframe coverage: Chromium CDP fallback can recover many OOPIF accessibility trees that Playwright frame-scoped ariaSnapshot cannot access.
  • Deeper AT-tree modeling: richer navigation strategies for rotor/element-list jumps, forms mode, touch exploration, relationship jumps, active descendants, and composite-widget arrow traversal.
  • Expanded diagnostics: broader structural, ARIA, visual, media, metadata, language, repeated-navigation, viewport, and color-vision-deficiency checks.
  • Calibration workflow: modeled-vs-observed announcement fields, calibration_report, NVDA VM observation tooling, and a versioned calibration corpus for reachability tuning.
  • Surface parity: CLI, MCP, and GitHub Action inputs are aligned for the 0.5 capture/probe surface.
  • Packaging: Playwright is now a runtime dependency of tactual; browser binaries still use the standard Playwright install step.

Upgrade Notes

Scores, diagnostics, JSON baselines, SARIF findings, and CI thresholds may change on unchanged pages because 0.5.0 captures more evidence by default. Regenerate 0.4.x baselines before using 0.5.0 as a regression gate.

MCP URL-taking tools now reject file: URLs. CLI and library workflows still accept file: URLs for local fixture and offline workflows.

Visual diagnostics such as low contrast, color-only conveyance, CVD contrast loss, visual-order divergence, and language-switch detection should be treated as review prompts that need page-context confirmation.

Install

npm install -g tactual@0.5.0
npx playwright install chromium

or:

npx tactual@0.5.0 analyze-url https://example.com --detect-routes --auto-scroll --descend-frames

### Verification

- CI is green on Node 20 and Node 22.
- npm run test:release passed locally.
- npm audit --omit=dev reports 0 vulnerabilities.
- ARIA-AT simulator calibration remains 77/77 token assertions across NVDA, JAWS, and VoiceOver.