@recursica/adapter-tester 3.0.0 → 4.0.0

package/dist/cli.js

@@ -1,323 +1,373 @@
 #!/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();
+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(), o(!0);
+      e.destroy(), r(!0);
     }), e.once("timeout", () => {
-      e.destroy(), o(!1);
+      e.destroy(), r(!1);
     }), e.once("error", () => {
-      e.destroy(), o(!1);
+      e.destroy(), r(!1);
     }), e.connect(t, "127.0.0.1");
   });
 }
-async function j(t, o = 6e4) {
+async function $(t, r = 6e4) {
   const e = Date.now();
-  for (; Date.now() - e < o; ) {
-    if (await T(t)) return !0;
-    await new Promise((r) => setTimeout(r, 500));
+  for (; Date.now() - e < r; ) {
+    if (await O(t)) return !0;
+    await new Promise((o) => setTimeout(o, 500));
   }
   return !1;
 }
-function E(t) {
+function N(t) {
   return Number(new URL(t).port);
 }
-function $(t, o) {
-  var r, s;
+function L(t, r) {
+  var o, s;
   console.log(
-    `[Dev Launcher] Port ${o.port} is inactive. Launching Storybook for ${t}...`
+    `[Dev Launcher] Port ${r.port} is inactive. Launching Storybook for ${t}...`
   );
-  const e = R(o.command, {
-    cwd: o.cwd,
+  const e = F(r.command, {
+    cwd: r.cwd,
     stdio: "pipe",
     shell: !0
   });
-  return (r = e.stdout) == null || r.on("data", (a) => {
-    for (const c of a.toString().split(`
+  return (o = e.stdout) == null || o.on("data", (n) => {
+    for (const p of n.toString().split(`
 `))
-      c.trim() && console.log(`[${t} SB] ${c.trim()}`);
-  }), (s = e.stderr) == null || s.on("data", (a) => {
-    for (const c of a.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(`
 `))
-      c.trim() && console.error(`[${t} SB ERROR] ${c.trim()}`);
-  }), e.on("error", (a) => {
-    console.error(`[${t} SB ERROR] Failed to start process:`, a);
+      p.trim() && console.error(`[${t} SB ERROR] ${p.trim()}`);
+  }), e.on("error", (n) => {
+    console.error(`[${t} SB ERROR] Failed to start process:`, n);
   }), e;
 }
-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(
+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(
     "error",
     (e) => {
       console.error("[Dev Launcher] Failed to auto-launch browser:", e);
     }
   );
 }
-function z(t, o, e = {}) {
-  const [r, s] = t.targets, [a, c] = o;
-  if (!(r != null && r.sourceOfTruth) || !s || s.sourceOfTruth || !a || !c)
+function ee(t, r, e = {}) {
+  const [o, s] = t.targets, [n, p] = r;
+  if (!(o != null && o.sourceOfTruth) || !s || s.sourceOfTruth || !n || !p)
     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 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();
       return;
     }
-    const D = S(i(f, "index.html"), "utf8").replace(
+    const x = S(a(b, "index.html"), "utf8").replace(
       "<head>",
       `<head>
   <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({
         ownName: s.name,
-        sourceOfTruthName: r.name,
-        sourceOfTruthPort: u
+        sourceOfTruthName: o.name,
+        sourceOfTruthPort: f
       })};<\/script>`
     );
-    d.send(D);
-  }), l.get("/report-header.txt", (p, d) => {
+    l.send(x);
+  }), i.get("/report-header.txt", (d, l) => {
     try {
-      d.type("text/plain").send(S(w, "utf8"));
+      l.type("text/plain").send(S(w, "utf8"));
     } catch {
-      d.status(500).send("Error loading report-header.txt");
+      l.status(500).send("Error loading report-header.txt");
     }
-  }), l.use(
+  }), i.use(
     "/",
-    W({
-      target: `http://localhost:${n}`,
+    Y({
+      target: `http://localhost:${m}`,
       changeOrigin: !0,
       ws: !0
     })
   );
-  const m = [];
+  const g = [];
   let v = !1;
-  const b = () => {
+  const k = () => {
     if (!v) {
       v = !0, console.log(
         `
 [Dev Launcher] Shutting down Dev Mode server and spawned Storybooks...`
       );
-      for (const p of m) p.kill("SIGINT");
+      for (const d of g) d.kill("SIGINT");
       process.exit(0);
     }
   };
-  process.on("SIGINT", b), process.on("SIGTERM", b), l.listen(h, async () => {
+  process.on("SIGINT", k), process.on("SIGTERM", k), i.listen(y, async () => {
     console.log(`
 ====================================================
 🚀 Adapter Dev Mode proxy running at:
-   http://localhost:${h}
+   http://localhost:${y}
 ====================================================
 `);
-    const [p, d] = await Promise.all([
-      T(u),
-      T(n)
+    const [d, l] = await Promise.all([
+      O(f),
+      O(m)
     ]);
-    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(
+    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."), X(`http://localhost:${h}`);
+    )) : console.log("[Dev Launcher] Both Storybooks already active."), Z(`http://localhost:${y}`);
   });
 }
-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 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) => {
+    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}:
+  throw new Error(`Invalid ${r}:
 ${e}`);
 }
-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 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))
     throw new Error(
       `No package.json found in ${t} — run adapter-tester from the root of the project being tested.`
     );
-  return JSON.parse(S(o, "utf8"));
+  return JSON.parse(S(r, "utf8"));
 }
-function me(t) {
+function ge(t) {
   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 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;
 }
-function he(t) {
-  const e = U(t).name;
+function ye(t) {
+  const e = G(t).name;
   return e ? e.split("/").pop() : "Adapter";
 }
-function fe(t) {
-  const o = i(t, pe);
-  if (!L(o))
+function we(t) {
+  const r = a(t, ue);
+  if (!M(r))
     return {};
-  const e = JSON.parse(S(o, "utf8"));
-  return ae(e, o), e;
+  const e = JSON.parse(S(r, "utf8"));
+  return de(e, r), e;
 }
-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 ve(t, r = {}) {
+  var k, d, l;
+  const e = we(t), o = e.isSourceOfTruthAdapter ?? !1;
+  if (r.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,
+    port: n,
+    cwd: y,
     reuseExistingServer: !process.env.CI,
     timeout: 120 * 1e3
-  }, u = {
-    diffThresholdPixels: o.diffThresholdPixels ?? ue,
-    storyThresholds: o.storyThresholds,
-    excludeTitlePrefixes: o.excludeTitlePrefixes,
-    excludeStoryIds: o.excludeStoryIds,
+  }, m = {
+    diffThresholdPixels: e.diffThresholdPixels ?? me,
+    stories: e.stories,
+    excludeTitlePrefixes: e.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(y, "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}` }]
+        ...m,
+        targets: [{ name: s, url: `http://localhost:${n}` }]
       },
-      webServers: [h]
+      webServers: [f]
     };
-  const n = o.sourceOfTruth ?? {
+  const i = e.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 b, w, g, v;
+  if (i.type === "url") {
+    if (r.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,
       reuseExistingServer: !process.env.CI,
       timeout: 120 * 1e3
-    }, m = {
+    }, v = {
       type: "local",
-      dir: i(d, "test", "golden")
+      dir: a(c, "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 {
+    b = _, w = i.port ?? fe;
+    const c = r.mantineAdapterVersion ?? i.mantineAdapterVersion;
+    g = X({
+      dir: a(t, ".adapter-tester/mantine-harness"),
+      port: w,
+      mantineAdapterVersion: c,
+      storybookTemplateVersion: i.storybookTemplateVersion
+    }), v = {
       type: "npm",
-      packageName: ce,
-      versionSpec: n.mantineAdapterVersion ?? "latest",
-      cacheDir: i(t, ".adapter-tester/mantine-golden-cache")
+      packageName: le,
+      versionSpec: c ?? "latest",
+      cacheDir: a(t, ".adapter-tester/mantine-golden-cache")
     };
+  }
   return {
     engineConfig: {
-      ...u,
+      ...m,
       targets: [
         {
-          name: l,
-          url: `http://localhost:${f}`,
+          name: b,
+          url: `http://localhost:${w}`,
           sourceOfTruth: !0
         },
-        { name: r, url: `http://localhost:${s}` }
+        { name: s, url: `http://localhost:${n}` }
       ],
-      sourceOfTruthGolden: m
+      sourceOfTruthGolden: v
     },
     // [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: [g, f]
   };
 }
-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 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("--"))
+    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);
+}
+const P = process.cwd(), { engineConfig: u, webServers: D } = ve(P, {
+  mantineAdapterVersion: J
+});
+h.includes("--update-golden") ? u.goldenMode = "update-golden" : h.includes("--approve-divergence") && (u.goldenMode = "approve-divergence");
+if (h.includes("--divergence-only")) {
+  if (u.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")
+  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([
   "--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)
+  "--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."
     );
-  z(y, O);
+  ee(u, D);
 } 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"),
+  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"),
     `// 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,
+  // 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)},
 });
 `
-  ), x(
-    i(e, "visual-regression.spec.js"),
+  ), A(
+    a(e, "visual-regression.spec.js"),
     `// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
-import { runVisualRegression } from ${JSON.stringify(we)};
+import { test } from "@playwright/test";
+import { resolveVisualRegressionPlan } from ${JSON.stringify(ke)};
+
+// \`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)});
 
-await runVisualRegression(${JSON.stringify(o, null, 2)});
+test.describe(\`\${ownTargetName} — \${suiteLabel}\`, () => {
+  for (const story of stories) {
+    test(story.id, async ({ browser }, testInfo) => {
+      await checkStory(story, browser, testInfo);
+    });
+  }
+});
 `
   );
-  const r = G(
+  const o = B(
     "npx",
     [
       "playwright",
       "test",
       "--config",
-      i(e, "playwright.config.js"),
-      ...be
+      a(e, "playwright.config.js"),
+      ...Te
     ],
-    { stdio: "inherit", cwd: k, shell: process.platform === "win32" }
+    { stdio: "inherit", cwd: P, shell: process.platform === "win32" }
   );
-  process.exit(r.status ?? 1);
+  process.exit(o.status ?? 1);
 }
 //# sourceMappingURL=cli.js.map