@decocms/parity 0.11.9 → 0.11.11

package/CHANGELOG.md

@@ -5,6 +5,21 @@ 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.11](https://github.com/decocms/parity/compare/v0.11.10...v0.11.11) (2026-06-17)
+
+### Fixed
+
+* **Runtime auto-install was incomplete in 0.11.10.** The 0.11.10 install path ran `npx --yes playwright install chromium` and reported success, but Playwright 1.49+ launches `chromium-headless-shell` for `headless: true` — that's a *separate* binary download. The retry still failed with `Executable doesn't exist at .../chrome-headless-shell` and the user saw the friendly fallback message even though we tried to fix it. Live-reproduced against bagaggio.
+* **Now installs both `chromium` AND `chromium-headless-shell`** so `parity run` works headless without manual intervention.
+* **Uses the bundled Playwright CLI, not `npx --yes playwright`.** `npx --yes` may fetch a *different* Playwright version into its cache, and the binaries it downloads may not match the version `parity` actually launches — so even a successful install can leave the retry failing. We now resolve `playwright/cli.js` via `createRequire` against the local `node_modules` and spawn `node <local-cli> install chromium chromium-headless-shell` — guaranteed version-matched. Falls back to `npx` only if the local resolution fails.
+* **Validated locally end-to-end**: cleared `~/Library/Caches/ms-playwright`, ran `parity audit`, both binaries downloaded (`chromium-1217` + `chromium_headless_shell-1217`), audit completed successfully — no manual `npx playwright install` needed.
+
+## [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

package/dist/cli.js

@@ -1618,6 +1618,9 @@ function countBy(arr, pick) {
 }
 
 // src/engine/browser.ts
+import { spawnSync } from "node:child_process";
+import { createRequire as createRequire2 } from "node:module";
+import { dirname, resolve as resolvePath } from "node:path";
 import { chromium, devices } from "playwright";
 
 // src/engine/carousel-stabilizer.ts
@@ -1790,30 +1793,69 @@ 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);
     }
-    throw 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);
+    }
+  }
+}
+function installChromiumSync() {
+  const localCli = resolveLocalPlaywrightCli();
+  const cmd = localCli ? { command: process.execPath, args: [localCli, "install", "chromium", "chromium-headless-shell"] } : { command: "npx", args: ["--yes", "playwright", "install", "chromium", "chromium-headless-shell"] };
+  const result = spawnSync(cmd.command, cmd.args, {
+    stdio: "inherit",
+    env: process.env
+  });
+  return result.status ?? 1;
+}
+function resolveLocalPlaywrightCli() {
+  try {
+    const req = createRequire2(import.meta.url);
+    const pkgJsonPath = req.resolve("playwright/package.json");
+    const pkg = req("playwright/package.json");
+    const binEntry = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.playwright;
+    if (!binEntry)
+      return null;
+    return resolvePath(dirname(pkgJsonPath), binEntry);
+  } catch {
+    return null;
   }
 }
+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 chromium-headless-shell",
+    "Or unset PARITY_SKIP_PLAYWRIGHT_INSTALL 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({
@@ -10242,7 +10284,7 @@ async function visualSemanticDiff(input) {
 // src/checks/lib/parity-cache.ts
 import { createHash } from "node:crypto";
 import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "node:fs";
-import { dirname, join as join6 } from "node:path";
+import { dirname as dirname2, join as join6 } from "node:path";
 function hashScreenshotPair(prodPath, candPath, promptVersion) {
   const h = createHash("sha256");
   h.update(readFileSync6(prodPath));
@@ -10271,7 +10313,7 @@ function readCache(cacheDir) {
 }
 function writeCache(cacheDir, cache) {
   const file = cacheFilePath(cacheDir);
-  mkdirSync3(dirname(file), { recursive: true });
+  mkdirSync3(dirname2(file), { recursive: true });
   writeFileSync6(file, JSON.stringify(cache, null, 2));
 }
 function getCacheEntry(cache, hash2, currentPromptVersion) {
@@ -12033,7 +12075,7 @@ async function resolveSearchTerms(url, html, opts = {}) {
 
 // src/learned/repo.ts
 import { existsSync as existsSync10, mkdirSync as mkdirSync7, readFileSync as readFileSync10, renameSync, writeFileSync as writeFileSync9 } from "node:fs";
-import { dirname as dirname2 } from "node:path";
+import { dirname as dirname3 } from "node:path";
 import { z as z2 } from "zod";
 var SelectorKey = z2.enum([
   "categoryLink",
@@ -12098,7 +12140,7 @@ function loadLearned(path = DEFAULT_PATH) {
   }
 }
 function saveLearned(lib, path = DEFAULT_PATH) {
-  const dir = dirname2(path);
+  const dir = dirname3(path);
   if (dir && dir !== "." && !existsSync10(dir))
     mkdirSync7(dir, { recursive: true });
   const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
@@ -15742,7 +15784,7 @@ function analyzeHeatmapBuffer(data, width, height, opts = {}) {
 
 // src/diff/section-bundle.ts
 import { writeFileSync as writeFileSync11 } from "node:fs";
-import { basename as basename2, dirname as dirname3, join as join13, relative as relative3 } from "node:path";
+import { basename as basename2, dirname as dirname4, join as join13, relative as relative3 } from "node:path";
 
 // src/engine/computed-styles.ts
 var SECTION_STYLE_KEYS = [
@@ -16020,7 +16062,7 @@ function renderMarkdownBundle(input, deltas) {
 }
 function relativeOrAbs(outDir, absPath) {
   try {
-    if (dirname3(absPath) === outDir)
+    if (dirname4(absPath) === outDir)
       return basename2(absPath);
     return relative3(outDir, absPath);
   } catch {
@@ -19980,11 +20022,11 @@ function printSummary6(vitals, cache) {
 
 // src/util/version.ts
 import { readFileSync as readFileSync18 } from "node:fs";
-import { dirname as dirname4, resolve as resolve3 } from "node:path";
+import { dirname as dirname5, resolve as resolve3 } from "node:path";
 import { fileURLToPath } from "node:url";
 function getPackageVersion() {
   try {
-    const here = dirname4(fileURLToPath(import.meta.url));
+    const here = dirname5(fileURLToPath(import.meta.url));
     for (const up of ["..", "../..", "../../.."]) {
       try {
         const pkgPath = resolve3(here, up, "package.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/parity",
-  "version": "0.11.9",
+  "version": "0.11.11",
   "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",