snapdrift 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## Unreleased
 
+## 0.18.0 - 2026-11-02
+
+Workspace releases this version:
+
+- `@snapdrift/adapter-fs` 1.8.0 — local capture now requires Playwright `^1.64.1`, which installs Chromium `156.0.8078.4` (revision `1248`) instead of Chromium `153.0.8010.12` (revision `1243`). Existing local baselines captured with Playwright 1.63.x persist a different `captureProfile.browserRevision` / `playwrightVersion`, so comparison reports `incompatible_capture` and does not compare pixels until the baseline is refreshed in the upgraded environment. Pixel rendering may still be byte-identical; the capture-profile contract has no version tolerance.
+
+`@snapdrift/manifest` stays 1.8.0, `@snapdrift/compare-core` stays 1.8.0, and `@snapdrift/adapter-report-md` stays 1.4.0. Root floors move to `@snapdrift/adapter-fs ^1.8.0` and `playwright ^1.64.1`; the previous `adapter-fs` 1.7.2 and the Playwright 1.63 floor do not satisfy them. The dispatcher pins `3831623`, the #216 merge commit on `main`, which includes the newest commit touching `actions/` (`1cbf629`, the shell-only Playwright install).
+
+### Changes
+
+- Local capture raises the Playwright floor to `^1.64.1`; installs now provision Chromium `156.0.8078.4` (revision `1248`). GitHub Actions keep the shell-only Chromium install (`playwright install --with-deps --only-shell chromium`).
+- **Baseline refresh required:** local baselines captured under the previous Playwright floor (`1.63.x`, Chromium `153.0.8010.12`, revision `1243`) are incompatible until recaptured. A real local-capture verification on a deterministic page produced byte-identical desktop (1440×900) and mobile (1170×2955) PNGs across both versions, but diffing the old baseline against a 1.64.1 current capture returned `incomplete` with two `incompatible_capture` errors (reason: `captureProfile.browserRevision differs between baseline and current capture`); recapturing on 1.64.1 then diffing returned `clean` with `captureCompatibility: verified`.
+
+### Documentation
+
+- `docs/local-cli.md` now states the upgrade path explicitly: refresh every local baseline in the upgraded Playwright/Chromium environment before expecting PR diffs to compare pixels, even when rendering is byte-identical.
+- Existing guidance on refreshing or acknowledging local baselines remains unchanged; `report-only` keeps incompatibility visible and never forces pixel comparison.
+
 ## 0.17.0 - 2026-10-28
 
 Workspace releases this version:

package/README.md

@@ -48,7 +48,7 @@ You keep ownership of checkout, build, startup, readiness, and teardown. SnapDri
 
 ```yaml
 - name: SnapDrift Baseline
-  uses: ranacseruet/snapdrift@v0.17.0
+  uses: ranacseruet/snapdrift@v0.18.0
   with:
     mode: baseline
     repo-config-path: .github/snapdrift.json
@@ -60,7 +60,7 @@ With `provider: "snap"`, baseline publication is a complete, fail-closed snapsho
 
 ```yaml
 - name: SnapDrift Report
-  uses: ranacseruet/snapdrift@v0.17.0
+  uses: ranacseruet/snapdrift@v0.18.0
   with:
     mode: pr-diff
     github-token: ${{ secrets.GITHUB_TOKEN }}

package/action.yml

@@ -155,7 +155,7 @@ runs:
     - name: SnapDrift baseline
       id: baseline
       if: inputs.mode == 'baseline'
-      uses: ranacseruet/snapdrift/actions/baseline@2d93a5499daf6e0273ed11da69b364d33dc8d4d2 # v0.17.0
+      uses: ranacseruet/snapdrift/actions/baseline@38316233186ebbbe40f803bf576e7e13986e7e35 # v0.18.0
       with:
         repo-config-path: ${{ inputs.repo-config-path }}
         route-ids: ${{ inputs.route-ids }}
@@ -165,7 +165,7 @@ runs:
     - name: SnapDrift pull request diff
       id: pr-diff
       if: inputs.mode == 'pr-diff'
-      uses: ranacseruet/snapdrift/actions/pr-diff@2d93a5499daf6e0273ed11da69b364d33dc8d4d2 # v0.17.0
+      uses: ranacseruet/snapdrift/actions/pr-diff@38316233186ebbbe40f803bf576e7e13986e7e35 # v0.18.0
       with:
         github-token: ${{ inputs.github-token }}
         repo-config-path: ${{ inputs.repo-config-path }}

package/docs/integration-guide.md

@@ -8,7 +8,7 @@ Examples use the public release tag for readability. If your organization requir
 
 - SnapDrift provisions Node 22 internally.
 - The consumer app can use any stack as long as it can be started and reached at `baseUrl`.
-- The runner must be Ubuntu-compatible because Playwright Chromium is installed with system dependencies.
+- The runner must be pinned to a stable Ubuntu-compatible image (for example `ubuntu-24.04`) because Playwright Chromium is installed with system dependencies and local capture profiles fingerprint the OS. Avoid a moving `ubuntu-latest` label between baseline and PR captures.
 - The runner must have outbound network access to fetch Playwright Chromium.
 
 Your repository still owns:
@@ -46,7 +46,7 @@ SnapDrift owns route selection, capture, comparison, skipped-report generation,
 
 ```yaml
 - name: SnapDrift Baseline
-  uses: ranacseruet/snapdrift@v0.17.0
+  uses: ranacseruet/snapdrift@v0.18.0
   with:
     mode: baseline
     repo-config-path: .github/snapdrift.json
@@ -71,7 +71,7 @@ Then add SnapDrift after the app is running:
 
 ```yaml
 - name: SnapDrift Report
-  uses: ranacseruet/snapdrift@v0.17.0
+  uses: ranacseruet/snapdrift@v0.18.0
   with:
     mode: pr-diff
     github-token: ${{ secrets.GITHUB_TOKEN }}
@@ -86,8 +86,8 @@ The wrappers remain published in their own right, and are equivalent to the disp
 
 | Entry point | Equivalent to |
 |-------------|---------------|
-| `ranacseruet/snapdrift@v0.17.0` with `mode: baseline` | `ranacseruet/snapdrift/actions/baseline@v0.17.0` |
-| `ranacseruet/snapdrift@v0.17.0` with `mode: pr-diff` | `ranacseruet/snapdrift/actions/pr-diff@v0.17.0` |
+| `ranacseruet/snapdrift@v0.18.0` with `mode: baseline` | `ranacseruet/snapdrift/actions/baseline@v0.18.0` |
+| `ranacseruet/snapdrift@v0.18.0` with `mode: pr-diff` | `ranacseruet/snapdrift/actions/pr-diff@v0.18.0` |
 
 Use the wrappers directly when you want to skip the dispatcher's input indirection, and the lower-level `capture`, `compare`, `scope`, `resolve-baseline`, `stage`, `comment`, and `enforce` actions when you need to orchestrate the stages yourself.
 
@@ -112,7 +112,7 @@ permissions:
 
 jobs:
   snapdrift:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -130,7 +130,7 @@ jobs:
           done
 
       - name: SnapDrift Report
-        uses: ranacseruet/snapdrift@v0.17.0
+        uses: ranacseruet/snapdrift@v0.18.0
         with:
           mode: pr-diff
           github-token: ${{ secrets.GITHUB_TOKEN }}
@@ -154,7 +154,7 @@ permissions:
 
 jobs:
   snapdrift:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
@@ -170,7 +170,7 @@ jobs:
           done
 
       - name: SnapDrift Report
-        uses: ranacseruet/snapdrift@v0.17.0
+        uses: ranacseruet/snapdrift@v0.18.0
         with:
           mode: pr-diff
           github-token: ${{ secrets.GITHUB_TOKEN }}

package/docs/local-cli.md

@@ -214,6 +214,13 @@ normalized viewport. A mismatch produces an
 signal. Matching profiles can still have route-identity errors:
 `summary.captureCompatibility.status` describes profiles only.
 
+SnapDrift 0.18.0 raises the Playwright floor to 1.64.1, which installs Chromium
+156 (`156.0.8078.4`, revision 1248) instead of Chromium 153 (`153.0.8010.12`,
+revision 1243). Every local baseline captured with Playwright 1.63.x is
+incompatible until refreshed, even when the rendered pixels are byte-identical;
+the profile check has no version tolerance. Refresh on the upgraded environment
+before expecting PR diffs to compare pixels.
+
 To refresh, serve the intended accepted application state using the same capture
 environment and route config as future diffs. With `provider: "local"`, run:
 

package/docs/workflow-templates/refresh-baseline-on-merge.yml

@@ -35,7 +35,7 @@ jobs:
     concurrency:
       group: snapdrift-baseline-${{ github.repository }}-${{ github.ref }}
       cancel-in-progress: false
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
 
     steps:
       - uses: actions/checkout@v4
@@ -82,7 +82,7 @@ jobs:
 
       - name: Publish SnapDrift baseline
         if: steps.baseline_candidate.outputs.current == 'true'
-        uses: ranacseruet/snapdrift@v0.17.0
+        uses: ranacseruet/snapdrift@v0.18.0
         with:
           mode: baseline
           repo-config-path: .github/snapdrift.json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snapdrift",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "private": false,
   "type": "module",
   "description": "SnapDrift captures, compares, and reports UI drift for Playwright-based app checks.",
@@ -103,12 +103,15 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@snapdrift/adapter-fs": "^1.7.2",
+    "@snapdrift/adapter-fs": "^1.8.0",
     "@snapdrift/adapter-report-md": "^1.4.0",
     "@snapdrift/compare-core": "^1.8.0",
     "@snapdrift/manifest": "^1.8.0",
     "js-yaml": "^5.4.0",
-    "playwright": "^1.59.1",
+    "playwright": "^1.64.1",
     "pngjs": "^7.0.0"
+  },
+  "overrides": {
+    "brace-expansion@5": "^5.0.12"
   }
 }