@recursica/adapter-tester 5.1.3 → 5.2.0

package/dist/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { spawn as _, spawnSync as W } from "node:child_process";
-import { readFileSync as S, mkdirSync as I, writeFileSync as x, existsSync as M } from "node:fs";
-import { dirname as j, join as a, resolve as $ } from "node:path";
-import { fileURLToPath as U, pathToFileURL as B } from "node:url";
+import { spawn as I, spawnSync as W } from "node:child_process";
+import { readFileSync as T, mkdirSync as M, writeFileSync as E, existsSync as U } from "node:fs";
+import { dirname as N, join as a, resolve as $ } from "node:path";
+import { fileURLToPath as G, pathToFileURL as B } from "node:url";
 import K from "express";
 import { createProxyMiddleware as X } from "http-proxy-middleware";
 import Y from "node:net";
-import { m as z } from "./mantineSourceOfTruth-BDJ5mfpd.js";
+import { m as z } from "./mantineSourceOfTruth-CAKhcVCT.js";
 import { a as Q, i as Z } from "./index-DqQzFSAH.js";
 const ee = /\x1b\[[0-9;]*m/g, te = /Local:\s*(https?:\/\/localhost:\d+)/;
 function re(e) {
@@ -23,19 +23,19 @@ function re(e) {
 }
 function oe(e) {
   try {
-    const t = JSON.parse(S(e, "utf8")).port;
+    const t = JSON.parse(T(e, "utf8")).port;
     return typeof t == "number" ? t : void 0;
   } catch {
     return;
   }
 }
 function se(e, t) {
-  I(j(e), { recursive: !0 }), x(e, JSON.stringify({ port: t }));
+  M(N(e), { recursive: !0 }), E(e, JSON.stringify({ port: t }));
 }
 function ne(e, t) {
   return new Promise((r, o) => {
     var y, w;
-    const s = _(e.command, {
+    const s = I(e.command, {
       cwd: e.cwd,
       stdio: "pipe",
       shell: !0
@@ -47,23 +47,23 @@ function ne(e, t) {
           `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), f = (i, u) => {
-      const p = i.toString();
-      for (const c of p.split(`
+    }, t), p = (i, u) => {
+      const h = i.toString();
+      for (const c of h.split(`
 `))
         if (c.trim()) {
-          const h = u ? `${e.name} SB ERROR` : `${e.name} SB`;
-          (u ? console.error : console.log)(`[${h}] ${c.trim()}`);
+          const f = u ? `${e.name} SB ERROR` : `${e.name} SB`;
+          (u ? console.error : console.log)(`[${f}] ${c.trim()}`);
         }
       if (n) return;
-      const v = p.replace(ee, "").match(te);
+      const v = h.replace(ee, "").match(te);
       if (v) {
         n = !0, clearTimeout(l);
-        const c = v[1], h = Number(new URL(c).port);
-        se(e.cacheFile, h), r({ url: c, port: h, process: s });
+        const c = v[1], f = Number(new URL(c).port);
+        se(e.cacheFile, f), r({ url: c, port: f, process: s });
       }
     };
-    (y = s.stdout) == null || y.on("data", (i) => f(i, !1)), (w = s.stderr) == null || w.on("data", (i) => f(i, !0)), s.on("error", (i) => {
+    (y = s.stdout) == null || y.on("data", (i) => p(i, !1)), (w = s.stderr) == null || w.on("data", (i) => p(i, !0)), s.on("error", (i) => {
       n || (n = !0, clearTimeout(l), o(i));
     }), s.on("exit", (i) => {
       n || (n = !0, clearTimeout(l), o(
@@ -74,7 +74,7 @@ function ne(e, t) {
     });
   });
 }
-function E(e, t) {
+function A(e, t) {
   return {
     name: e,
     command: t.command,
@@ -84,7 +84,7 @@ function E(e, t) {
     timeoutMs: t.timeout
   };
 }
-async function A(e) {
+async function D(e) {
   if (e.reuseExistingServer) {
     const t = oe(e.cacheFile);
     if (t !== void 0 && await re(t))
@@ -98,10 +98,10 @@ async function A(e) {
   }
   return console.log(`[Dev Launcher] Launching Storybook for ${e.name}...`), ne(e, e.timeoutMs ?? 120 * 1e3);
 }
-const N = j(U(import.meta.url));
+const _ = N(G(import.meta.url));
 function ie(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(
+  console.log(`[Dev Launcher] Auto-launching browser: ${e}`), I(t, [e], { shell: process.platform === "win32" }).on(
     "error",
     (r) => {
       console.error("[Dev Launcher] Failed to auto-launch browser:", r);
@@ -114,26 +114,26 @@ async function ae(e, t, r = {}) {
     throw new Error(
       "adapter-tester dev mode requires exactly two targets: [sourceOfTruth, target] — check adapter-tester.config.json."
     );
-  const f = r.port ?? 6010;
+  const p = r.port ?? 6010;
   console.log(
     `[Dev Launcher] Resolving ${o.name} and ${s.name} Storybooks...`
   );
   const [y, w] = await Promise.all([
-    A(
-      E(o.name, n)
+    D(
+      A(o.name, n)
     ),
-    A(E(s.name, l))
+    D(A(s.name, l))
   ]);
   console.log("[Dev Launcher] Both Storybooks are active and responsive!");
   const i = [y.process, w.process].filter(
     (m) => m !== null
-  ), u = K(), p = a(N, "../public"), v = a(N, "../report-header.txt");
-  u.get("/", (m, b, T) => {
+  ), u = K(), h = a(_, "../public"), v = a(_, "../report-header.txt");
+  u.get("/", (m, b, k) => {
     if (m.query.path) {
-      T();
+      k();
       return;
     }
-    const q = S(a(p, "index.html"), "utf8").replace(
+    const S = T(a(h, "index.html"), "utf8").replace(
       "<head>",
       `<head>
   <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({
@@ -142,14 +142,14 @@ async function ae(e, t, r = {}) {
         sourceOfTruthPort: y.port
       })};<\/script>`
     );
-    b.send(q);
+    b.send(S);
   }), u.get("/report-header.txt", (m, b) => {
     if (e.reportHeader !== void 0) {
       b.type("text/plain").send(e.reportHeader);
       return;
     }
     try {
-      b.type("text/plain").send(S(v, "utf8"));
+      b.type("text/plain").send(T(v, "utf8"));
     } catch {
       b.status(500).send("Error loading report-header.txt");
     }
@@ -162,7 +162,7 @@ async function ae(e, t, r = {}) {
     })
   );
   let c = !1;
-  const h = () => {
+  const f = () => {
     if (!c) {
       c = !0, console.log(
         `
@@ -172,16 +172,16 @@ async function ae(e, t, r = {}) {
       process.exit(0);
     }
   };
-  process.on("SIGINT", h), process.on("SIGTERM", h), u.listen(f, () => {
+  process.on("SIGINT", f), process.on("SIGTERM", f), u.listen(p, () => {
     console.log(`
 ====================================================
 🚀 Adapter Dev Mode proxy running at:
-   http://localhost:${f}
+   http://localhost:${p}
 ====================================================
-`), ie(`http://localhost:${f}`);
+`), ie(`http://localhost:${p}`);
   });
 }
-const ce = "http://json-schema.org/draft-07/schema#", de = "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json", ue = "adapter-tester.config.json", le = "Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.", pe = "object", he = !1, fe = { $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/adapter-mantine-v8 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/adapter-mantine-v8 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`)." }, reportHeader: { type: "string", description: 'Overrides the AI report header text shown in Dev Mode\'s "Full Report" export. Defaults to the contents of `report-header.txt`.' } }, me = {
+const ce = "http://json-schema.org/draft-07/schema#", de = "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json", ue = "adapter-tester.config.json", le = "Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.", pe = "object", he = !1, fe = { $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/adapter-mantine-v8 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/adapter-mantine-v8 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`." }, tokensSource: { type: "string", enum: ["target", "mantine-package"], description: `Which Recursica token snapshot the harness's Mantine components render with. "target" (default): this project's own committed recursica_variables_scoped.css/recursica_tokens.json/recursica_brand.json/recursica_ui-kit.json — makes the divergence check mean exactly "given the same tokens this project is using, does it render the same as Mantine's own components," isolating adapter-mapping correctness from any token-snapshot drift between repos. "mantine-package": @recursica/adapter-mantine-v8's own bundled token files instead (whatever it was last published with) — also flags, as a side effect, a project whose own committed tokens have gone stale relative to Mantine's. Never the deprecated @recursica/official-release package.` } } }, { 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 (@recursica/adapter-mantine-v8). 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`)." }, reportHeader: { type: "string", description: 'Overrides the AI report header text shown in Dev Mode\'s "Full Report" export. Defaults to the contents of `report-header.txt`.' } }, me = {
   $schema: ce,
   $id: de,
   title: ue,
@@ -189,9 +189,9 @@ const ce = "http://json-schema.org/draft-07/schema#", de = "https://github.com/b
   type: pe,
   additionalProperties: he,
   properties: fe
-}, ge = Z, G = new Q.Ajv({ allErrors: !0, strict: !0 });
-ge(G);
-const L = G.compile(me);
+}, ge = Z, V = new Q.Ajv({ allErrors: !0, strict: !0 });
+ge(V);
+const L = V.compile(me);
 function ye(e, t) {
   if (L(e)) return;
   const r = (L.errors ?? []).map((o) => {
@@ -203,48 +203,48 @@ function ye(e, t) {
   throw new Error(`Invalid ${t}:
 ${r}`);
 }
-const we = "@recursica/adapter-mantine-v8", ve = "adapter-tester.config.json", F = "npm run storybook", be = 6006, R = 6011, C = "Mantine", Te = 10, Se = 3500;
-function V(e) {
+const we = "@recursica/adapter-mantine-v8", ve = "adapter-tester.config.json", R = "npm run storybook", be = 6006, F = 6011, C = "Mantine", ke = 10, Te = 3500;
+function H(e) {
   const t = a(e, "package.json");
-  if (!M(t))
+  if (!U(t))
     throw new Error(
       `No package.json found in ${e} — run adapter-tester from the root of the project being tested.`
     );
-  return JSON.parse(S(t, "utf8"));
+  return JSON.parse(T(t, "utf8"));
 }
-function ke(e) {
+function Se(e) {
   var s;
-  const r = (s = V(e).scripts) == null ? void 0 : s.storybook, o = r == null ? void 0 : r.match(/(?:-p|--port)[ =](\d+)/);
+  const r = (s = H(e).scripts) == null ? void 0 : s.storybook, o = r == null ? void 0 : r.match(/(?:-p|--port)[ =](\d+)/);
   return o ? Number(o[1]) : be;
 }
 function Oe(e) {
-  const r = V(e).name;
+  const r = H(e).name;
   return r ? r.split("/").pop() : "Adapter";
 }
 function xe(e) {
   const t = a(e, ve);
-  if (!M(t))
+  if (!U(t))
     return {};
-  const r = JSON.parse(S(t, "utf8"));
+  const r = JSON.parse(T(t, "utf8"));
   return ye(r, t), r;
 }
 function Ee(e, t = {}) {
-  var h, m, b;
+  var f, m, b;
   const r = xe(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 ?? Oe(e), n = ((h = r.storybook) == null ? void 0 : h.port) ?? ke(e), l = ((m = r.storybook) == null ? void 0 : m.command) ?? F, f = $(e, ((b = r.storybook) == null ? void 0 : b.cwd) ?? "."), y = {
+  const s = r.name ?? Oe(e), n = ((f = r.storybook) == null ? void 0 : f.port) ?? Se(e), l = ((m = r.storybook) == null ? void 0 : m.command) ?? R, p = $(e, ((b = r.storybook) == null ? void 0 : b.cwd) ?? "."), y = {
     command: l,
     port: n,
-    cwd: f,
+    cwd: p,
     reuseExistingServer: !process.env.CI,
     cacheFile: a(e, ".adapter-tester", "last-port-own.json"),
     timeout: 120 * 1e3
   }, w = {
-    goldenThresholdPixels: r.goldenThresholdPixels ?? Te,
-    sourceOfTruthThresholdPixels: r.sourceOfTruthThresholdPixels ?? Se,
+    goldenThresholdPixels: r.goldenThresholdPixels ?? ke,
+    sourceOfTruthThresholdPixels: r.sourceOfTruthThresholdPixels ?? Te,
     stories: r.stories,
     excludeTitlePrefixes: r.excludeTitlePrefixes,
     reportHeader: r.reportHeader,
@@ -254,7 +254,7 @@ function Ee(e, t = {}) {
     // 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(f, "test", "golden"),
+    goldenDir: a(p, "test", "golden"),
     isSourceOfTruthAdapter: o,
     // Overwritten by the CLI from --update-golden/--approve-divergence.
     goldenMode: "check",
@@ -272,37 +272,42 @@ function Ee(e, t = {}) {
   const i = r.sourceOfTruth ?? {
     type: "mantine-harness"
   };
-  let u, p, v, c;
+  let u, h, 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 ?? C, p = i.port ?? R;
-    const T = $(e, i.cwd ?? ".");
+    u = i.name ?? C, h = i.port ?? F;
+    const k = $(e, i.cwd ?? ".");
     v = {
-      command: i.command ?? F,
-      port: p,
-      cwd: T,
+      command: i.command ?? R,
+      port: h,
+      cwd: k,
       reuseExistingServer: !process.env.CI,
       cacheFile: a(e, ".adapter-tester", "last-port-source-of-truth.json"),
       timeout: 120 * 1e3
     }, c = {
       type: "local",
-      dir: a(T, "test", "golden")
+      dir: a(k, "test", "golden")
     };
   } else {
-    u = C, p = i.port ?? R;
-    const T = t.mantineAdapterVersion ?? i.mantineAdapterVersion;
+    u = C, h = i.port ?? F;
+    const k = t.mantineAdapterVersion ?? i.mantineAdapterVersion, S = i.tokensSource ?? "target";
     v = z({
       dir: a(e, ".adapter-tester/mantine-harness"),
-      port: p,
-      mantineAdapterVersion: T,
-      storybookTemplateVersion: i.storybookTemplateVersion
+      port: h,
+      mantineAdapterVersion: k,
+      storybookTemplateVersion: i.storybookTemplateVersion,
+      tokensSource: S,
+      // `ownCwd`, not `cwd` — the project actually being tested (same
+      // reasoning `goldenDir` above uses), source of the 4 token files
+      // copied into the harness when `tokensSource` is "target".
+      targetDir: p
     }), c = {
       type: "npm",
       packageName: we,
-      versionSpec: T ?? "latest",
+      versionSpec: k ?? "latest",
       cacheDir: a(e, ".adapter-tester/mantine-golden-cache")
     };
   }
@@ -312,7 +317,7 @@ function Ee(e, t = {}) {
       targets: [
         {
           name: u,
-          url: `http://localhost:${p}`,
+          url: `http://localhost:${h}`,
           sourceOfTruth: !0
         },
         { name: s, url: `http://localhost:${n}` }
@@ -325,29 +330,29 @@ function Ee(e, t = {}) {
     webServers: [v, y]
   };
 }
-const Ae = j(U(import.meta.url)), De = B(a(Ae, "testing.js")).href, d = process.argv.slice(2);
-let H;
-const k = d.indexOf("--source-of-truth-version");
-if (k !== -1) {
-  const e = d[k + 1];
+const Ae = N(G(import.meta.url)), De = B(a(Ae, "testing.js")).href, d = process.argv.slice(2);
+let J;
+const O = d.indexOf("--source-of-truth-version");
+if (O !== -1) {
+  const e = d[O + 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"
     );
-  H = e, d.splice(k, 2);
+  J = e, d.splice(O, 2);
 }
-let J;
-const O = d.indexOf("--story");
-if (O !== -1) {
-  const e = d[O + 1];
+let q;
+const x = d.indexOf("--story");
+if (x !== -1) {
+  const e = d[x + 1];
   if (e === void 0 || e.startsWith("--"))
     throw new Error(
       "--story requires a story id, e.g. --story ui-kit-button--loading"
     );
-  J = e, d.splice(O, 2);
+  q = e, d.splice(x, 2);
 }
-const D = process.cwd(), { engineConfig: g, webServers: P } = Ee(D, {
-  mantineAdapterVersion: H
+const P = process.cwd(), { engineConfig: g, webServers: j } = Ee(P, {
+  mantineAdapterVersion: J
 });
 d.includes("--update-golden") ? g.goldenMode = "update-golden" : d.includes("--approve-divergence") && (g.goldenMode = "approve-divergence");
 if (d.includes("--divergence-only")) {
@@ -360,7 +365,7 @@ if (d.includes("--divergence-only")) {
   throw new Error(
     "--approve-divergence only makes sense with --divergence-only — there's nothing to approve without the divergence check running."
   );
-d.includes("--dry-run") && (console.log(JSON.stringify({ engineConfig: g, webServers: P }, null, 2)), process.exit(0));
+d.includes("--dry-run") && (console.log(JSON.stringify({ engineConfig: g, webServers: j }, null, 2)), process.exit(0));
 const Pe = /* @__PURE__ */ new Set([
   "--dry-run",
   "--serve",
@@ -368,33 +373,33 @@ const Pe = /* @__PURE__ */ new Set([
   "--approve-divergence",
   "--divergence-only"
 ]), je = d.filter((e) => !Pe.has(e));
-$e().catch((e) => {
+Ne().catch((e) => {
   console.error(e), process.exitCode = 1;
 });
-async function $e() {
+async function Ne() {
   if (d.includes("--serve")) {
     if (g.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 ae(g, P);
+    await ae(g, j);
   } else {
-    const e = P.at(-1);
+    const e = j.at(-1);
     if (!e)
       throw new Error("resolveConfig() returned no webServers to boot.");
-    await Ne(e, g);
+    await $e(e, g);
   }
 }
-async function Ne(e, t) {
-  const r = a(D, ".adapter-tester/run");
-  I(r, { recursive: !0 });
+async function $e(e, t) {
+  const r = a(P, ".adapter-tester/run");
+  M(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(
-    E(o.name, e)
+  const { url: s, process: n } = await D(
+    A(o.name, e)
   );
-  o.url = s, x(
+  o.url = s, E(
     a(r, "playwright.config.js"),
     `// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
 import { defineConfig, devices } from "@playwright/test";
@@ -417,7 +422,7 @@ export default defineConfig({
   // the time this config is used (see runAutomated() in cli.ts).
 });
 `
-  ), x(
+  ), E(
     a(r, "visual-regression.spec.js"),
     `// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
 import { test, expect } from "@playwright/test";
@@ -431,7 +436,7 @@ const { ownTargetName, suiteLabel, stories, missingFromSourceOfTruth, checkStory
 
 // Set from \`--story <story-id>\` — scopes this run to exactly one story and
 // skips the (suite-wide) parity check, which has nothing to do with it.
-const storyId = ${JSON.stringify(J ?? null)};
+const storyId = ${JSON.stringify(q ?? null)};
 const scopedStories = storyId
   ? stories.filter((story) => story.id === storyId)
   : stories;
@@ -466,7 +471,7 @@ test.describe(\`\${ownTargetName} — \${suiteLabel}\`, () => {
         a(r, "playwright.config.js"),
         ...je
       ],
-      { stdio: "inherit", cwd: D, shell: process.platform === "win32" }
+      { stdio: "inherit", cwd: P, shell: process.platform === "win32" }
     );
     process.exitCode = l.status ?? 1;
   } finally {