@recursica/adapter-tester 3.0.0 → 5.0.0

package/dist/cli.js

@@ -1,323 +1,449 @@
 #!/usr/bin/env node
-import { spawn as R, spawnSync as G } from "node:child_process";
-import { readFileSync as S, existsSync as L, mkdirSync as J, writeFileSync as x } from "node:fs";
-import { dirname as F, join as i, resolve as P } from "node:path";
-import { fileURLToPath as I, pathToFileURL as V } from "node:url";
-import B from "node:net";
-import q from "express";
-import { createProxyMiddleware as W } from "http-proxy-middleware";
-import { m as H } from "./mantineSourceOfTruth-BUkqMNEo.js";
-import { a as K, i as Y } from "./index-DqQzFSAH.js";
-const A = F(I(import.meta.url));
-function T(t) {
-  return new Promise((o) => {
-    const e = new B.Socket();
-    e.setTimeout(200), e.once("connect", () => {
-      e.destroy(), o(!0);
-    }), e.once("timeout", () => {
-      e.destroy(), o(!1);
-    }), e.once("error", () => {
-      e.destroy(), o(!1);
-    }), e.connect(t, "127.0.0.1");
+import { spawn as _, spawnSync as q } from "node:child_process";
+import { readFileSync as S, mkdirSync as F, writeFileSync as O, existsSync as I } from "node:fs";
+import { dirname as D, join as a, resolve as j } from "node:path";
+import { fileURLToPath as M, pathToFileURL as H } from "node:url";
+import W from "express";
+import { createProxyMiddleware as B } from "http-proxy-middleware";
+import K from "node:net";
+import { m as X } from "./mantineSourceOfTruth-DE7XOgea.js";
+import { a as Y, i as z } from "./index-DqQzFSAH.js";
+const Q = /\x1b\[[0-9;]*m/g, Z = /Local:\s*(https?:\/\/localhost:\d+)/;
+function ee(e) {
+  return new Promise((t) => {
+    const r = new K.Socket();
+    r.setTimeout(200), r.once("connect", () => {
+      r.destroy(), t(!0);
+    }), r.once("timeout", () => {
+      r.destroy(), t(!1);
+    }), r.once("error", () => {
+      r.destroy(), t(!1);
+    }), r.connect(e, "127.0.0.1");
   });
 }
-async function j(t, o = 6e4) {
-  const e = Date.now();
-  for (; Date.now() - e < o; ) {
-    if (await T(t)) return !0;
-    await new Promise((r) => setTimeout(r, 500));
+function te(e) {
+  try {
+    const t = JSON.parse(S(e, "utf8")).port;
+    return typeof t == "number" ? t : void 0;
+  } catch {
+    return;
   }
-  return !1;
 }
-function E(t) {
-  return Number(new URL(t).port);
+function re(e, t) {
+  F(D(e), { recursive: !0 }), O(e, JSON.stringify({ port: t }));
 }
-function $(t, o) {
-  var r, s;
-  console.log(
-    `[Dev Launcher] Port ${o.port} is inactive. Launching Storybook for ${t}...`
-  );
-  const e = R(o.command, {
-    cwd: o.cwd,
-    stdio: "pipe",
-    shell: !0
-  });
-  return (r = e.stdout) == null || r.on("data", (a) => {
-    for (const c of a.toString().split(`
+function oe(e, t) {
+  return new Promise((r, o) => {
+    var y, w;
+    const s = _(e.command, {
+      cwd: e.cwd,
+      stdio: "pipe",
+      shell: !0
+    });
+    let n = !1;
+    const d = setTimeout(() => {
+      n || (n = !0, s.kill(), o(
+        new Error(
+          `Timed out after ${t}ms waiting for ${e.name}'s Storybook to report its URL (no "Local: http://localhost:<port>" line seen in its output).`
+        )
+      ));
+    }, t), h = (i, u) => {
+      const l = i.toString();
+      for (const c of l.split(`
 `))
-      c.trim() && console.log(`[${t} SB] ${c.trim()}`);
-  }), (s = e.stderr) == null || s.on("data", (a) => {
-    for (const c of a.toString().split(`
-`))
-      c.trim() && console.error(`[${t} SB ERROR] ${c.trim()}`);
-  }), e.on("error", (a) => {
-    console.error(`[${t} SB ERROR] Failed to start process:`, a);
-  }), e;
+        if (c.trim()) {
+          const p = u ? `${e.name} SB ERROR` : `${e.name} SB`;
+          (u ? console.error : console.log)(`[${p}] ${c.trim()}`);
+        }
+      if (n) return;
+      const v = l.replace(Q, "").match(Z);
+      if (v) {
+        n = !0, clearTimeout(d);
+        const c = v[1], p = Number(new URL(c).port);
+        re(e.cacheFile, p), r({ url: c, port: p, process: s });
+      }
+    };
+    (y = s.stdout) == null || y.on("data", (i) => h(i, !1)), (w = s.stderr) == null || w.on("data", (i) => h(i, !0)), s.on("error", (i) => {
+      n || (n = !0, clearTimeout(d), o(i));
+    }), s.on("exit", (i) => {
+      n || (n = !0, clearTimeout(d), o(
+        new Error(
+          `${e.name}'s Storybook exited (code ${i}) before reporting its URL.`
+        )
+      ));
+    });
+  });
+}
+function x(e, t) {
+  return {
+    name: e,
+    command: t.command,
+    cwd: t.cwd,
+    reuseExistingServer: t.reuseExistingServer,
+    cacheFile: t.cacheFile,
+    timeoutMs: t.timeout
+  };
+}
+async function A(e) {
+  if (e.reuseExistingServer) {
+    const t = te(e.cacheFile);
+    if (t !== void 0 && await ee(t))
+      return console.log(
+        `[Dev Launcher] ${e.name} is already running on port ${t} (reused).`
+      ), {
+        url: `http://localhost:${t}`,
+        port: t,
+        process: null
+      };
+  }
+  return console.log(`[Dev Launcher] Launching Storybook for ${e.name}...`), oe(e, e.timeoutMs ?? 120 * 1e3);
 }
-function X(t) {
-  const o = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-  console.log(`[Dev Launcher] Auto-launching browser: ${t}`), R(o, [t], { shell: process.platform === "win32" }).on(
+const N = D(M(import.meta.url));
+function se(e) {
+  const t = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+  console.log(`[Dev Launcher] Auto-launching browser: ${e}`), _(t, [e], { shell: process.platform === "win32" }).on(
     "error",
-    (e) => {
-      console.error("[Dev Launcher] Failed to auto-launch browser:", e);
+    (r) => {
+      console.error("[Dev Launcher] Failed to auto-launch browser:", r);
     }
   );
 }
-function z(t, o, e = {}) {
-  const [r, s] = t.targets, [a, c] = o;
-  if (!(r != null && r.sourceOfTruth) || !s || s.sourceOfTruth || !a || !c)
+async function ne(e, t, r = {}) {
+  const [o, s] = e.targets, [n, d] = t;
+  if (!(o != null && o.sourceOfTruth) || !s || s.sourceOfTruth || !n || !d)
     throw new Error(
       "adapter-tester dev mode requires exactly two targets: [sourceOfTruth, target] — check adapter-tester.config.json."
     );
-  const h = e.port ?? 6010, u = E(r.url), n = E(s.url), l = q(), f = i(A, "../public"), w = i(A, "../report-header.txt");
-  l.get("/", (p, d, g) => {
-    if (p.query.path) {
-      g();
+  const h = r.port ?? 6010;
+  console.log(
+    `[Dev Launcher] Resolving ${o.name} and ${s.name} Storybooks...`
+  );
+  const [y, w] = await Promise.all([
+    A(
+      x(o.name, n)
+    ),
+    A(x(s.name, d))
+  ]);
+  console.log("[Dev Launcher] Both Storybooks are active and responsive!");
+  const i = [y.process, w.process].filter(
+    (f) => f !== null
+  ), u = W(), l = a(N, "../public"), v = a(N, "../report-header.txt");
+  u.get("/", (f, T, b) => {
+    if (f.query.path) {
+      b();
       return;
     }
-    const D = S(i(f, "index.html"), "utf8").replace(
+    const J = S(a(l, "index.html"), "utf8").replace(
       "<head>",
       `<head>
   <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({
         ownName: s.name,
-        sourceOfTruthName: r.name,
-        sourceOfTruthPort: u
+        sourceOfTruthName: o.name,
+        sourceOfTruthPort: y.port
       })};<\/script>`
     );
-    d.send(D);
-  }), l.get("/report-header.txt", (p, d) => {
+    T.send(J);
+  }), u.get("/report-header.txt", (f, T) => {
     try {
-      d.type("text/plain").send(S(w, "utf8"));
+      T.type("text/plain").send(S(v, "utf8"));
     } catch {
-      d.status(500).send("Error loading report-header.txt");
+      T.status(500).send("Error loading report-header.txt");
     }
-  }), l.use(
+  }), u.use(
     "/",
-    W({
-      target: `http://localhost:${n}`,
+    B({
+      target: w.url,
       changeOrigin: !0,
       ws: !0
     })
   );
-  const m = [];
-  let v = !1;
-  const b = () => {
-    if (!v) {
-      v = !0, console.log(
+  let c = !1;
+  const p = () => {
+    if (!c) {
+      c = !0, console.log(
         `
 [Dev Launcher] Shutting down Dev Mode server and spawned Storybooks...`
       );
-      for (const p of m) p.kill("SIGINT");
+      for (const f of i) f.kill("SIGINT");
       process.exit(0);
     }
   };
-  process.on("SIGINT", b), process.on("SIGTERM", b), l.listen(h, async () => {
+  process.on("SIGINT", p), process.on("SIGTERM", p), u.listen(h, () => {
     console.log(`
 ====================================================
 🚀 Adapter Dev Mode proxy running at:
    http://localhost:${h}
 ====================================================
-`);
-    const [p, d] = await Promise.all([
-      T(u),
-      T(n)
-    ]);
-    p ? console.log(
-      `[Dev Launcher] ${r.name} is already running on port ${u}.`
-    ) : m.push($(r.name, a)), d ? console.log(
-      `[Dev Launcher] ${s.name} is already running on port ${n}.`
-    ) : m.push($(s.name, c));
-    const g = [];
-    p || g.push(j(u)), d || g.push(j(n)), g.length > 0 ? (console.log("[Dev Launcher] Waiting for Storybooks to be responsive..."), (await Promise.all(g)).every(Boolean) ? console.log("[Dev Launcher] All Storybooks are active and responsive!") : console.warn(
-      "[Dev Launcher] Warning: some Storybooks timed out during startup, but proceeding..."
-    )) : console.log("[Dev Launcher] Both Storybooks already active."), X(`http://localhost:${h}`);
+`), se(`http://localhost:${h}`);
   });
 }
-const Q = "http://json-schema.org/draft-07/schema#", Z = "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json", ee = "adapter-tester.config.json", te = "Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.", oe = "object", re = !1, se = { $schema: { type: "string", description: 'Optional pointer to this schema for editor autocomplete, e.g. "./node_modules/@recursica/adapter-tester/src/adapter-tester.schema.json".' }, name: { type: "string", description: `Label for this project's own target. Defaults to the unscoped name in this project's package.json (e.g. "@recursica/some-adapter" -> "some-adapter").` }, storybook: { type: "object", additionalProperties: !1, description: "This project's own Storybook target.", properties: { port: { type: "integer", minimum: 1, maximum: 65535, description: "Port the target's Storybook is served on. Auto-detected from this project's own `scripts.storybook` (a `-p <port>`/`--port <port>` flag) when omitted, falling back to Storybook's own default of 6006." }, command: { type: "string", description: "Command that boots the target's Storybook. Defaults to `npm run storybook`." }, cwd: { type: "string", description: 'Directory the command runs in, relative to the config file. Defaults to ".".' } } }, sourceOfTruth: { description: 'The comparison target. Defaults to `{ "type": "mantine-harness" }`.', oneOf: [{ type: "object", additionalProperties: !1, description: "Default mode: boots a throwaway harness that installs the published @recursica/mantine-adapter from npm — no monorepo checkout required.", properties: { type: { const: "mantine-harness" }, port: { type: "integer", minimum: 1, maximum: 65535, description: "Port the throwaway harness's Storybook is served on. Defaults to 6011." }, mantineAdapterVersion: { type: "string", description: "npm version/tag of @recursica/mantine-adapter to install in the harness. Defaults to `latest`." }, storybookTemplateVersion: { type: "string", description: "npm version/tag of @recursica/storybook-template to install in the harness. Defaults to `latest`." } } }, { type: "object", additionalProperties: !1, description: "Non-standard mode: points at an already-addressable Storybook — e.g. a sibling workspace package's own Storybook inside this monorepo.", required: ["type", "port"], properties: { type: { const: "url" }, name: { type: "string", description: 'Label for the source-of-truth target. Defaults to "Mantine".' }, port: { type: "integer", minimum: 1, maximum: 65535, description: "Port the source-of-truth Storybook is served on." }, command: { type: "string", description: "Command that boots the source-of-truth Storybook. Defaults to `npm run storybook`." }, cwd: { type: "string", description: 'Directory the command runs in, relative to the config file. Defaults to ".".' } } }] }, isSourceOfTruthAdapter: { type: "boolean", description: "True only for the source-of-truth adapter's own config (mantine-adapter). Skips `sourceOfTruth` entirely — there's nothing above it to diverge from — and runs the own-drift golden check standalone, against just this project's own Storybook. Defaults to false." }, diffThresholdPixels: { type: "number", minimum: 0, description: "Global visual diff threshold, in mismatched pixels, before a story is considered a failure. Defaults to 3500. AI agents must not modify this field — see AGENT.md." }, storyThresholds: { type: "object", additionalProperties: { type: "number", minimum: 0 }, description: "Per-story diff threshold overrides, keyed by story id prefix (a story matches if its id equals the key or starts with it). Overrides `diffThresholdPixels` for matching stories. When more than one key matches a story, the longest (most specific) key wins." }, excludeTitlePrefixes: { type: "array", items: { type: "string" }, description: "Storybook title prefixes to exclude from comparison, in addition to the built-in denylist (`Theme/*`, `Tokens/*`, `Introduction`)." }, excludeStoryIds: { type: "array", items: { type: "string" }, description: "Story id prefixes to skip entirely — no own-drift check, no divergence check, no golden captured. For excluding individual stories that don't have a cross-adapter counterpart; use `excludeTitlePrefixes` to drop a whole title instead." } }, ne = {
-  $schema: Q,
-  $id: Z,
-  title: ee,
-  description: te,
-  type: oe,
-  additionalProperties: re,
-  properties: se
-}, ie = Y, M = new K.Ajv({ allErrors: !0, strict: !0 });
-ie(M);
-const N = M.compile(ne);
-function ae(t, o) {
-  if (N(t)) return;
-  const e = (N.errors ?? []).map((r) => {
-    var a;
-    const s = (a = r.params) != null && a.additionalProperty ? ` '${r.params.additionalProperty}'` : "";
-    return `  - ${r.instancePath || "root"} ${r.message}${s}`;
+const ie = "http://json-schema.org/draft-07/schema#", ae = "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json", ce = "adapter-tester.config.json", ue = "Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.", de = "object", le = !1, pe = { $schema: { type: "string", description: 'Optional pointer to this schema for editor autocomplete, e.g. "https://raw.githubusercontent.com/borderux/recursica/main/packages/adapter-tester/src/adapter-tester.schema.json".' }, name: { type: "string", description: `Label for this project's own target. Defaults to the unscoped name in this project's package.json (e.g. "@recursica/some-adapter" -> "some-adapter").` }, storybook: { type: "object", additionalProperties: !1, description: "This project's own Storybook target.", properties: { port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from this Storybook's own startup output, since Storybook silently falls back to an OS-assigned port whenever this one is taken. Auto-detected from this project's own `scripts.storybook` (a `-p <port>`/`--port <port>` flag) when omitted, falling back to 6006." }, command: { type: "string", description: "Command that boots the target's Storybook. Defaults to `npm run storybook`." }, cwd: { type: "string", description: 'Directory the command runs in, relative to the config file. Defaults to ".".' } } }, sourceOfTruth: { description: 'The comparison target. Defaults to `{ "type": "mantine-harness" }`.', oneOf: [{ type: "object", additionalProperties: !1, description: "Default mode: boots a throwaway harness that installs the published @recursica/mantine-adapter from npm — no monorepo checkout required.", properties: { type: { const: "mantine-harness" }, port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from the throwaway harness's Storybook's own startup output." }, mantineAdapterVersion: { type: "string", description: "npm version/tag of @recursica/mantine-adapter to install in the harness. Defaults to `latest`." }, storybookTemplateVersion: { type: "string", description: "npm version/tag of @recursica/storybook-template to install in the harness. Defaults to `latest`." } } }, { type: "object", additionalProperties: !1, description: "Non-standard mode: points at an already-addressable Storybook — e.g. a sibling workspace package's own Storybook inside this monorepo.", required: ["type"], properties: { type: { const: "url" }, name: { type: "string", description: 'Label for the source-of-truth target. Defaults to "Mantine".' }, port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from the source-of-truth Storybook's own startup output. Defaults to 6011." }, command: { type: "string", description: "Command that boots the source-of-truth Storybook. Defaults to `npm run storybook`." }, cwd: { type: "string", description: 'Directory the command runs in, relative to the config file. Defaults to ".".' } } }] }, isSourceOfTruthAdapter: { type: "boolean", description: "True only for the source-of-truth adapter's own config (mantine-adapter). Skips `sourceOfTruth` entirely — there's nothing above it to diverge from — and runs the own-drift golden check standalone, against just this project's own Storybook. Defaults to false." }, goldenThresholdPixels: { type: "number", minimum: 0, description: "Global visual diff threshold for the own-drift check (this project's live render vs. its own committed `test/golden/` image), in mismatched pixels, before a story is considered a failure. Same library/component on both sides, so this should stay tight. Defaults to 10. AI agents must not modify this field — see AGENT.md.", default: 10 }, sourceOfTruthThresholdPixels: { type: "number", minimum: 0, description: "Global visual diff threshold for the source-of-truth divergence check (this project's golden vs. the source-of-truth adapter's golden), in mismatched pixels, before a difference is flagged. Comparing across two different component libraries has legitimate structural variation (native control widgets, font rendering, etc.), so this is expected to be set much higher than `goldenThresholdPixels`. Ignored on the source-of-truth adapter's own config (`isSourceOfTruthAdapter: true`), which has no divergence check. Defaults to 3500. AI agents must not modify this field — see AGENT.md.", default: 3500 }, stories: { type: "object", additionalProperties: { type: "object", additionalProperties: !1, properties: { goldenThreshold: { type: "number", minimum: 0, description: "Diff threshold override for matching stories' own-drift check, in mismatched pixels. Overrides `goldenThresholdPixels`." }, sourceOfTruthThreshold: { type: "number", minimum: 0, description: "Diff threshold override for matching stories' source-of-truth divergence check, in mismatched pixels. Overrides `sourceOfTruthThresholdPixels`." }, exclude: { type: "boolean", description: "Skip matching stories entirely — no own-drift check, no divergence check, no golden captured. For stories that don't have a cross-adapter counterpart; use `excludeTitlePrefixes` to drop a whole title instead." } } }, description: "Per-story overrides, keyed by story id prefix (a story matches if its id equals the key or starts with it). When more than one key matches a story, the longest (most specific) key wins." }, excludeTitlePrefixes: { type: "array", items: { type: "string" }, description: "Storybook title prefixes to exclude from comparison, in addition to the built-in denylist (`Theme/*`, `Tokens/*`, `Introduction`)." } }, he = {
+  $schema: ie,
+  $id: ae,
+  title: ce,
+  description: ue,
+  type: de,
+  additionalProperties: le,
+  properties: pe
+}, fe = z, U = new Y.Ajv({ allErrors: !0, strict: !0 });
+fe(U);
+const $ = U.compile(he);
+function me(e, t) {
+  if ($(e)) return;
+  const r = ($.errors ?? []).map((o) => {
+    var n;
+    const s = (n = o.params) != null && n.additionalProperty ? ` '${o.params.additionalProperty}'` : "";
+    return `  - ${o.instancePath || "root"} ${o.message}${s}`;
   }).join(`
 `);
-  throw new Error(`Invalid ${o}:
-${e}`);
+  throw new Error(`Invalid ${t}:
+${r}`);
 }
-const ce = "@recursica/mantine-adapter", pe = "adapter-tester.config.json", _ = "npm run storybook", de = 6006, le = 6011, C = "Mantine", ue = 3500;
-function U(t) {
-  const o = i(t, "package.json");
-  if (!L(o))
+const ge = "@recursica/mantine-adapter", ye = "adapter-tester.config.json", L = "npm run storybook", we = 6006, C = 6011, R = "Mantine", ve = 10, Te = 3500;
+function G(e) {
+  const t = a(e, "package.json");
+  if (!I(t))
     throw new Error(
-      `No package.json found in ${t} — run adapter-tester from the root of the project being tested.`
+      `No package.json found in ${e} — run adapter-tester from the root of the project being tested.`
     );
-  return JSON.parse(S(o, "utf8"));
+  return JSON.parse(S(t, "utf8"));
 }
-function me(t) {
+function be(e) {
   var s;
-  const e = (s = U(t).scripts) == null ? void 0 : s.storybook, r = e == null ? void 0 : e.match(/(?:-p|--port)[ =](\d+)/);
-  return r ? Number(r[1]) : de;
+  const r = (s = G(e).scripts) == null ? void 0 : s.storybook, o = r == null ? void 0 : r.match(/(?:-p|--port)[ =](\d+)/);
+  return o ? Number(o[1]) : we;
 }
-function he(t) {
-  const e = U(t).name;
-  return e ? e.split("/").pop() : "Adapter";
+function Se(e) {
+  const r = G(e).name;
+  return r ? r.split("/").pop() : "Adapter";
 }
-function fe(t) {
-  const o = i(t, pe);
-  if (!L(o))
+function ke(e) {
+  const t = a(e, ye);
+  if (!I(t))
     return {};
-  const e = JSON.parse(S(o, "utf8"));
-  return ae(e, o), e;
+  const r = JSON.parse(S(t, "utf8"));
+  return me(r, t), r;
 }
-function ge(t) {
-  var v, b, p;
-  const o = fe(t), e = o.isSourceOfTruthAdapter ?? !1, r = o.name ?? he(t), s = ((v = o.storybook) == null ? void 0 : v.port) ?? me(t), a = ((b = o.storybook) == null ? void 0 : b.command) ?? _, c = P(t, ((p = o.storybook) == null ? void 0 : p.cwd) ?? "."), h = {
-    command: a,
-    port: s,
-    cwd: c,
+function Oe(e, t = {}) {
+  var p, f, T;
+  const r = ke(e), o = r.isSourceOfTruthAdapter ?? !1;
+  if (t.mantineAdapterVersion && o)
+    throw new Error(
+      "--source-of-truth-version has no effect on the source-of-truth adapter's own config (isSourceOfTruthAdapter: true) — there's nothing to pin a version for."
+    );
+  const s = r.name ?? Se(e), n = ((p = r.storybook) == null ? void 0 : p.port) ?? be(e), d = ((f = r.storybook) == null ? void 0 : f.command) ?? L, h = j(e, ((T = r.storybook) == null ? void 0 : T.cwd) ?? "."), y = {
+    command: d,
+    port: n,
+    cwd: h,
     reuseExistingServer: !process.env.CI,
+    cacheFile: a(e, ".adapter-tester", "last-port-own.json"),
     timeout: 120 * 1e3
-  }, u = {
-    diffThresholdPixels: o.diffThresholdPixels ?? ue,
-    storyThresholds: o.storyThresholds,
-    excludeTitlePrefixes: o.excludeTitlePrefixes,
-    excludeStoryIds: o.excludeStoryIds,
+  }, w = {
+    goldenThresholdPixels: r.goldenThresholdPixels ?? ve,
+    sourceOfTruthThresholdPixels: r.sourceOfTruthThresholdPixels ?? Te,
+    stories: r.stories,
+    excludeTitlePrefixes: r.excludeTitlePrefixes,
     // Keyed off `ownCwd`, not `cwd` — the project actually being tested, not
-    // wherever the config file happens to live. Matters for this monorepo's
-    // own non-standard config, whose `storybook.cwd` points at a sibling
-    // package: its goldens must resolve to that package's own `test/golden/`
-    // (the same directory used when that package runs adapter-tester
-    // directly), not a directory under `packages/adapter-tester/`.
-    goldenDir: i(c, "test", "golden"),
-    isSourceOfTruthAdapter: e,
+    // wherever the config file happens to live. Matters whenever
+    // `storybook.cwd` points at a sibling package: its goldens must resolve
+    // to that package's own `test/golden/` (the same directory used when
+    // that package runs adapter-tester directly), not a directory under
+    // wherever this config file lives.
+    goldenDir: a(h, "test", "golden"),
+    isSourceOfTruthAdapter: o,
     // Overwritten by the CLI from --update-golden/--approve-divergence.
-    goldenMode: "check"
+    goldenMode: "check",
+    // Overwritten by the CLI from --divergence-only.
+    checkMode: "own"
   };
-  if (e)
+  if (o)
     return {
       engineConfig: {
-        ...u,
-        targets: [{ name: r, url: `http://localhost:${s}` }]
+        ...w,
+        targets: [{ name: s, url: `http://localhost:${n}` }]
       },
-      webServers: [h]
+      webServers: [y]
     };
-  const n = o.sourceOfTruth ?? {
+  const i = r.sourceOfTruth ?? {
     type: "mantine-harness"
   };
-  let l, f, w, m;
-  if (n.type === "url") {
-    l = n.name ?? C, f = n.port;
-    const d = P(t, n.cwd ?? ".");
-    w = {
-      command: n.command ?? _,
-      port: n.port,
-      cwd: d,
+  let u, l, v, c;
+  if (i.type === "url") {
+    if (t.mantineAdapterVersion)
+      throw new Error(
+        `--source-of-truth-version has no effect with sourceOfTruth.type: "url" — that mode reads a sibling package's local checkout directly, not a published version.`
+      );
+    u = i.name ?? R, l = i.port ?? C;
+    const b = j(e, i.cwd ?? ".");
+    v = {
+      command: i.command ?? L,
+      port: l,
+      cwd: b,
       reuseExistingServer: !process.env.CI,
+      cacheFile: a(e, ".adapter-tester", "last-port-source-of-truth.json"),
       timeout: 120 * 1e3
-    }, m = {
+    }, c = {
       type: "local",
-      dir: i(d, "test", "golden")
+      dir: a(b, "test", "golden")
     };
-  } else
-    l = C, f = n.port ?? le, w = H({
-      dir: i(t, ".adapter-tester/mantine-harness"),
-      port: f,
-      mantineAdapterVersion: n.mantineAdapterVersion,
-      storybookTemplateVersion: n.storybookTemplateVersion
-    }), m = {
+  } else {
+    u = R, l = i.port ?? C;
+    const b = t.mantineAdapterVersion ?? i.mantineAdapterVersion;
+    v = X({
+      dir: a(e, ".adapter-tester/mantine-harness"),
+      port: l,
+      mantineAdapterVersion: b,
+      storybookTemplateVersion: i.storybookTemplateVersion
+    }), c = {
       type: "npm",
-      packageName: ce,
-      versionSpec: n.mantineAdapterVersion ?? "latest",
-      cacheDir: i(t, ".adapter-tester/mantine-golden-cache")
+      packageName: ge,
+      versionSpec: b ?? "latest",
+      cacheDir: a(e, ".adapter-tester/mantine-golden-cache")
     };
+  }
   return {
     engineConfig: {
-      ...u,
+      ...w,
       targets: [
         {
-          name: l,
-          url: `http://localhost:${f}`,
+          name: u,
+          url: `http://localhost:${l}`,
           sourceOfTruth: !0
         },
-        { name: r, url: `http://localhost:${s}` }
+        { name: s, url: `http://localhost:${n}` }
       ],
-      sourceOfTruthGolden: m
+      sourceOfTruthGolden: c
     },
     // [sourceOfTruth, own] — Dev Mode needs both; the automated golden run
     // (cli.ts) only ever boots the last entry, since its divergence check
     // reads stored golden files, not a live source-of-truth page.
-    webServers: [w, h]
+    webServers: [v, y]
   };
 }
-const ye = F(I(import.meta.url)), we = V(i(ye, "testing.js")).href, k = process.cwd(), { engineConfig: y, webServers: O } = ge(k);
-process.argv.includes("--update-golden") ? y.goldenMode = "update-golden" : process.argv.includes("--approve-divergence") && (y.goldenMode = "approve-divergence");
-process.argv.includes("--dry-run") && (console.log(JSON.stringify({ engineConfig: y, webServers: O }, null, 2)), process.exit(0));
-const ve = /* @__PURE__ */ new Set([
+const xe = D(M(import.meta.url)), Ae = H(a(xe, "testing.js")).href, g = process.argv.slice(2);
+let V;
+const k = g.indexOf("--source-of-truth-version");
+if (k !== -1) {
+  const e = g[k + 1];
+  if (e === void 0 || e.startsWith("--"))
+    throw new Error(
+      "--source-of-truth-version requires a value, e.g. --source-of-truth-version 0.53.0"
+    );
+  V = e, g.splice(k, 2);
+}
+const E = process.cwd(), { engineConfig: m, webServers: P } = Oe(E, {
+  mantineAdapterVersion: V
+});
+g.includes("--update-golden") ? m.goldenMode = "update-golden" : g.includes("--approve-divergence") && (m.goldenMode = "approve-divergence");
+if (g.includes("--divergence-only")) {
+  if (m.isSourceOfTruthAdapter)
+    throw new Error(
+      "--divergence-only has nothing to diverge from — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json."
+    );
+  m.checkMode = "divergence";
+} else if (m.goldenMode === "approve-divergence")
+  throw new Error(
+    "--approve-divergence only makes sense with --divergence-only — there's nothing to approve without the divergence check running."
+  );
+g.includes("--dry-run") && (console.log(JSON.stringify({ engineConfig: m, webServers: P }, null, 2)), process.exit(0));
+const Ee = /* @__PURE__ */ new Set([
   "--dry-run",
   "--serve",
   "--update-golden",
-  "--approve-divergence"
-]), be = process.argv.slice(2).filter((t) => !ve.has(t));
-if (process.argv.includes("--serve")) {
-  if (y.isSourceOfTruthAdapter)
-    throw new Error(
-      "Dev Mode (--serve) has nothing to sync this project's Storybook against — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json."
-    );
-  z(y, O);
-} else
-  Se(O.slice(-1), y);
-function Se(t, o) {
-  const e = i(k, ".adapter-tester/run");
-  J(e, { recursive: !0 }), x(
-    i(e, "playwright.config.js"),
+  "--approve-divergence",
+  "--divergence-only"
+]), Pe = g.filter((e) => !Ee.has(e));
+De().catch((e) => {
+  console.error(e), process.exitCode = 1;
+});
+async function De() {
+  if (g.includes("--serve")) {
+    if (m.isSourceOfTruthAdapter)
+      throw new Error(
+        "Dev Mode (--serve) has nothing to sync this project's Storybook against — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json."
+      );
+    await ne(m, P);
+  } else {
+    const e = P.at(-1);
+    if (!e)
+      throw new Error("resolveConfig() returned no webServers to boot.");
+    await je(e, m);
+  }
+}
+async function je(e, t) {
+  const r = a(E, ".adapter-tester/run");
+  F(r, { recursive: !0 });
+  const o = t.targets.at(-1);
+  if (!o)
+    throw new Error("resolveConfig() returned no targets to check.");
+  const { url: s, process: n } = await A(
+    x(o.name, e)
+  );
+  o.url = s, O(
+    a(r, "playwright.config.js"),
     `// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
 import { defineConfig, devices } from "@playwright/test";
 
 export default defineConfig({
-  testDir: ${JSON.stringify(e)},
-  // Golden checks read-modify-write the same manifest.json across every
-  // story's test body — forced sequential (no worker parallelism) so those
-  // writes never race each other.
-  fullyParallel: false,
+  testDir: ${JSON.stringify(r)},
+  // Stories run across Playwright's default worker pool — each golden check
+  // only reads/writes its own story's manifest.json entry, under a lock, so
+  // concurrent workers never race each other (see \`updateManifestEntry\`).
+  // Override with \`--workers <n>\` (forwarded straight through to Playwright).
+  fullyParallel: true,
   forbidOnly: !!process.env.CI,
   retries: process.env.CI ? 2 : 0,
-  workers: 1,
   reporter: [["html", { open: "never" }], ["list"]],
   use: { trace: "on-first-retry" },
   projects: [{ name: "chromium", use: { ...devices["Desktop Chrome"] } }],
-  webServer: ${JSON.stringify(t, null, 2)},
+  // No webServer entry — this project's own Storybook is already running by
+  // the time this config is used (see runAutomated() in cli.ts).
 });
 `
-  ), x(
-    i(e, "visual-regression.spec.js"),
+  ), O(
+    a(r, "visual-regression.spec.js"),
     `// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
-import { runVisualRegression } from ${JSON.stringify(we)};
+import { test, expect } from "@playwright/test";
+import { resolveVisualRegressionPlan } from ${JSON.stringify(Ae)};
+
+// \`test.describe\`/\`test\` are called here, not inside resolveVisualRegressionPlan,
+// so Playwright's HTML report groups the suite under this file instead of a
+// sourcemapped path into adapter-tester's own library code.
+const { ownTargetName, suiteLabel, stories, missingFromSourceOfTruth, checkStory } =
+  await resolveVisualRegressionPlan(${JSON.stringify(t, null, 2)});
 
-await runVisualRegression(${JSON.stringify(o, null, 2)});
+test.describe(\`\${ownTargetName} — \${suiteLabel}\`, () => {
+  if (missingFromSourceOfTruth.length > 0) {
+    test("story parity with source of truth", () => {
+      expect(
+        missingFromSourceOfTruth,
+        \`\${missingFromSourceOfTruth.length} stor(y/ies) exist in the source of truth but are missing here. Add the missing story, or mark it \\\`exclude: true\\\` under \\\`stories\\\` in adapter-tester.config.json if intentional.\`,
+      ).toEqual([]);
+    });
+  }
+  for (const story of stories) {
+    test(story.id, async ({ browser }, testInfo) => {
+      await checkStory(story, browser, testInfo);
+    });
+  }
+});
 `
   );
-  const r = G(
-    "npx",
-    [
-      "playwright",
-      "test",
-      "--config",
-      i(e, "playwright.config.js"),
-      ...be
-    ],
-    { stdio: "inherit", cwd: k, shell: process.platform === "win32" }
-  );
-  process.exit(r.status ?? 1);
+  try {
+    const d = q(
+      "npx",
+      [
+        "playwright",
+        "test",
+        "--config",
+        a(r, "playwright.config.js"),
+        ...Pe
+      ],
+      { stdio: "inherit", cwd: E, shell: process.platform === "win32" }
+    );
+    process.exitCode = d.status ?? 1;
+  } finally {
+    n == null || n.kill("SIGTERM");
+  }
 }
 //# sourceMappingURL=cli.js.map