@recursica/adapter-tester 4.0.0 → 5.0.0

package/dist/cli.js

@@ -1,209 +1,255 @@
 #!/usr/bin/env node
-import { spawn as F, spawnSync as B } from "node:child_process";
-import { readFileSync as S, existsSync as M, mkdirSync as W, writeFileSync as A } from "node:fs";
-import { dirname as I, join as a, resolve as E } from "node:path";
-import { fileURLToPath as V, pathToFileURL as q } from "node:url";
-import H from "node:net";
-import K from "express";
-import { createProxyMiddleware as Y } from "http-proxy-middleware";
-import { m as X } from "./mantineSourceOfTruth-BUkqMNEo.js";
-import { a as z, i as Q } from "./index-DqQzFSAH.js";
-const j = I(V(import.meta.url));
-function O(t) {
-  return new Promise((r) => {
-    const e = new H.Socket();
-    e.setTimeout(200), e.once("connect", () => {
-      e.destroy(), r(!0);
-    }), e.once("timeout", () => {
-      e.destroy(), r(!1);
-    }), e.once("error", () => {
-      e.destroy(), r(!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 $(t, r = 6e4) {
-  const e = Date.now();
-  for (; Date.now() - e < r; ) {
-    if (await O(t)) return !0;
-    await new Promise((o) => setTimeout(o, 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 N(t) {
-  return Number(new URL(t).port);
+function re(e, t) {
+  F(D(e), { recursive: !0 }), O(e, JSON.stringify({ port: t }));
 }
-function L(t, r) {
-  var o, s;
-  console.log(
-    `[Dev Launcher] Port ${r.port} is inactive. Launching Storybook for ${t}...`
-  );
-  const e = F(r.command, {
-    cwd: r.cwd,
-    stdio: "pipe",
-    shell: !0
-  });
-  return (o = e.stdout) == null || o.on("data", (n) => {
-    for (const p of n.toString().split(`
-`))
-      p.trim() && console.log(`[${t} SB] ${p.trim()}`);
-  }), (s = e.stderr) == null || s.on("data", (n) => {
-    for (const p of n.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(`
 `))
-      p.trim() && console.error(`[${t} SB ERROR] ${p.trim()}`);
-  }), e.on("error", (n) => {
-    console.error(`[${t} SB ERROR] Failed to start process:`, n);
-  }), 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 Z(t) {
-  const r = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-  console.log(`[Dev Launcher] Auto-launching browser: ${t}`), F(r, [t], { shell: process.platform === "win32" }).on(
+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);
+}
+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 ee(t, r, e = {}) {
-  const [o, s] = t.targets, [n, p] = r;
-  if (!(o != null && o.sourceOfTruth) || !s || s.sourceOfTruth || !n || !p)
+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 y = e.port ?? 6010, f = N(o.url), m = N(s.url), i = K(), b = a(j, "../public"), w = a(j, "../report-header.txt");
-  i.get("/", (d, l, c) => {
-    if (d.query.path) {
-      c();
+  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 x = S(a(b, "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: o.name,
-        sourceOfTruthPort: f
+        sourceOfTruthPort: y.port
       })};<\/script>`
     );
-    l.send(x);
-  }), i.get("/report-header.txt", (d, l) => {
+    T.send(J);
+  }), u.get("/report-header.txt", (f, T) => {
     try {
-      l.type("text/plain").send(S(w, "utf8"));
+      T.type("text/plain").send(S(v, "utf8"));
     } catch {
-      l.status(500).send("Error loading report-header.txt");
+      T.status(500).send("Error loading report-header.txt");
     }
-  }), i.use(
+  }), u.use(
     "/",
-    Y({
-      target: `http://localhost:${m}`,
+    B({
+      target: w.url,
       changeOrigin: !0,
       ws: !0
     })
   );
-  const g = [];
-  let v = !1;
-  const k = () => {
-    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 d of g) d.kill("SIGINT");
+      for (const f of i) f.kill("SIGINT");
       process.exit(0);
     }
   };
-  process.on("SIGINT", k), process.on("SIGTERM", k), i.listen(y, async () => {
+  process.on("SIGINT", p), process.on("SIGTERM", p), u.listen(h, () => {
     console.log(`
 ====================================================
 🚀 Adapter Dev Mode proxy running at:
-   http://localhost:${y}
+   http://localhost:${h}
 ====================================================
-`);
-    const [d, l] = await Promise.all([
-      O(f),
-      O(m)
-    ]);
-    d ? console.log(
-      `[Dev Launcher] ${o.name} is already running on port ${f}.`
-    ) : g.push(L(o.name, n)), l ? console.log(
-      `[Dev Launcher] ${s.name} is already running on port ${m}.`
-    ) : g.push(L(s.name, p));
-    const c = [];
-    d || c.push($(f)), l || c.push($(m)), c.length > 0 ? (console.log("[Dev Launcher] Waiting for Storybooks to be responsive..."), (await Promise.all(c)).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."), Z(`http://localhost:${y}`);
+`), se(`http://localhost:${h}`);
   });
 }
-const te = "http://json-schema.org/draft-07/schema#", re = "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json", oe = "adapter-tester.config.json", se = "Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.", ne = "object", ie = !1, ae = { $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: "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." }, stories: { type: "object", additionalProperties: { type: "object", additionalProperties: !1, properties: { threshold: { type: "number", minimum: 0, description: "Diff threshold override for matching stories, in mismatched pixels. Overrides `diffThresholdPixels`." }, 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`)." } }, ce = {
-  $schema: te,
-  $id: re,
-  title: oe,
-  description: se,
-  type: ne,
-  additionalProperties: ie,
-  properties: ae
-}, pe = Q, U = new z.Ajv({ allErrors: !0, strict: !0 });
-pe(U);
-const R = U.compile(ce);
-function de(t, r) {
-  if (R(t)) return;
-  const e = (R.errors ?? []).map((o) => {
+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 ${r}:
-${e}`);
+  throw new Error(`Invalid ${t}:
+${r}`);
 }
-const le = "@recursica/mantine-adapter", ue = "adapter-tester.config.json", C = "npm run storybook", he = 6006, fe = 6011, _ = "Mantine", me = 3500;
-function G(t) {
-  const r = a(t, "package.json");
-  if (!M(r))
+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(r, "utf8"));
+  return JSON.parse(S(t, "utf8"));
 }
-function ge(t) {
+function be(e) {
   var s;
-  const e = (s = G(t).scripts) == null ? void 0 : s.storybook, o = e == null ? void 0 : e.match(/(?:-p|--port)[ =](\d+)/);
-  return o ? Number(o[1]) : he;
+  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 ye(t) {
-  const e = G(t).name;
-  return e ? e.split("/").pop() : "Adapter";
+function Se(e) {
+  const r = G(e).name;
+  return r ? r.split("/").pop() : "Adapter";
 }
-function we(t) {
-  const r = a(t, ue);
-  if (!M(r))
+function ke(e) {
+  const t = a(e, ye);
+  if (!I(t))
     return {};
-  const e = JSON.parse(S(r, "utf8"));
-  return de(e, r), e;
+  const r = JSON.parse(S(t, "utf8"));
+  return me(r, t), r;
 }
-function ve(t, r = {}) {
-  var k, d, l;
-  const e = we(t), o = e.isSourceOfTruthAdapter ?? !1;
-  if (r.mantineAdapterVersion && o)
+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 = e.name ?? ye(t), n = ((k = e.storybook) == null ? void 0 : k.port) ?? ge(t), p = ((d = e.storybook) == null ? void 0 : d.command) ?? C, y = E(t, ((l = e.storybook) == null ? void 0 : l.cwd) ?? "."), f = {
-    command: p,
+  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: y,
+    cwd: h,
     reuseExistingServer: !process.env.CI,
+    cacheFile: a(e, ".adapter-tester", "last-port-own.json"),
     timeout: 120 * 1e3
-  }, m = {
-    diffThresholdPixels: e.diffThresholdPixels ?? me,
-    stories: e.stories,
-    excludeTitlePrefixes: e.excludeTitlePrefixes,
+  }, 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 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(y, "test", "golden"),
+    goldenDir: a(h, "test", "golden"),
     isSourceOfTruthAdapter: o,
     // Overwritten by the CLI from --update-golden/--approve-divergence.
     goldenMode: "check",
@@ -213,116 +259,133 @@ function ve(t, r = {}) {
   if (o)
     return {
       engineConfig: {
-        ...m,
+        ...w,
         targets: [{ name: s, url: `http://localhost:${n}` }]
       },
-      webServers: [f]
+      webServers: [y]
     };
-  const i = e.sourceOfTruth ?? {
+  const i = r.sourceOfTruth ?? {
     type: "mantine-harness"
   };
-  let b, w, g, v;
+  let u, l, v, c;
   if (i.type === "url") {
-    if (r.mantineAdapterVersion)
+    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.`
       );
-    b = i.name ?? _, w = i.port;
-    const c = E(t, i.cwd ?? ".");
-    g = {
-      command: i.command ?? C,
-      port: i.port,
-      cwd: c,
+    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
-    }, v = {
+    }, c = {
       type: "local",
-      dir: a(c, "test", "golden")
+      dir: a(b, "test", "golden")
     };
   } else {
-    b = _, w = i.port ?? fe;
-    const c = r.mantineAdapterVersion ?? i.mantineAdapterVersion;
-    g = X({
-      dir: a(t, ".adapter-tester/mantine-harness"),
-      port: w,
-      mantineAdapterVersion: c,
+    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
-    }), v = {
+    }), c = {
       type: "npm",
-      packageName: le,
-      versionSpec: c ?? "latest",
-      cacheDir: a(t, ".adapter-tester/mantine-golden-cache")
+      packageName: ge,
+      versionSpec: b ?? "latest",
+      cacheDir: a(e, ".adapter-tester/mantine-golden-cache")
     };
   }
   return {
     engineConfig: {
-      ...m,
+      ...w,
       targets: [
         {
-          name: b,
-          url: `http://localhost:${w}`,
+          name: u,
+          url: `http://localhost:${l}`,
           sourceOfTruth: !0
         },
         { name: s, url: `http://localhost:${n}` }
       ],
-      sourceOfTruthGolden: v
+      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: [g, f]
+    webServers: [v, y]
   };
 }
-const be = I(V(import.meta.url)), ke = q(a(be, "testing.js")).href, h = process.argv.slice(2);
-let J;
-const T = h.indexOf("--source-of-truth-version");
-if (T !== -1) {
-  const t = h[T + 1];
-  if (t === void 0 || t.startsWith("--"))
+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"
     );
-  J = t, h.splice(T, 2);
+  V = e, g.splice(k, 2);
 }
-const P = process.cwd(), { engineConfig: u, webServers: D } = ve(P, {
-  mantineAdapterVersion: J
+const E = process.cwd(), { engineConfig: m, webServers: P } = Oe(E, {
+  mantineAdapterVersion: V
 });
-h.includes("--update-golden") ? u.goldenMode = "update-golden" : h.includes("--approve-divergence") && (u.goldenMode = "approve-divergence");
-if (h.includes("--divergence-only")) {
-  if (u.isSourceOfTruthAdapter)
+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."
     );
-  u.checkMode = "divergence";
-} else if (u.goldenMode === "approve-divergence")
+  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."
   );
-h.includes("--dry-run") && (console.log(JSON.stringify({ engineConfig: u, webServers: D }, null, 2)), process.exit(0));
-const Se = /* @__PURE__ */ new Set([
+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",
   "--divergence-only"
-]), Te = h.filter((t) => !Se.has(t));
-if (h.includes("--serve")) {
-  if (u.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."
-    );
-  ee(u, D);
-} else
-  Oe(D.slice(-1), u);
-function Oe(t, r) {
-  const e = a(P, ".adapter-tester/run");
-  W(e, { recursive: !0 }), A(
-    a(e, "playwright.config.js"),
+]), 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)},
+  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\`).
@@ -333,22 +396,31 @@ export default defineConfig({
   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).
 });
 `
-  ), A(
-    a(e, "visual-regression.spec.js"),
+  ), O(
+    a(r, "visual-regression.spec.js"),
     `// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
-import { test } from "@playwright/test";
-import { resolveVisualRegressionPlan } from ${JSON.stringify(ke)};
+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, checkStory } =
-  await resolveVisualRegressionPlan(${JSON.stringify(r, null, 2)});
+const { ownTargetName, suiteLabel, stories, missingFromSourceOfTruth, checkStory } =
+  await resolveVisualRegressionPlan(${JSON.stringify(t, 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);
@@ -357,17 +429,21 @@ test.describe(\`\${ownTargetName} — \${suiteLabel}\`, () => {
 });
 `
   );
-  const o = B(
-    "npx",
-    [
-      "playwright",
-      "test",
-      "--config",
-      a(e, "playwright.config.js"),
-      ...Te
-    ],
-    { stdio: "inherit", cwd: P, shell: process.platform === "win32" }
-  );
-  process.exit(o.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