attest_flutter 1.5.0

Flutter widget-test integration for attest: a WidgetTester accessibility audit, raster and text-scale collectors, and gate matchers for CI.

Changelog

All notable changes to this package are documented here. The format follows Keep a Changelog and this project adheres to Semantic Versioning.

1.5.0 - 2026-07-15

Changed

• The contrast raster pass is substantially faster on busy screens. The background scan now reads packed pixels straight from the buffer instead of allocating an object per pixel, and it subsamples large text boxes with a stride — the background is taken as the mode, which a uniform stride over a solid field leaves unchanged. On a 240-node screen collection dropped from ~145 ms to ~40 ms (the pixel scan itself ~13× faster; the remaining cost is the fixed rasterization). Measured ratios are unchanged: the reference pairs still validate, and a new test pins that a box far larger than the sampling cap yields the same contrast. No API change.

1.4.0 - 2026-07-15

Added

• The gate-failure output now prints a finding's codeExample — a ready-to-paste // Before / // After snippet — indented under the fix, so the remedy is right there in the failing test. Requires attest 1.10.0.

1.3.0 - 2026-07-15

Added

• The gate-failure output now adds a "Learn:" line under each violation with the W3C "Understanding" URL for its criterion, so the path from a failing test to the authoritative guidance is one click. Requires attest 1.9.0.

1.2.2 - 2026-07-14

Added

• Documented auditing on a device with integration_test: auditAccessibility works unchanged on a live binding, so the rendered app can be audited on a device or desktop (native semantics, real focus). A runnable example lives at example/integration_test. Contrast needs a debug build; the overflow pass relies on a test-only re-pump, so start with textScales: [1.0] on device.

1.2.1 - 2026-07-02

Changed

• Require attest 1.7.0 for FlowAnalysis, which diffs auditFlow reports to show which step introduced a barrier; documented in the flow section.

1.2.0 - 2026-07-02

Added

• tester.auditFlow(...) and AuditStep: audit across interactions, not just one static screen. It drives a scripted flow (tap, scroll, navigate) and re-audits after each step, catching barriers that only appear in motion — an unlabeled control in a dialog, semantics that break on a state change, a focus trap that only exists post-navigation. Returns one labelled report per step. Experimental; the flow API will grow.

1.1.2 - 2026-07-02

Changed

• Require attest 1.6.0, which adds the attest/generic-link-text rule (WCAG 2.4.4): links with vague text like "read more" are now flagged. No API change in this package.

1.1.1 - 2026-07-02

Changed

• Require attest 1.5.0, which adds the attest/adjustable-value rule (WCAG 4.1.2): sliders and steppers that expose no current value are now flagged. No API change in this package.

1.1.0 - 2026-07-02

Added

• The raster collector detects icon glyphs (Private Use Area code points) and marks their samples as non-text, so the new attest/non-text-contrast rule (WCAG 1.4.11) can hold them to the 3:1 minimum. Requires attest 1.1.0.

Fixed

• A small icon whose contrast is between 3:1 and 4.5:1 is no longer flagged as a text-contrast failure.

1.0.0 - 2026-07-02

First stable release. Requires attest 1.0.0.

Added

• The snapshot builder captures the developer-assigned SemanticsProperties.identifier, and the raster collector attaches the nearest semantics identifier to each contrast sample, so findings can be anchored to an authored, stable id.
• Reference validation of the measurement paths: the contrast pipeline is checked end to end against a table of known colour pairs (within 0.1 of independently computed WCAG ratios), gradient and disabled-control abstention are pinned by test, and the overflow fixture is proven to fit at text scale 1.0 and overflow at 2.0.

Changed

• The public API is frozen for 1.0: auditAccessibility, the gate matchers and the re-exported core are stable within a major. The plumbing classes (SemanticsSnapshotBuilder, RasterCollector, TextScaleCollector) are annotated @experimental — ordinary tests never need them directly, and their signatures may still evolve for integration_test support.
• Stated the version-support policy: Flutter ≥ 3.32 is a hard floor (the tri-state flagsCollection semantics API), with the current and previous three stable Flutter releases supported and each new stable tracked within one release cycle.

0.9.0

Changed

• Require attest 0.9.0 (state-exposed now fires on pairs).

0.8.3

Fixed

• Report the correct tool version. attestVersion was stuck at 0.1.0, so the report metadata and SARIF tool.driver.version were wrong; it is now kept in sync with the package version by a test.

0.8.2

Fixed

• Correct the SDK constraint: the package uses the SemanticsData.flagsCollection tri-state API, so it requires Flutter >= 3.32.0 (Dart >= 3.8.0). The previous >= 3.27.0 bound was inaccurate and would fail to compile on 3.27–3.31.

0.8.1

Changed

• Source locations now prefer the user's own code: the resolver walks up from the creating element and returns the first location outside the Flutter SDK and pub packages, so a finding on a wrapped Material control points at where the developer used it rather than at framework internals.

0.8.0

Changed

• The audited standard pack comes from RuleConfig.standard and is recorded in the report metadata. Requires attest 0.8.0.

0.7.0

Added

• auditAccessibility attaches a screen-reader transcript to the report by default (opt out with transcript: false). Requires attest 0.7.0.

0.6.1

Changed

• Allow (and require) attest 0.6.0.

0.6.0

Added

• The snapshot builder now records each text node's font size and weight (from the render tree), which the heading-structure rule reads.

Fixed

• Children are captured in the real traversal order (sort keys + geometry) via debugListChildrenInOrder, not the raw child order, so the focus-order rule no longer false-positives on a standard Scaffold app bar.

0.5.0

Added

• Findings now carry a source location. The snapshot builder recovers each node's originating widget location from the render tree's debug creator (via a new renderRoot argument), so a failure points at file:line. Best-effort: it relies on --track-widget-creation (on by default under flutter test).

0.4.0

Added

• RasterCollector and the contrast flag on auditAccessibility: the screen is rasterized and each text node's contrast against its real background is measured for the contrast rule. Requires attest 0.4.0.

0.3.0

Added

• TextScaleCollector and the textScales parameter on auditAccessibility: the screen is re-pumped at enlarged text sizes and layout overflow is captured into the snapshot for the text-overflow rule. Requires attest 0.3.0.

0.2.0

Changed

• The snapshot builder now resolves node bounds to logical pixels (dividing the accumulated physical rect by the view's device pixel ratio), so the geometry rules see real sizes. Requires attest 0.2.0.

0.1.0

Added

• SemanticsSnapshotBuilder, which converts a live Flutter semantics tree into the pure-Dart SemanticsSnapshot (mapping the 3.x flagsCollection API).
• WidgetTester.auditAccessibility(), the one-call audit entry point (tree rules only).
• The gate matchers passesAccessibilityGate(), hasNoAccessibilityViolations() and hasNoViolationsForCriterion(), with grouped, criterion-tagged failure output.