styleproof 4.0.0 → 4.0.1

package/CHANGELOG.md

@@ -7,6 +7,17 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [4.0.1] - 2026-07-07
+
+### Fixed
+
+- **Unset capture specs no longer inflate Playwright's skipped-test count.** When
+  `defineStyleMapCapture({ dir: process.env.STYLEMAP_DIR, ... })` or
+  `defineCrawlCapture({ dir: process.env.STYLEMAP_DIR, ... })` runs with no `dir`,
+  StyleProof now returns before registering generated capture tests instead of
+  registering one skipped test per surface. Static `expected` coverage guards still
+  run in the normal suite. (#215)
+
 ## [4.0.0] - 2026-07-07
 
 The first major since v3. Three breaking defaults make StyleProof strict out of

package/dist/runner.js

@@ -655,7 +655,6 @@ function writeBrowserBuildTest(settings, dir) {
 }
 export function defineStyleMapCapture(options) {
     const { surfaces, expected, exclude = {}, dir } = options;
-    const settings = resolveSettings(options);
     const captureSurfaces = surfaces.flatMap(expandSurfaceVariants);
     assertUniqueExpandedKeys(captureSurfaces);
     // Coverage guard. Runs in the NORMAL test suite (NOT gated on a capture dir), so
@@ -678,12 +677,12 @@ export function defineStyleMapCapture(options) {
             });
         });
     }
+    if (!dir)
+        return;
+    const settings = resolveSettings(options);
     test.describe('styleproof capture', () => {
-        test.skip(!dir, 'set STYLEMAP_DIR=<label> to capture computed-style maps');
-        if (dir)
-            writeCoverageLedgerTest(settings, dir, expected ?? null, exclude, captureSurfaces);
-        if (dir)
-            writeBrowserBuildTest(settings, dir);
+        writeCoverageLedgerTest(settings, dir, expected ?? null, exclude, captureSurfaces);
+        writeBrowserBuildTest(settings, dir);
         for (const surface of captureSurfaces) {
             if (surface.widths && surface.widths.length > 0) {
                 // Explicit widths: one parallelizable test per surface × width.
@@ -785,11 +784,12 @@ async function sweepCrawlSurfaces(page, captureSurfaces, settings) {
 }
 export function defineCrawlCapture(options) {
     const { from, match, key, widths, height, ignore, variants, liveStates, popups, linkTimeout = 15_000, dir, settle, expected, exclude = {}, } = options;
+    if (!dir)
+        return;
     const settings = resolveSettings(options);
     // Title contains "styleproof capture" so the same `--grep 'styleproof capture'`
     // that styleproof-map uses to select capture tests picks up crawl specs too.
     test.describe('styleproof capture (crawl)', () => {
-        test.skip(!dir, 'set STYLEMAP_DIR=<label> to capture computed-style maps');
         // Record the completeness basis. Without `expected` a crawl has no registry to
         // check against, so it records `expected: null` (honestly "not asserted": it
         // captures what the nav links to, and can't prove that's every route). With
@@ -800,10 +800,8 @@ export function defineCrawlCapture(options) {
         // `expected` key with this crawl's variants/liveStates to get the keys captured to
         // disk, so a liveStates crawl's ledger is pre-translated like the spec-driven one.
         const ledgerSurfaces = (expected ?? []).flatMap((key) => expandSurfaceVariants({ key, go: async () => { }, variants, liveStates }));
-        if (dir)
-            writeCoverageLedgerTest(settings, dir, expected ?? null, exclude, ledgerSurfaces);
-        if (dir)
-            writeBrowserBuildTest(settings, dir);
+        writeCoverageLedgerTest(settings, dir, expected ?? null, exclude, ledgerSurfaces);
+        writeBrowserBuildTest(settings, dir);
         test('discover surfaces by crawling links, then capture each', async ({ page }) => {
             // 1. Load the root and read its hydrated nav links into the surface set.
             const links = await discoverCrawlLinks(page, { from, match, key, linkTimeout });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "styleproof",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Catch every CSS change before it ships — review PRs and certify refactors by the browser's computed styles, not pixels. Works with any styling system.",
   "keywords": [
     "playwright",