styleproof 3.2.0 → 3.4.0

package/dist/report.js

@@ -8,8 +8,7 @@ import { describeChange, tokenIndex, toHex, trackCount } from './describe.js';
 // through the package's report module rather than a deep path.
 export { describeChange, colorName, tokenIndex, toHex } from './describe.js';
 // Hidden marker appended to a new-surface heading. Invisible in rendered
-// markdown; lets the PR-comment layer attach an OPTIONAL "approve" box to a new
-// surface (vs the required box on a real change), so new surfaces never gate.
+// markdown; lets the PR-comment layer recognize one-sided surfaces.
 const NEW_SURFACE_MARKER = '<!-- styleproof-new -->';
 const rectToBox = (r) => ({ x: r[0], y: r[1], w: r[2], h: r[3] });
 const pad = (b, by) => ({ x: b.x - by, y: b.y - by, w: b.w + 2 * by, h: b.h + 2 * by });
@@ -910,8 +909,8 @@ export function generateStyleMapReport(opts) {
         if (missing.length > 0) {
             if (changeGroups.length > 0)
                 md.push('');
-            md.push(`🆕 **${missing.length} new surface(s)** captured with no baseline to compare — shown below for reference. ` +
-                `New surfaces don't block the check.`);
+            md.push(`🆕 **${missing.length} new surface(s)** captured with no baseline to compare — shown below for review. ` +
+                `Approve them before they become the baseline.`);
         }
     }
     if (volatileCount > 0) {
@@ -1037,8 +1036,7 @@ export function generateStyleMapReport(opts) {
         json.push(surfaceJson);
     }
     // New surfaces: present on only one side, so there's nothing to diff. Show the
-    // captured side as a single screenshot for reference and mark the heading so the
-    // PR comment can attach an OPTIONAL approval box — these never gate the check.
+    // captured side as a single screenshot and mark the heading for the PR comment.
     for (const p of missing) {
         const side = p.sd.missing === 'before' ? 'after' : 'before';
         const srcDir = side === 'after' ? afterDir : beforeDir;
@@ -1058,7 +1056,7 @@ export function generateStyleMapReport(opts) {
         else {
             md.push('', `_Captured only in the **${side}** set; no screenshot saved (run captures with \`screenshots: true\`)._`);
         }
-        md.push('', `_No baseline to compare against — this surface is new, so it doesn't block the check. It becomes part of the baseline once this merges._`);
+        md.push('', `_No baseline to compare against — this surface is new. Review and approve it before it becomes part of the baseline._`);
         json.push(surfaceJson);
     }
     md.push(...contentSection.md);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "styleproof",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "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",
@@ -38,6 +38,7 @@
   "bin": {
     "styleproof-init": "./bin/styleproof-init.mjs",
     "styleproof-map": "./bin/styleproof-map.mjs",
+    "styleproof-capture": "./bin/styleproof-capture.mjs",
     "styleproof-diff": "./bin/styleproof-diff.mjs",
     "styleproof-report": "./bin/styleproof-report.mjs",
     "styleproof-variants": "./bin/styleproof-variants.mjs"