Skip to content

fix(vrt): normalize snapshot layout and platform policy - #175

Merged
jenil merged 1 commit into
v1from
work/173-normalize-vrt
Jul 30, 2026
Merged

jenil merged 1 commit into
v1from
work/173-normalize-vrt

Conversation

@jenil

@jenil jenil commented Jul 30, 2026

Copy link
Copy Markdown
Owner

Outcome

Normalize Chromium VRT snapshot layout and document platform policy.

Problem

Mixed snapshot conventions across the repository:

  • 6 unsuffixed *-chromium.png files (no platform suffix, never resolved by any execution path)
  • 3 stale platform-duplicates in grouped-controls subdirectory (no spec writes to these paths)
  • 4 orphaned root-level grouped-controls artifact files (spec now writes to subdirectory)

Changes

  • Deleted 11 stale snapshot files (no active consumer)
  • Modified test/vrt/README.md: added snapshot layout and platform policy section documenting:
    • How Playwright resolves toMatchSnapshot arguments to platform-specific paths
    • Linux Chromium as required merge evidence
    • macOS Chromium as supported local validation
    • Artifact vs. baseline distinction (direct page.screenshot({ path }) files)
    • Updated test structure diagram

Evidence

  • yarn test:vrt — 19 passed (11.2s)
  • yarn test (stylelint) — PASS
  • git diff --check — PASS (no whitespace errors)
  • Complete assertion-to-baseline mapping: test/vrt/snapshot-mapping-173.md (untracked, for review)

Impact

  • No production CSS changes
  • No public API changes
  • No config changes (playwright.config.js, CI workflows untouched)
  • No weakening of screenshot assertions, visual thresholds, a11y, or API coverage
  • 36 active snapshot files preserved (35 VRT baselines + 1 artifact-only)

Remove 11 stale/unreferenced snapshot files, document platform policy
in README. No CSS/config changes.

Stale files (no platform suffix or orphaned root-level):
- 6 unsuffixed *-chromium.png (index, components)
- 3 stale platform-duplicates (grouped-controls subdirectory)
- 4 orphaned root-level grouped-controls artifacts

Active baselines preserved: 36 files (35 VRT + 1 artifact-only).

Proven via Playwright failure output: toMatchSnapshot('<arg>') resolves
to test/vrt/snapshots/<spec>-snapshots/<arg>-chromium-<platform>.png
@jenil
jenil merged commit 98a9c6e into v1 Jul 30, 2026
2 checks passed
@jenil
jenil deleted the work/173-normalize-vrt branch July 30, 2026 23:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant