@decocms/parity 0.11.8 → 0.11.10

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.11.10](https://github.com/decocms/parity/compare/v0.11.9...v0.11.10) (2026-06-17)
+
+### Fixed
+
+* **Runtime auto-install of Chromium when `postinstall` didn't run.** The 0.11.7 `postinstall` hook works when npm runs it — but plenty of installs skip lifecycle scripts (`npm config set ignore-scripts true`, `npm 11+` global-install default, monorepos with `--ignore-scripts`). Users saw a friendly "run `npx playwright install chromium`" message but still had to run a second command before `parity` worked. Now `launchBrowser` catches the missing-browser error and runs `npx --yes playwright install chromium` inline (with stdio inherited so the download progress is visible), then retries the launch once. The original "you must run X" path is preserved via `PARITY_SKIP_PLAYWRIGHT_INSTALL=1` for CI / Docker / monorepos that want explicit control. Net effect: a fresh `npm i -g @decocms/parity && parity run …` works in one command even when lifecycle scripts are disabled.
+
+## [0.11.9](https://github.com/decocms/parity/compare/v0.11.8...v0.11.9) (2026-06-17)
+
+### Fixed
+
+* **Re-publish to refresh `@latest` and let the Publish workflow create the GitHub release.** All the 0.11.x manual `gh release create` calls collided with the CI Publish job's `gh release create --generate-notes` step (it gets `HTTP 422: Release.tag_name already exists` and exits non-zero), which made the workflow look red even though npm publish succeeded each time. This bump has no code changes — it triggers a clean end-to-end publish so the workflow can prove green and `@latest` carries the same artifact as 0.11.8 with a fresh install signature. From now on no manual release creation — the workflow does it.
+
 ## [0.11.8](https://github.com/decocms/parity/compare/v0.11.7...v0.11.8) (2026-06-17)
 
 ### Fixed

package/dist/cli.js

@@ -1618,6 +1618,7 @@ function countBy(arr, pick) {
 }
 
 // src/engine/browser.ts
+import { spawnSync } from "node:child_process";
 import { chromium, devices } from "playwright";
 
 // src/engine/carousel-stabilizer.ts
@@ -1790,30 +1791,54 @@ var VIEWPORT_PRESETS = {
   }
 };
 async function launchBrowser(opts = {}) {
+  const doLaunch = () => chromium.launch({
+    headless: opts.headless ?? true,
+    slowMo: opts.slowMo ?? 0,
+    args: ["--disable-blink-features=AutomationControlled"]
+  });
   try {
-    return await chromium.launch({
-      headless: opts.headless ?? true,
-      slowMo: opts.slowMo ?? 0,
-      args: ["--disable-blink-features=AutomationControlled"]
-    });
+    return await doLaunch();
   } catch (err) {
     const msg = err.message ?? "";
-    if (msg.includes("Executable doesn't exist")) {
-      const friendly = new Error([
-        "Playwright's Chromium binary is not installed yet. Run:",
-        "",
-        "    npx playwright install chromium",
-        "",
-        "(one-time, ~140 MB download). Then re-run parity. This usually happens",
-        "after a fresh `npm install -g @decocms/parity`."
-      ].join(`
-`));
-      friendly.cause = err;
-      throw friendly;
+    if (!msg.includes("Executable doesn't exist"))
+      throw err;
+    if (process.env.PARITY_SKIP_PLAYWRIGHT_INSTALL === "1") {
+      throw missingBrowserError(err);
+    }
+    console.log("");
+    console.log("  ⚠  Playwright's Chromium binary is not installed yet — downloading now (~140 MB, one-time)…");
+    console.log("     Set PARITY_SKIP_PLAYWRIGHT_INSTALL=1 to disable this auto-install.");
+    console.log("");
+    const installRc = installChromiumSync();
+    if (installRc !== 0)
+      throw missingBrowserError(err);
+    console.log("  ✓ Chromium ready. Continuing the run.");
+    console.log("");
+    try {
+      return await doLaunch();
+    } catch (retryErr) {
+      throw missingBrowserError(retryErr);
     }
-    throw err;
   }
 }
+function installChromiumSync() {
+  const result = spawnSync("npx", ["--yes", "playwright", "install", "chromium"], {
+    stdio: "inherit",
+    env: process.env
+  });
+  return result.status ?? 1;
+}
+function missingBrowserError(cause) {
+  const original = cause instanceof Error ? cause.message : String(cause);
+  return new Error([
+    "Playwright's Chromium binary is not installed.",
+    "Run: npx playwright install chromium",
+    "Or set PARITY_SKIP_PLAYWRIGHT_INSTALL=0 and rerun `parity` to auto-install.",
+    "",
+    `Original error: ${original}`
+  ].join(`
+`));
+}
 async function newContext(browser, opts) {
   const baseContext = VIEWPORT_PRESETS[opts.viewport];
   const ctx = await browser.newContext({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/parity",
-  "version": "0.11.8",
+  "version": "0.11.10",
   "description": "E2E parity validator for site migrations. Compares prod vs cand and reports UI, functional, SEO, visual, and Web Vitals deltas with an LLM-ranked HTML report.",
   "type": "module",
   "license": "MIT",