@recursica/adapter-tester 3.0.0 → 4.0.0

package/README.md

@@ -12,9 +12,9 @@ This package provides three primary utilities:
 2. **Interactive Dev Mode:** A side-by-side synchronized browser environment with built-in note taking for auditing components and feeding fixes directly to an AI agent.
 3. **An installable devDependency**, wired into `@recursica/mantine-adapter` — the source-of-truth adapter, run in `isSourceOfTruthAdapter` mode (own-drift check only, since it has nothing above it to diverge from). Any other adapter repo — including one that never checked out this monorepo — can install it the same way. See [Using this package in another adapter repo](#using-this-package-in-another-adapter-repo).
 
-**Default mode** (used by any adapter repo installing this package): checks this project's own Storybook — the one already defined by its `storybook` npm script — against its own committed golden images, and flags divergence from the source-of-truth adapter's (`@recursica/mantine-adapter`) own golden images. No monorepo checkout, no manual config, in most cases no config file at all.
+**Default mode** (used by any adapter repo installing this package): checks this project's own Storybook — the one already defined by its `storybook` npm script — against its own committed golden images. No monorepo checkout, no manual config, in most cases no config file at all. Divergence from the source-of-truth adapter's (`@recursica/mantine-adapter`) own golden images is a separate, opt-in check — see [`--divergence-only`](#automated-visual-tests).
 
-**Non-standard mode**: this monorepo also runs adapter-tester against itself, pointed at an adapter's and `@recursica/mantine-adapter`'s local sibling workspace packages — so the divergence check sees local, uncommitted `mantine-adapter` golden changes before they're published, not whatever was last published to npm. See `adapter-tester.config.json` in this package for that config; it's the same CLI, just pointed at `sourceOfTruth.type: "url"` instead of the default Mantine harness.
+`@recursica/adapter-tester` itself has no default mode and no `adapter-tester.config.json` of its own — it's purely a tool other adapters install and configure. `mantine-adapter` and `mui-adapter` are the ones that run it, each with their own config.
 
 ---
 
@@ -26,13 +26,15 @@ Installing `@recursica/adapter-tester` as a devDependency (see [below](#using-th
 {
   "scripts": {
     "adapter-tester": "adapter-tester --serve",
-    "adapter-tester:automated": "adapter-tester"
+    "adapter-tester:automated": "adapter-tester",
+    "adapter-tester:source-of-truth": "adapter-tester --divergence-only"
   }
 }
 ```
 
 - `npm run adapter-tester` — Interactive Dev Mode: boots both Storybooks (reusing them if already running) and opens the synced side-by-side comparison browser.
-- `npm run adapter-tester:automated` — the headless Playwright pixel-diff suite; see [Automated Visual Tests](#automated-visual-tests) below.
+- `npm run adapter-tester:automated` — the headless own-drift check against this project's own committed goldens; see [Automated Visual Tests](#automated-visual-tests) below. This is the one to run normally — fast, no network calls.
+- `npm run adapter-tester:source-of-truth` — the separate, opt-in divergence check against the source-of-truth adapter's published goldens. Not wired up for `@recursica/mantine-adapter` itself — it _is_ the source of truth, so it has nothing to diverge from.
 
 Both boot Storybooks themselves — nothing needs to be running beforehand.
 
@@ -76,10 +78,11 @@ The Dev Mode server fetches this file dynamically, so any changes you make to `r
 
 ## Automated Visual Tests
 
-To execute a full headless visual regression scan across all components:
+Two independent checks, gated by `--divergence-only` — the normal, everyday one and a separate opt-in one:
 
 ```bash
-npm run adapter-tester:automated   # runs the `adapter-tester` CLI
+npm run adapter-tester:automated          # own-drift check only — the normal one to run
+npm run adapter-tester:source-of-truth    # divergence check only — opt-in, against Mantine
 ```
 
 `adapter-tester` reads `adapter-tester.config.json` from the current directory (or falls back to defaults if the file doesn't exist), generates a throwaway Playwright config + spec under `.adapter-tester/run/` (git-ignore this directory), and runs it. There's no Playwright config or spec file to hand-author.
@@ -92,13 +95,21 @@ Any other args are forwarded to `playwright test`, so you can scope a run to spe
 npm run adapter-tester:automated -- --grep "Toast"
 ```
 
+Pin the source-of-truth adapter's version for the divergence check (instead of resolving `@recursica/mantine-adapter`'s `latest` on npm) with `--source-of-truth-version`:
+
+```bash
+npm run adapter-tester:source-of-truth -- --source-of-truth-version 0.53.0
+```
+
+Only meaningful with the default `sourceOfTruth.type: "mantine-harness"` mode — throws if combined with `sourceOfTruth.type: "url"` (that mode reads a sibling package's local checkout directly, there's no version to pin) or with `isSourceOfTruthAdapter: true` (nothing to pin a version for).
+
 ### What happens during execution?
 
 1. **Automatic Storybook Bootup**: `adapter-tester` boots only this project's own Storybook — the divergence check reads the source-of-truth adapter's stored golden files, never a live Storybook, so nothing else needs to boot.
 2. **Story Discovery**: The test suite fetches this project's own Storybook index (`/index.json`) to dynamically discover and parameterize tests for every component story, excluding `@recursica/storybook-template`'s own default token/theme demo stories (`Theme/*`, `Tokens/*`) and each adapter's own onboarding stories (`Introduction/*`).
-3. **Headless Snapshot**: It launches headless Chrome, navigates to the isolated iframe view, and takes a screenshot.
-4. **Own-Drift Check**: Diffs the screenshot against this project's own `test/golden/<story-id>.png` using `pixelmatch`, against the configured mismatch threshold. No golden yet for a story is not a failure — one is captured from this run.
-5. **Divergence Check**: Diffs this project's own golden against the source-of-truth adapter's golden (skipped for the source-of-truth adapter's own config). Different and not yet reviewed via `--approve-divergence`? Flagged as a report annotation — never a failure on its own.
+3. **Headless Snapshot**: It launches headless Chrome, navigates to the isolated iframe view, and takes a screenshot. A missing golden is captured from this screenshot regardless of which check is running.
+4. **Own-Drift Check** (`adapter-tester:automated`): Diffs the screenshot against this project's own `test/golden/<story-id>.png` using `pixelmatch`, against the configured mismatch threshold. No golden yet for a story is not a failure — one is captured from this run.
+5. **Divergence Check** (`adapter-tester:source-of-truth`): Diffs this project's own golden against the source-of-truth adapter's golden (skipped for the source-of-truth adapter's own config). Different and not yet reviewed via `--approve-divergence`? Flagged as a report annotation — never a failure on its own.
 6. **Native Report Generation**: Screenshots, diff overlays, and divergence flags are embedded directly as test attachments/annotations.
 
 ### Output & Reports
@@ -129,8 +140,9 @@ These are explicit, developer-run workflows — not run in CI, and not scoped do
 npm run adapter-tester:automated -- --grep "Toast" --update-golden
 
 # Review a flagged divergence from the source of truth, and accept it as
-# intentional. Also (re)captures the own golden from the current live render.
-npm run adapter-tester:automated -- --grep "Toast" --approve-divergence
+# intentional. Only valid alongside --divergence-only — there's nothing to
+# approve without the divergence check running.
+npm run adapter-tester:source-of-truth -- --grep "Toast" --approve-divergence
 ```
 
 `--approve-divergence` records the source-of-truth adapter's own `manifest.json` `createdAt` for that story at review time. If the source of truth's golden is recaptured later, the divergence flags again for re-review — approval isn't a permanent exemption.
@@ -151,24 +163,26 @@ Every `adapter-tester.config.json` is validated against [`src/adapter-tester.sch
 
 ```json
 {
-  "$schema": "./node_modules/@recursica/adapter-tester/src/adapter-tester.schema.json",
+  "$schema": "https://raw.githubusercontent.com/borderux/recursica/main/packages/adapter-tester/src/adapter-tester.schema.json",
   "name": "MyAdapter",
   "storybook": { "port": 6006, "command": "npm run storybook" },
   "sourceOfTruth": { "type": "mantine-harness" },
   "diffThresholdPixels": 3500,
-  "storyThresholds": { "ui-kit-slider": 15000 },
-  "excludeTitlePrefixes": ["Theme", "Tokens", "Introduction"],
-  "excludeStoryIds": ["ui-kit-slider--range-mode-with-icons-and-inputs"]
+  "stories": {
+    "ui-kit-slider": { "threshold": 15000 },
+    "ui-kit-slider--range-mode-with-icons-and-inputs": { "exclude": true }
+  },
+  "excludeTitlePrefixes": ["Theme", "Tokens", "Introduction"]
 }
 ```
 
 - `name` — label for this project's own target. Defaults to the unscoped `package.json` name.
 - `storybook.port` — defaults to whatever `-p`/`--port` is set on this project's own `storybook` script; falls back to Storybook's default of `6006`.
 - `storybook.command`/`storybook.cwd` — default to `npm run storybook` in the current directory.
-- `sourceOfTruth` — defaults to `{ "type": "mantine-harness" }`: a throwaway harness that installs the _published_ `@recursica/mantine-adapter` from npm, so you never need this monorepo checked out. This is the standard mode every external adapter repo uses.
-- `sourceOfTruth.type: "url"` — the **non-standard** mode: points at an already-addressable Storybook via `command`/`port`/`cwd` instead of the harness, and reads that sibling package's `test/golden/` directly from disk for the divergence check (including uncommitted local changes) instead of resolving a published npm version. Used inside this monorepo — see `adapter-tester.config.json` in this package.
+- `sourceOfTruth` — defaults to `{ "type": "mantine-harness" }`: a throwaway harness that installs the _published_ `@recursica/mantine-adapter` from npm, so you never need this monorepo checked out. This is the standard mode every external adapter repo uses. `sourceOfTruth.mantineAdapterVersion` pins the version installed/fetched (defaults to `latest`) — or override it per-run with `--source-of-truth-version` instead of hardcoding it in the config.
+- `sourceOfTruth.type: "url"` — the **non-standard** mode: points at an already-addressable Storybook via `command`/`port`/`cwd` instead of the harness, and reads that sibling package's `test/golden/` directly from disk for the divergence check (including uncommitted local changes) instead of resolving a published npm version. For comparing two locally checked-out sibling adapters instead of a published one.
 - `isSourceOfTruthAdapter` — set `true` only in the source-of-truth adapter's own config (`@recursica/mantine-adapter`). Skips `sourceOfTruth`/the divergence check entirely; runs the own-drift check standalone. Also disables Dev Mode (`--serve`) — there's nothing to sync against.
-- `diffThresholdPixels`/`storyThresholds`/`excludeTitlePrefixes`/`excludeStoryIds` — same meaning as before; see `src/adapter-tester.schema.json` for full docs.
+- `diffThresholdPixels`/`stories`/`excludeTitlePrefixes` — same meaning as before; see `src/adapter-tester.schema.json` for full docs.
 
 ---
 
@@ -181,11 +195,12 @@ npm install --save-dev @recursica/adapter-tester @playwright/test
 npx playwright install chromium
 ```
 
-If your repo already has a `storybook` npm script with a port set (`storybook dev -p 6006`), no config file is required. Add the two scripts from [npm scripts](#npm-scripts) above to your `package.json`, then:
+If your repo already has a `storybook` npm script with a port set (`storybook dev -p 6006`), no config file is required. Add the scripts from [npm scripts](#npm-scripts) above to your `package.json`, then:
 
 ```bash
-npm run adapter-tester              # Interactive Dev Mode
-npm run adapter-tester:automated    # headless Playwright suite
+npm run adapter-tester                    # Interactive Dev Mode
+npm run adapter-tester:automated          # own-drift check — run this normally
+npm run adapter-tester:source-of-truth    # divergence check — opt-in, against Mantine
 ```
 
 Any extra args after `adapter-tester:automated` are passed straight through to `playwright test`, so you can scope a run instead of executing the full suite:

package/dist/adapter-tester.schema.json.d.ts

@@ -8,7 +8,7 @@ declare const _default: {
   "properties": {
     "$schema": {
       "type": "string",
-      "description": "Optional pointer to this schema for editor autocomplete, e.g. \"./node_modules/@recursica/adapter-tester/src/adapter-tester.schema.json\"."
+      "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",
@@ -98,20 +98,29 @@ declare const _default: {
       "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": {
+    "stories": {
       "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."
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "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`)."
-    },
-    "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."
     }
   }
 }

package/dist/cli.cjs

@@ -1,35 +1,48 @@
 #!/usr/bin/env node
-"use strict";const x=require("node:child_process"),l=require("node:fs"),s=require("node:path"),D=require("node:url"),U=require("node:net"),q=require("express"),M=require("http-proxy-middleware"),G=require("./mantineSourceOfTruth-BUb5MZy0.cjs"),L=require("./index-C6uYPRmx.cjs");var w=typeof document<"u"?document.currentScript:null;const A=s.dirname(D.fileURLToPath(typeof document>"u"?require("url").pathToFileURL(__filename).href:w&&w.tagName.toUpperCase()==="SCRIPT"&&w.src||new URL("cli.cjs",document.baseURI).href));function k(t){return new Promise(o=>{const e=new U.Socket;e.setTimeout(200),e.once("connect",()=>{e.destroy(),o(!0)}),e.once("timeout",()=>{e.destroy(),o(!1)}),e.once("error",()=>{e.destroy(),o(!1)}),e.connect(t,"127.0.0.1")})}async function _(t,o=6e4){const e=Date.now();for(;Date.now()-e<o;){if(await k(t))return!0;await new Promise(r=>setTimeout(r,500))}return!1}function R(t){return Number(new URL(t).port)}function E(t,o){var r,n;console.log(`[Dev Launcher] Port ${o.port} is inactive. Launching Storybook for ${t}...`);const e=x.spawn(o.command,{cwd:o.cwd,stdio:"pipe",shell:!0});return(r=e.stdout)==null||r.on("data",a=>{for(const c of a.toString().split(`
-`))c.trim()&&console.log(`[${t} SB] ${c.trim()}`)}),(n=e.stderr)==null||n.on("data",a=>{for(const c of a.toString().split(`
-`))c.trim()&&console.error(`[${t} SB ERROR] ${c.trim()}`)}),e.on("error",a=>{console.error(`[${t} SB ERROR] Failed to start process:`,a)}),e}function J(t){const o=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";console.log(`[Dev Launcher] Auto-launching browser: ${t}`),x.spawn(o,[t],{shell:process.platform==="win32"}).on("error",e=>{console.error("[Dev Launcher] Failed to auto-launch browser:",e)})}function V(t,o,e={}){const[r,n]=t.targets,[a,c]=o;if(!(r!=null&&r.sourceOfTruth)||!n||n.sourceOfTruth||!a||!c)throw new Error("adapter-tester dev mode requires exactly two targets: [sourceOfTruth, target] — check adapter-tester.config.json.");const m=e.port??6010,h=R(r.url),i=R(n.url),u=q(),g=s.join(A,"../public"),S=s.join(A,"../report-header.txt");u.get("/",(d,p,y)=>{if(d.query.path){y();return}const P=l.readFileSync(s.join(g,"index.html"),"utf8").replace("<head>",`<head>
-  <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({ownName:n.name,sourceOfTruthName:r.name,sourceOfTruthPort:h})};<\/script>`);p.send(P)}),u.get("/report-header.txt",(d,p)=>{try{p.type("text/plain").send(l.readFileSync(S,"utf8"))}catch{p.status(500).send("Error loading report-header.txt")}}),u.use("/",M.createProxyMiddleware({target:`http://localhost:${i}`,changeOrigin:!0,ws:!0}));const f=[];let b=!1;const T=()=>{if(!b){b=!0,console.log(`
-[Dev Launcher] Shutting down Dev Mode server and spawned Storybooks...`);for(const d of f)d.kill("SIGINT");process.exit(0)}};process.on("SIGINT",T),process.on("SIGTERM",T),u.listen(m,async()=>{console.log(`
+"use strict";const x=require("node:child_process"),u=require("node:fs"),n=require("node:path"),A=require("node:url"),V=require("node:net"),G=require("express"),J=require("http-proxy-middleware"),B=require("./mantineSourceOfTruth-BUb5MZy0.cjs"),I=require("./index-C6uYPRmx.cjs");var S=typeof document<"u"?document.currentScript:null;const R=n.dirname(A.fileURLToPath(typeof document>"u"?require("url").pathToFileURL(__filename).href:S&&S.tagName.toUpperCase()==="SCRIPT"&&S.src||new URL("cli.cjs",document.baseURI).href));function P(t){return new Promise(r=>{const e=new V.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")})}async function _(t,r=6e4){const e=Date.now();for(;Date.now()-e<r;){if(await P(t))return!0;await new Promise(o=>setTimeout(o,500))}return!1}function $(t){return Number(new URL(t).port)}function L(t,r){var o,s;console.log(`[Dev Launcher] Port ${r.port} is inactive. Launching Storybook for ${t}...`);const e=x.spawn(r.command,{cwd:r.cwd,stdio:"pipe",shell:!0});return(o=e.stdout)==null||o.on("data",i=>{for(const d of i.toString().split(`
+`))d.trim()&&console.log(`[${t} SB] ${d.trim()}`)}),(s=e.stderr)==null||s.on("data",i=>{for(const d of i.toString().split(`
+`))d.trim()&&console.error(`[${t} SB ERROR] ${d.trim()}`)}),e.on("error",i=>{console.error(`[${t} SB ERROR] Failed to start process:`,i)}),e}function W(t){const r=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";console.log(`[Dev Launcher] Auto-launching browser: ${t}`),x.spawn(r,[t],{shell:process.platform==="win32"}).on("error",e=>{console.error("[Dev Launcher] Failed to auto-launch browser:",e)})}function H(t,r,e={}){const[o,s]=t.targets,[i,d]=r;if(!(o!=null&&o.sourceOfTruth)||!s||s.sourceOfTruth||!i||!d)throw new Error("adapter-tester dev mode requires exactly two targets: [sourceOfTruth, target] — check adapter-tester.config.json.");const w=e.port??6010,m=$(o.url),g=$(s.url),a=G(),T=n.join(R,"../public"),v=n.join(R,"../report-header.txt");a.get("/",(p,l,c)=>{if(p.query.path){c();return}const E=u.readFileSync(n.join(T,"index.html"),"utf8").replace("<head>",`<head>
+  <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({ownName:s.name,sourceOfTruthName:o.name,sourceOfTruthPort:m})};<\/script>`);l.send(E)}),a.get("/report-header.txt",(p,l)=>{try{l.type("text/plain").send(u.readFileSync(v,"utf8"))}catch{l.status(500).send("Error loading report-header.txt")}}),a.use("/",J.createProxyMiddleware({target:`http://localhost:${g}`,changeOrigin:!0,ws:!0}));const y=[];let b=!1;const k=()=>{if(!b){b=!0,console.log(`
+[Dev Launcher] Shutting down Dev Mode server and spawned Storybooks...`);for(const p of y)p.kill("SIGINT");process.exit(0)}};process.on("SIGINT",k),process.on("SIGTERM",k),a.listen(w,async()=>{console.log(`
 ====================================================
 🚀 Adapter Dev Mode proxy running at:
-   http://localhost:${m}
+   http://localhost:${w}
 ====================================================
-`);const[d,p]=await Promise.all([k(h),k(i)]);d?console.log(`[Dev Launcher] ${r.name} is already running on port ${h}.`):f.push(E(r.name,a)),p?console.log(`[Dev Launcher] ${n.name} is already running on port ${i}.`):f.push(E(n.name,c));const y=[];d||y.push(_(h)),p||y.push(_(i)),y.length>0?(console.log("[Dev Launcher] Waiting for Storybooks to be responsive..."),(await Promise.all(y)).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."),J(`http://localhost:${m}`)})}const B="http://json-schema.org/draft-07/schema#",W="https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json",H="adapter-tester.config.json",K="Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.",Y="object",X=!1,z={$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."}},Q={$schema:B,$id:W,title:H,description:K,type:Y,additionalProperties:X,properties:z},Z=L.index,F=new L.ajvExports.Ajv({allErrors:!0,strict:!0});Z(F);const $=F.compile(Q);function ee(t,o){if($(t))return;const e=($.errors??[]).map(r=>{var a;const n=(a=r.params)!=null&&a.additionalProperty?` '${r.params.additionalProperty}'`:"";return`  - ${r.instancePath||"root"} ${r.message}${n}`}).join(`
-`);throw new Error(`Invalid ${o}:
-${e}`)}const te="@recursica/mantine-adapter",oe="adapter-tester.config.json",C="npm run storybook",re=6006,ne=6011,N="Mantine",se=3500;function I(t){const o=s.join(t,"package.json");if(!l.existsSync(o))throw new Error(`No package.json found in ${t} — run adapter-tester from the root of the project being tested.`);return JSON.parse(l.readFileSync(o,"utf8"))}function ie(t){var n;const e=(n=I(t).scripts)==null?void 0:n.storybook,r=e==null?void 0:e.match(/(?:-p|--port)[ =](\d+)/);return r?Number(r[1]):re}function ae(t){const e=I(t).name;return e?e.split("/").pop():"Adapter"}function ce(t){const o=s.join(t,oe);if(!l.existsSync(o))return{};const e=JSON.parse(l.readFileSync(o,"utf8"));return ee(e,o),e}function de(t){var b,T,d;const o=ce(t),e=o.isSourceOfTruthAdapter??!1,r=o.name??ae(t),n=((b=o.storybook)==null?void 0:b.port)??ie(t),a=((T=o.storybook)==null?void 0:T.command)??C,c=s.resolve(t,((d=o.storybook)==null?void 0:d.cwd)??"."),m={command:a,port:n,cwd:c,reuseExistingServer:!process.env.CI,timeout:120*1e3},h={diffThresholdPixels:o.diffThresholdPixels??se,storyThresholds:o.storyThresholds,excludeTitlePrefixes:o.excludeTitlePrefixes,excludeStoryIds:o.excludeStoryIds,goldenDir:s.join(c,"test","golden"),isSourceOfTruthAdapter:e,goldenMode:"check"};if(e)return{engineConfig:{...h,targets:[{name:r,url:`http://localhost:${n}`}]},webServers:[m]};const i=o.sourceOfTruth??{type:"mantine-harness"};let u,g,S,f;if(i.type==="url"){u=i.name??N,g=i.port;const p=s.resolve(t,i.cwd??".");S={command:i.command??C,port:i.port,cwd:p,reuseExistingServer:!process.env.CI,timeout:120*1e3},f={type:"local",dir:s.join(p,"test","golden")}}else u=N,g=i.port??ne,S=G.mantineSourceOfTruthWebServer({dir:s.join(t,".adapter-tester/mantine-harness"),port:g,mantineAdapterVersion:i.mantineAdapterVersion,storybookTemplateVersion:i.storybookTemplateVersion}),f={type:"npm",packageName:te,versionSpec:i.mantineAdapterVersion??"latest",cacheDir:s.join(t,".adapter-tester/mantine-golden-cache")};return{engineConfig:{...h,targets:[{name:u,url:`http://localhost:${g}`,sourceOfTruth:!0},{name:r,url:`http://localhost:${n}`}],sourceOfTruthGolden:f},webServers:[S,m]}}const pe=s.dirname(D.fileURLToPath(typeof document>"u"?require("url").pathToFileURL(__filename).href:w&&w.tagName.toUpperCase()==="SCRIPT"&&w.src||new URL("cli.cjs",document.baseURI).href)),le=D.pathToFileURL(s.join(pe,"testing.js")).href,O=process.cwd(),{engineConfig:v,webServers:j}=de(O);process.argv.includes("--update-golden")?v.goldenMode="update-golden":process.argv.includes("--approve-divergence")&&(v.goldenMode="approve-divergence");process.argv.includes("--dry-run")&&(console.log(JSON.stringify({engineConfig:v,webServers:j},null,2)),process.exit(0));const ue=new Set(["--dry-run","--serve","--update-golden","--approve-divergence"]),he=process.argv.slice(2).filter(t=>!ue.has(t));if(process.argv.includes("--serve")){if(v.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.");V(v,j)}else fe(j.slice(-1),v);function fe(t,o){const e=s.join(O,".adapter-tester/run");l.mkdirSync(e,{recursive:!0}),l.writeFileSync(s.join(e,"playwright.config.js"),`// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
+`);const[p,l]=await Promise.all([P(m),P(g)]);p?console.log(`[Dev Launcher] ${o.name} is already running on port ${m}.`):y.push(L(o.name,i)),l?console.log(`[Dev Launcher] ${s.name} is already running on port ${g}.`):y.push(L(s.name,d));const c=[];p||c.push(_(m)),l||c.push(_(g)),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."),W(`http://localhost:${w}`)})}const K="http://json-schema.org/draft-07/schema#",Y="https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json",X="adapter-tester.config.json",z="Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.",Q="object",Z=!1,ee={$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`)."}},te={$schema:K,$id:Y,title:X,description:z,type:Q,additionalProperties:Z,properties:ee},re=I.index,M=new I.ajvExports.Ajv({allErrors:!0,strict:!0});re(M);const N=M.compile(te);function oe(t,r){if(N(t))return;const e=(N.errors??[]).map(o=>{var i;const s=(i=o.params)!=null&&i.additionalProperty?` '${o.params.additionalProperty}'`:"";return`  - ${o.instancePath||"root"} ${o.message}${s}`}).join(`
+`);throw new Error(`Invalid ${r}:
+${e}`)}const ne="@recursica/mantine-adapter",se="adapter-tester.config.json",C="npm run storybook",ie=6006,ae=6011,F="Mantine",ce=3500;function U(t){const r=n.join(t,"package.json");if(!u.existsSync(r))throw new Error(`No package.json found in ${t} — run adapter-tester from the root of the project being tested.`);return JSON.parse(u.readFileSync(r,"utf8"))}function de(t){var s;const e=(s=U(t).scripts)==null?void 0:s.storybook,o=e==null?void 0:e.match(/(?:-p|--port)[ =](\d+)/);return o?Number(o[1]):ie}function pe(t){const e=U(t).name;return e?e.split("/").pop():"Adapter"}function le(t){const r=n.join(t,se);if(!u.existsSync(r))return{};const e=JSON.parse(u.readFileSync(r,"utf8"));return oe(e,r),e}function ue(t,r={}){var k,p,l;const e=le(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??pe(t),i=((k=e.storybook)==null?void 0:k.port)??de(t),d=((p=e.storybook)==null?void 0:p.command)??C,w=n.resolve(t,((l=e.storybook)==null?void 0:l.cwd)??"."),m={command:d,port:i,cwd:w,reuseExistingServer:!process.env.CI,timeout:120*1e3},g={diffThresholdPixels:e.diffThresholdPixels??ce,stories:e.stories,excludeTitlePrefixes:e.excludeTitlePrefixes,goldenDir:n.join(w,"test","golden"),isSourceOfTruthAdapter:o,goldenMode:"check",checkMode:"own"};if(o)return{engineConfig:{...g,targets:[{name:s,url:`http://localhost:${i}`}]},webServers:[m]};const a=e.sourceOfTruth??{type:"mantine-harness"};let T,v,y,b;if(a.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.`);T=a.name??F,v=a.port;const c=n.resolve(t,a.cwd??".");y={command:a.command??C,port:a.port,cwd:c,reuseExistingServer:!process.env.CI,timeout:120*1e3},b={type:"local",dir:n.join(c,"test","golden")}}else{T=F,v=a.port??ae;const c=r.mantineAdapterVersion??a.mantineAdapterVersion;y=B.mantineSourceOfTruthWebServer({dir:n.join(t,".adapter-tester/mantine-harness"),port:v,mantineAdapterVersion:c,storybookTemplateVersion:a.storybookTemplateVersion}),b={type:"npm",packageName:ne,versionSpec:c??"latest",cacheDir:n.join(t,".adapter-tester/mantine-golden-cache")}}return{engineConfig:{...g,targets:[{name:T,url:`http://localhost:${v}`,sourceOfTruth:!0},{name:s,url:`http://localhost:${i}`}],sourceOfTruthGolden:b},webServers:[y,m]}}const he=n.dirname(A.fileURLToPath(typeof document>"u"?require("url").pathToFileURL(__filename).href:S&&S.tagName.toUpperCase()==="SCRIPT"&&S.src||new URL("cli.cjs",document.baseURI).href)),fe=A.pathToFileURL(n.join(he,"testing.js")).href,f=process.argv.slice(2);let q;const O=f.indexOf("--source-of-truth-version");if(O!==-1){const t=f[O+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");q=t,f.splice(O,2)}const j=process.cwd(),{engineConfig:h,webServers:D}=ue(j,{mantineAdapterVersion:q});f.includes("--update-golden")?h.goldenMode="update-golden":f.includes("--approve-divergence")&&(h.goldenMode="approve-divergence");if(f.includes("--divergence-only")){if(h.isSourceOfTruthAdapter)throw new Error("--divergence-only has nothing to diverge from — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json.");h.checkMode="divergence"}else if(h.goldenMode==="approve-divergence")throw new Error("--approve-divergence only makes sense with --divergence-only — there's nothing to approve without the divergence check running.");f.includes("--dry-run")&&(console.log(JSON.stringify({engineConfig:h,webServers:D},null,2)),process.exit(0));const me=new Set(["--dry-run","--serve","--update-golden","--approve-divergence","--divergence-only"]),ge=f.filter(t=>!me.has(t));if(f.includes("--serve")){if(h.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.");H(h,D)}else ye(D.slice(-1),h);function ye(t,r){const e=n.join(j,".adapter-tester/run");u.mkdirSync(e,{recursive:!0}),u.writeFileSync(n.join(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)},
 });
-`),l.writeFileSync(s.join(e,"visual-regression.spec.js"),`// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
-import { runVisualRegression } from ${JSON.stringify(le)};
+`),u.writeFileSync(n.join(e,"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(fe)};
 
-await runVisualRegression(${JSON.stringify(o,null,2)});
-`);const r=x.spawnSync("npx",["playwright","test","--config",s.join(e,"playwright.config.js"),...he],{stdio:"inherit",cwd:O,shell:process.platform==="win32"});process.exit(r.status??1)}
+// \`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)});
+
+test.describe(\`\${ownTargetName} — \${suiteLabel}\`, () => {
+  for (const story of stories) {
+    test(story.id, async ({ browser }, testInfo) => {
+      await checkStory(story, browser, testInfo);
+    });
+  }
+});
+`);const o=x.spawnSync("npx",["playwright","test","--config",n.join(e,"playwright.config.js"),...ge],{stdio:"inherit",cwd:j,shell:process.platform==="win32"});process.exit(o.status??1)}
 //# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.cjs","sources":["../src/devServer.ts","../src/validateFileConfig.ts","../src/fileConfig.ts","../src/cli.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport net from \"node:net\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport express from \"express\";\nimport { createProxyMiddleware } from \"http-proxy-middleware\";\nimport type { AdapterTesterConfig } from \"./config.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\n\n/**\n * Interactive Dev Mode: a synced, side-by-side browser view of this\n * project's own Storybook and the source of truth, with per-story note\n * taking and an AI-report export. Boots both Storybooks (reusing them if\n * already running) behind a proxy so the own/target pane — which drives\n * the sync and carries Storybook's nav sidebar — loads same-origin on the\n * left, with the source of truth following along as a bare preview on the\n * right.\n *\n * Config-driven — takes the same `{ engineConfig, webServers }` shape\n * `resolveConfig()` produces, in the same [sourceOfTruth, target] order.\n */\n\nconst distDir = dirname(fileURLToPath(import.meta.url));\n\nfunction isPortActive(port: number): Promise<boolean> {\n  return new Promise((resolve) => {\n    const socket = new net.Socket();\n    socket.setTimeout(200);\n    socket.once(\"connect\", () => {\n      socket.destroy();\n      resolve(true);\n    });\n    socket.once(\"timeout\", () => {\n      socket.destroy();\n      resolve(false);\n    });\n    socket.once(\"error\", () => {\n      socket.destroy();\n      resolve(false);\n    });\n    socket.connect(port, \"127.0.0.1\");\n  });\n}\n\nasync function waitForPort(port: number, timeoutMs = 60000): Promise<boolean> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    if (await isPortActive(port)) return true;\n    await new Promise((resolve) => setTimeout(resolve, 500));\n  }\n  return false;\n}\n\nfunction portOf(url: string): number {\n  return Number(new URL(url).port);\n}\n\nfunction launchStorybook(\n  name: string,\n  server: HarnessWebServerConfig,\n): ChildProcess {\n  console.log(\n    `[Dev Launcher] Port ${server.port} is inactive. Launching Storybook for ${name}...`,\n  );\n  const child = spawn(server.command, {\n    cwd: server.cwd,\n    stdio: \"pipe\",\n    shell: true,\n  });\n\n  child.stdout?.on(\"data\", (data: Buffer) => {\n    for (const line of data.toString().split(\"\\n\")) {\n      if (line.trim()) console.log(`[${name} SB] ${line.trim()}`);\n    }\n  });\n  child.stderr?.on(\"data\", (data: Buffer) => {\n    for (const line of data.toString().split(\"\\n\")) {\n      if (line.trim()) console.error(`[${name} SB ERROR] ${line.trim()}`);\n    }\n  });\n  child.on(\"error\", (err) => {\n    console.error(`[${name} SB ERROR] Failed to start process:`, err);\n  });\n\n  return child;\n}\n\nfunction openBrowser(url: string): void {\n  const startCmd =\n    process.platform === \"darwin\"\n      ? \"open\"\n      : process.platform === \"win32\"\n        ? \"start\"\n        : \"xdg-open\";\n  console.log(`[Dev Launcher] Auto-launching browser: ${url}`);\n  spawn(startCmd, [url], { shell: process.platform === \"win32\" }).on(\n    \"error\",\n    (err) => {\n      console.error(`[Dev Launcher] Failed to auto-launch browser:`, err);\n    },\n  );\n}\n\nexport interface DevServerOptions {\n  /** Port the dev-mode proxy UI itself listens on. Defaults to 6010. */\n  port?: number;\n}\n\nexport function startDevServer(\n  engineConfig: AdapterTesterConfig,\n  webServers: HarnessWebServerConfig[],\n  options: DevServerOptions = {},\n): void {\n  const [sourceOfTruth, target] = engineConfig.targets;\n  const [sourceOfTruthServer, targetServer] = webServers;\n  if (\n    !sourceOfTruth?.sourceOfTruth ||\n    !target ||\n    target.sourceOfTruth ||\n    !sourceOfTruthServer ||\n    !targetServer\n  ) {\n    throw new Error(\n      \"adapter-tester dev mode requires exactly two targets: [sourceOfTruth, target] — check adapter-tester.config.json.\",\n    );\n  }\n\n  const devPort = options.port ?? 6010;\n  const sourceOfTruthPort = portOf(sourceOfTruth.url);\n  const targetPort = portOf(target.url);\n\n  const app = express();\n  const publicDir = join(distDir, \"../public\");\n  const headerPath = join(distDir, \"../report-header.txt\");\n\n  // Serve the Dev Mode UI at the root path ONLY if there is no query string.\n  // This allows the iframe (which loads with ?path=/story/...) to pass\n  // through to the proxy, avoiding an infinite loop of nested wrappers.\n  app.get(\"/\", (req, res, next) => {\n    if (req.query.path) {\n      next();\n      return;\n    }\n    const html = readFileSync(join(publicDir, \"index.html\"), \"utf8\").replace(\n      \"<head>\",\n      `<head>\\n  <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({\n        ownName: target.name,\n        sourceOfTruthName: sourceOfTruth.name,\n        sourceOfTruthPort,\n      })};</script>`,\n    );\n    res.send(html);\n  });\n\n  // Serve the AI prompt header dynamically so it can be edited externally.\n  app.get(\"/report-header.txt\", (req, res) => {\n    try {\n      res.type(\"text/plain\").send(readFileSync(headerPath, \"utf8\"));\n    } catch {\n      res.status(500).send(\"Error loading report-header.txt\");\n    }\n  });\n\n  // Proxy everything else to this project's own Storybook, preserving\n  // absolute paths (e.g. /@vite/client) so HMR keeps working same-origin.\n  // This is the pane that drives the sync and shows Storybook's nav sidebar.\n  app.use(\n    \"/\",\n    createProxyMiddleware({\n      target: `http://localhost:${targetPort}`,\n      changeOrigin: true,\n      ws: true,\n    }),\n  );\n\n  const spawned: ChildProcess[] = [];\n  let cleaningUp = false;\n  const cleanup = () => {\n    if (cleaningUp) return;\n    cleaningUp = true;\n    console.log(\n      \"\\n[Dev Launcher] Shutting down Dev Mode server and spawned Storybooks...\",\n    );\n    for (const child of spawned) child.kill(\"SIGINT\");\n    process.exit(0);\n  };\n  process.on(\"SIGINT\", cleanup);\n  process.on(\"SIGTERM\", cleanup);\n\n  app.listen(devPort, async () => {\n    console.log(`\n====================================================\n🚀 Adapter Dev Mode proxy running at:\n   http://localhost:${devPort}\n====================================================\n`);\n\n    const [sourceOfTruthRunning, targetRunning] = await Promise.all([\n      isPortActive(sourceOfTruthPort),\n      isPortActive(targetPort),\n    ]);\n\n    if (sourceOfTruthRunning) {\n      console.log(\n        `[Dev Launcher] ${sourceOfTruth.name} is already running on port ${sourceOfTruthPort}.`,\n      );\n    } else {\n      spawned.push(launchStorybook(sourceOfTruth.name, sourceOfTruthServer));\n    }\n    if (targetRunning) {\n      console.log(\n        `[Dev Launcher] ${target.name} is already running on port ${targetPort}.`,\n      );\n    } else {\n      spawned.push(launchStorybook(target.name, targetServer));\n    }\n\n    const waits: Promise<boolean>[] = [];\n    if (!sourceOfTruthRunning) waits.push(waitForPort(sourceOfTruthPort));\n    if (!targetRunning) waits.push(waitForPort(targetPort));\n\n    if (waits.length > 0) {\n      console.log(`[Dev Launcher] Waiting for Storybooks to be responsive...`);\n      const results = await Promise.all(waits);\n      if (results.every(Boolean)) {\n        console.log(`[Dev Launcher] All Storybooks are active and responsive!`);\n      } else {\n        console.warn(\n          `[Dev Launcher] Warning: some Storybooks timed out during startup, but proceeding...`,\n        );\n      }\n    } else {\n      console.log(`[Dev Launcher] Both Storybooks already active.`);\n    }\n\n    openBrowser(`http://localhost:${devPort}`);\n  });\n}\n","import { Ajv } from \"ajv\";\nimport * as ajvFormatsModule from \"ajv-formats\";\nimport type { FormatsPlugin } from \"ajv-formats\";\nimport schema from \"./adapter-tester.schema.json\" with { type: \"json\" };\n\n// ajv-formats ships an ESM-style `export default` on a CJS build with no\n// `\"type\"` field, which under `moduleResolution: NodeNext` TS resolves to\n// the raw module namespace instead of unwrapping the default — a known\n// ajv-formats/TS interop gap, not a version mismatch.\nconst addFormats = (ajvFormatsModule as unknown as { default: FormatsPlugin })\n  .default;\n\nconst ajv = new Ajv({ allErrors: true, strict: true });\naddFormats(ajv);\nconst validate = ajv.compile(schema);\n\n/**\n * Validates a parsed `adapter-tester.config.json` against\n * `adapter-tester.schema.json`. Throws with every violation listed — callers\n * must not silently coerce or drop invalid fields.\n */\nexport function validateFileConfig(data: unknown, path: string): void {\n  if (validate(data)) return;\n\n  const errors = (validate.errors ?? [])\n    .map((error) => {\n      const extra = error.params?.additionalProperty\n        ? ` '${error.params.additionalProperty}'`\n        : \"\";\n      return `  - ${error.instancePath || \"root\"} ${error.message}${extra}`;\n    })\n    .join(\"\\n\");\n  throw new Error(`Invalid ${path}:\\n${errors}`);\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type {\n  AdapterTesterConfig,\n  SourceOfTruthGoldenLocation,\n} from \"./config.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\nimport { mantineSourceOfTruthWebServer } from \"./harness/mantineSourceOfTruth.js\";\nimport { validateFileConfig } from \"./validateFileConfig.js\";\n\nconst MANTINE_ADAPTER_PACKAGE_NAME = \"@recursica/mantine-adapter\";\n\nexport const CONFIG_FILE_NAME = \"adapter-tester.config.json\";\nconst DEFAULT_STORYBOOK_COMMAND = \"npm run storybook\";\nconst DEFAULT_STORYBOOK_PORT = 6006;\nconst DEFAULT_SOURCE_OF_TRUTH_PORT = 6011;\nconst DEFAULT_SOURCE_OF_TRUTH_NAME = \"Mantine\";\nconst DEFAULT_DIFF_THRESHOLD_PIXELS = 3500;\n\ninterface StorybookTargetFileConfig {\n  /** Port the target's Storybook is served on. Auto-detected from this\n   * project's own `scripts.storybook` (a `-p <port>`/`--port <port>` flag)\n   * when omitted, falling back to Storybook's own default of 6006. */\n  port?: number;\n  /** Command that boots the target's Storybook. Defaults to `npm run storybook`. */\n  command?: string;\n  /** Directory the command runs in, relative to the config file. Defaults to \".\" */\n  cwd?: string;\n}\n\ninterface MantineHarnessSourceOfTruthFileConfig {\n  /** Default mode: boots a throwaway harness that installs the published\n   * `@recursica/mantine-adapter` from npm — no monorepo checkout required. */\n  type?: \"mantine-harness\";\n  port?: number;\n  mantineAdapterVersion?: string;\n  storybookTemplateVersion?: string;\n}\n\ninterface UrlSourceOfTruthFileConfig {\n  /** Non-standard mode: points at an already-addressable Storybook — e.g. a\n   * sibling workspace package's own Storybook inside this monorepo. */\n  type: \"url\";\n  name?: string;\n  port: number;\n  command?: string;\n  cwd?: string;\n}\n\ntype SourceOfTruthFileConfig =\n  | MantineHarnessSourceOfTruthFileConfig\n  | UrlSourceOfTruthFileConfig;\n\nexport interface AdapterTesterFileConfig {\n  /** Label for this project's own target. Defaults to the unscoped name in\n   * this project's package.json (e.g. \"@recursica/mui-adapter\" -> \"mui-adapter\"). */\n  name?: string;\n  storybook?: StorybookTargetFileConfig;\n  sourceOfTruth?: SourceOfTruthFileConfig;\n  diffThresholdPixels?: number;\n  storyThresholds?: Record<string, number>;\n  excludeTitlePrefixes?: string[];\n  excludeStoryIds?: string[];\n  /**\n   * True only for the source-of-truth adapter's own config (mantine-adapter).\n   * Skips `sourceOfTruth` entirely — there's nothing above it to diverge\n   * from — and runs the own-drift golden check standalone, against just this\n   * project's own Storybook. Defaults to false.\n   */\n  isSourceOfTruthAdapter?: boolean;\n}\n\nexport interface ResolvedAdapterTesterConfig {\n  engineConfig: AdapterTesterConfig;\n  webServers: HarnessWebServerConfig[];\n}\n\nfunction readOwnPackageJson(cwd: string): any {\n  const path = join(cwd, \"package.json\");\n  if (!existsSync(path)) {\n    throw new Error(\n      `No package.json found in ${cwd} — run adapter-tester from the root of the project being tested.`,\n    );\n  }\n  return JSON.parse(readFileSync(path, \"utf8\"));\n}\n\nfunction detectOwnPort(cwd: string): number {\n  const pkg = readOwnPackageJson(cwd);\n  const storybookScript = pkg.scripts?.storybook as string | undefined;\n  const match = storybookScript?.match(/(?:-p|--port)[ =](\\d+)/);\n  return match ? Number(match[1]) : DEFAULT_STORYBOOK_PORT;\n}\n\nfunction detectOwnName(cwd: string): string {\n  const pkg = readOwnPackageJson(cwd);\n  const name = pkg.name as string | undefined;\n  return name ? name.split(\"/\").pop()! : \"Adapter\";\n}\n\nfunction loadFileConfig(cwd: string): AdapterTesterFileConfig {\n  const path = join(cwd, CONFIG_FILE_NAME);\n  if (!existsSync(path)) {\n    return {};\n  }\n  const data = JSON.parse(readFileSync(path, \"utf8\"));\n  validateFileConfig(data, path);\n  return data;\n}\n\n/**\n * Loads `adapter-tester.config.json` from `cwd` (or falls back to defaults\n * when the file doesn't exist) and resolves it into the engine config\n * `runVisualRegression` consumes plus the Playwright `webServer` entries\n * needed to boot both sides of the comparison.\n *\n * Default mode (no `sourceOfTruth`/`storybook` set): compares this project's\n * own Storybook against a throwaway Mantine harness — no monorepo checkout\n * required. Set `sourceOfTruth.type: \"url\"` for the non-standard mode used\n * to compare sibling workspace packages inside this monorepo.\n */\nexport function resolveConfig(cwd: string): ResolvedAdapterTesterConfig {\n  const file = loadFileConfig(cwd);\n  const isSourceOfTruthAdapter = file.isSourceOfTruthAdapter ?? false;\n\n  const ownName = file.name ?? detectOwnName(cwd);\n  const ownPort = file.storybook?.port ?? detectOwnPort(cwd);\n  const ownCommand = file.storybook?.command ?? DEFAULT_STORYBOOK_COMMAND;\n  const ownCwd = resolve(cwd, file.storybook?.cwd ?? \".\");\n  const ownWebServer: HarnessWebServerConfig = {\n    command: ownCommand,\n    port: ownPort,\n    cwd: ownCwd,\n    reuseExistingServer: !process.env.CI,\n    timeout: 120 * 1000,\n  };\n\n  const sharedEngineConfig = {\n    diffThresholdPixels:\n      file.diffThresholdPixels ?? DEFAULT_DIFF_THRESHOLD_PIXELS,\n    storyThresholds: file.storyThresholds,\n    excludeTitlePrefixes: file.excludeTitlePrefixes,\n    excludeStoryIds: file.excludeStoryIds,\n    // Keyed off `ownCwd`, not `cwd` — the project actually being tested, not\n    // wherever the config file happens to live. Matters for this monorepo's\n    // own non-standard config, whose `storybook.cwd` points at a sibling\n    // package: its goldens must resolve to that package's own `test/golden/`\n    // (the same directory used when that package runs adapter-tester\n    // directly), not a directory under `packages/adapter-tester/`.\n    goldenDir: join(ownCwd, \"test\", \"golden\"),\n    isSourceOfTruthAdapter,\n    // Overwritten by the CLI from --update-golden/--approve-divergence.\n    goldenMode: \"check\" as const,\n  };\n\n  // The source-of-truth adapter's own config has nothing above it to\n  // diverge from — no second target, no harness/webServer for it at all.\n  if (isSourceOfTruthAdapter) {\n    return {\n      engineConfig: {\n        ...sharedEngineConfig,\n        targets: [{ name: ownName, url: `http://localhost:${ownPort}` }],\n      },\n      webServers: [ownWebServer],\n    };\n  }\n\n  const sourceOfTruth = file.sourceOfTruth ?? {\n    type: \"mantine-harness\" as const,\n  };\n\n  let sourceOfTruthName: string;\n  let sourceOfTruthPort: number;\n  let sourceOfTruthWebServer: HarnessWebServerConfig;\n  let sourceOfTruthGolden: SourceOfTruthGoldenLocation;\n\n  if (sourceOfTruth.type === \"url\") {\n    sourceOfTruthName = sourceOfTruth.name ?? DEFAULT_SOURCE_OF_TRUTH_NAME;\n    sourceOfTruthPort = sourceOfTruth.port;\n    const sourceOfTruthCwd = resolve(cwd, sourceOfTruth.cwd ?? \".\");\n    sourceOfTruthWebServer = {\n      command: sourceOfTruth.command ?? DEFAULT_STORYBOOK_COMMAND,\n      port: sourceOfTruth.port,\n      cwd: sourceOfTruthCwd,\n      reuseExistingServer: !process.env.CI,\n      timeout: 120 * 1000,\n    };\n    // Sibling package already checked out locally — read its golden files\n    // directly, including any uncommitted local changes. No install, no\n    // network call.\n    sourceOfTruthGolden = {\n      type: \"local\",\n      dir: join(sourceOfTruthCwd, \"test\", \"golden\"),\n    };\n  } else {\n    sourceOfTruthName = DEFAULT_SOURCE_OF_TRUTH_NAME;\n    sourceOfTruthPort = sourceOfTruth.port ?? DEFAULT_SOURCE_OF_TRUTH_PORT;\n    sourceOfTruthWebServer = mantineSourceOfTruthWebServer({\n      dir: join(cwd, \".adapter-tester/mantine-harness\"),\n      port: sourceOfTruthPort,\n      mantineAdapterVersion: sourceOfTruth.mantineAdapterVersion,\n      storybookTemplateVersion: sourceOfTruth.storybookTemplateVersion,\n    });\n    // No local checkout — resolve the installed version against the npm\n    // registry and fetch that version's golden files from the public repo.\n    // Never needs `sourceOfTruthWebServer` above; the golden check on its\n    // own doesn't boot a second Storybook at all (see cli.ts).\n    sourceOfTruthGolden = {\n      type: \"npm\",\n      packageName: MANTINE_ADAPTER_PACKAGE_NAME,\n      versionSpec: sourceOfTruth.mantineAdapterVersion ?? \"latest\",\n      cacheDir: join(cwd, \".adapter-tester/mantine-golden-cache\"),\n    };\n  }\n\n  return {\n    engineConfig: {\n      ...sharedEngineConfig,\n      targets: [\n        {\n          name: sourceOfTruthName,\n          url: `http://localhost:${sourceOfTruthPort}`,\n          sourceOfTruth: true,\n        },\n        { name: ownName, url: `http://localhost:${ownPort}` },\n      ],\n      sourceOfTruthGolden,\n    },\n    // [sourceOfTruth, own] — Dev Mode needs both; the automated golden run\n    // (cli.ts) only ever boots the last entry, since its divergence check\n    // reads stored golden files, not a live source-of-truth page.\n    webServers: [sourceOfTruthWebServer, ownWebServer],\n  };\n}\n","import { spawnSync } from \"node:child_process\";\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport type { AdapterTesterConfig } from \"./config.js\";\nimport { startDevServer } from \"./devServer.js\";\nimport { resolveConfig } from \"./fileConfig.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\n\n// `dist/testing.js` is always a sibling of this file — both inside a\n// consumer's node_modules/@recursica/adapter-tester/dist and inside this\n// monorepo's own packages/adapter-tester/dist when self-hosting — so the\n// generated spec below can reach it without depending on how the package\n// itself resolves at import time.\nconst distDir = dirname(fileURLToPath(import.meta.url));\nconst testingEntry = pathToFileURL(join(distDir, \"testing.js\")).href;\n\nconst cwd = process.cwd();\nconst { engineConfig, webServers } = resolveConfig(cwd);\n\nif (process.argv.includes(\"--update-golden\")) {\n  engineConfig.goldenMode = \"update-golden\";\n} else if (process.argv.includes(\"--approve-divergence\")) {\n  engineConfig.goldenMode = \"approve-divergence\";\n}\n\nif (process.argv.includes(\"--dry-run\")) {\n  console.log(JSON.stringify({ engineConfig, webServers }, null, 2));\n  process.exit(0);\n}\n\n// Any arg besides our own flags is passed straight through to `playwright\n// test` — e.g. `npm run adapter-tester:automated -- --grep \"Toast\"` to scope\n// a run to matching stories, instead of every invocation running the full\n// suite. `--update-golden`/`--approve-divergence` are consumed above, not\n// forwarded — Playwright itself doesn't know about them.\nconst OWN_FLAGS = new Set([\n  \"--dry-run\",\n  \"--serve\",\n  \"--update-golden\",\n  \"--approve-divergence\",\n]);\nconst passthroughArgs = process.argv\n  .slice(2)\n  .filter((arg) => !OWN_FLAGS.has(arg));\n\nif (process.argv.includes(\"--serve\")) {\n  if (engineConfig.isSourceOfTruthAdapter) {\n    throw new Error(\n      \"Dev Mode (--serve) has nothing to sync this project's Storybook against — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json.\",\n    );\n  }\n  // Dual-Storybook interactive Dev Mode — no Playwright, no screenshots.\n  // Used by the `adapter-tester` npm script.\n  startDevServer(engineConfig, webServers);\n} else {\n  // The golden-image checks never need the source-of-truth adapter's own\n  // Storybook running — the divergence check reads its stored golden files,\n  // not a live page — so only the last (own) webServer is booted here. Dev\n  // Mode above is the one thing that still needs both.\n  runAutomated(webServers.slice(-1), engineConfig);\n}\n\n/**\n * Generates a throwaway Playwright config + spec under `.adapter-tester/run/`\n * and runs the automated pixel-diff suite. Used by the\n * `adapter-tester:automated` npm script.\n */\nfunction runAutomated(\n  servers: HarnessWebServerConfig[],\n  config: AdapterTesterConfig,\n): void {\n  const runDir = join(cwd, \".adapter-tester/run\");\n  mkdirSync(runDir, { recursive: true });\n\n  writeFileSync(\n    join(runDir, \"playwright.config.js\"),\n    `// Generated by \\`adapter-tester\\` — do not edit, regenerated on every run.\nimport { defineConfig, devices } from \"@playwright/test\";\n\nexport default defineConfig({\n  testDir: ${JSON.stringify(runDir)},\n  // Golden checks read-modify-write the same manifest.json across every\n  // story's test body — forced sequential (no worker parallelism) so those\n  // writes never race each other.\n  fullyParallel: false,\n  forbidOnly: !!process.env.CI,\n  retries: process.env.CI ? 2 : 0,\n  workers: 1,\n  reporter: [[\"html\", { open: \"never\" }], [\"list\"]],\n  use: { trace: \"on-first-retry\" },\n  projects: [{ name: \"chromium\", use: { ...devices[\"Desktop Chrome\"] } }],\n  webServer: ${JSON.stringify(servers, null, 2)},\n});\n`,\n  );\n\n  writeFileSync(\n    join(runDir, \"visual-regression.spec.js\"),\n    `// Generated by \\`adapter-tester\\` — do not edit, regenerated on every run.\nimport { runVisualRegression } from ${JSON.stringify(testingEntry)};\n\nawait runVisualRegression(${JSON.stringify(config, null, 2)});\n`,\n  );\n\n  const result = spawnSync(\n    \"npx\",\n    [\n      \"playwright\",\n      \"test\",\n      \"--config\",\n      join(runDir, \"playwright.config.js\"),\n      ...passthroughArgs,\n    ],\n    { stdio: \"inherit\", cwd, shell: process.platform === \"win32\" },\n  );\n\n  process.exit(result.status ?? 1);\n}\n"],"names":["distDir","dirname","fileURLToPath","_documentCurrentScript","isPortActive","port","resolve","socket","net","waitForPort","timeoutMs","start","portOf","url","launchStorybook","name","server","child","spawn","_a","data","line","_b","err","openBrowser","startCmd","startDevServer","engineConfig","webServers","options","sourceOfTruth","target","sourceOfTruthServer","targetServer","devPort","sourceOfTruthPort","targetPort","app","express","publicDir","join","headerPath","req","res","next","html","readFileSync","createProxyMiddleware","spawned","cleaningUp","cleanup","sourceOfTruthRunning","targetRunning","waits","addFormats","ajvFormatsModule.default","ajv","Ajv","validate","schema","validateFileConfig","path","errors","error","extra","MANTINE_ADAPTER_PACKAGE_NAME","CONFIG_FILE_NAME","DEFAULT_STORYBOOK_COMMAND","DEFAULT_STORYBOOK_PORT","DEFAULT_SOURCE_OF_TRUTH_PORT","DEFAULT_SOURCE_OF_TRUTH_NAME","DEFAULT_DIFF_THRESHOLD_PIXELS","readOwnPackageJson","cwd","existsSync","detectOwnPort","storybookScript","match","detectOwnName","loadFileConfig","resolveConfig","file","isSourceOfTruthAdapter","ownName","ownPort","ownCommand","ownCwd","_c","ownWebServer","sharedEngineConfig","sourceOfTruthName","sourceOfTruthWebServer","sourceOfTruthGolden","sourceOfTruthCwd","mantineSourceOfTruthWebServer","testingEntry","pathToFileURL","OWN_FLAGS","passthroughArgs","arg","runAutomated","servers","config","runDir","mkdirSync","writeFileSync","result","spawnSync"],"mappings":"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"}
+{"version":3,"file":"cli.cjs","sources":["../src/devServer.ts","../src/validateFileConfig.ts","../src/fileConfig.ts","../src/cli.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport net from \"node:net\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport express from \"express\";\nimport { createProxyMiddleware } from \"http-proxy-middleware\";\nimport type { AdapterTesterConfig } from \"./config.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\n\n/**\n * Interactive Dev Mode: a synced, side-by-side browser view of this\n * project's own Storybook and the source of truth, with per-story note\n * taking and an AI-report export. Boots both Storybooks (reusing them if\n * already running) behind a proxy so the own/target pane — which drives\n * the sync and carries Storybook's nav sidebar — loads same-origin on the\n * left, with the source of truth following along as a bare preview on the\n * right.\n *\n * Config-driven — takes the same `{ engineConfig, webServers }` shape\n * `resolveConfig()` produces, in the same [sourceOfTruth, target] order.\n */\n\nconst distDir = dirname(fileURLToPath(import.meta.url));\n\nfunction isPortActive(port: number): Promise<boolean> {\n  return new Promise((resolve) => {\n    const socket = new net.Socket();\n    socket.setTimeout(200);\n    socket.once(\"connect\", () => {\n      socket.destroy();\n      resolve(true);\n    });\n    socket.once(\"timeout\", () => {\n      socket.destroy();\n      resolve(false);\n    });\n    socket.once(\"error\", () => {\n      socket.destroy();\n      resolve(false);\n    });\n    socket.connect(port, \"127.0.0.1\");\n  });\n}\n\nasync function waitForPort(port: number, timeoutMs = 60000): Promise<boolean> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    if (await isPortActive(port)) return true;\n    await new Promise((resolve) => setTimeout(resolve, 500));\n  }\n  return false;\n}\n\nfunction portOf(url: string): number {\n  return Number(new URL(url).port);\n}\n\nfunction launchStorybook(\n  name: string,\n  server: HarnessWebServerConfig,\n): ChildProcess {\n  console.log(\n    `[Dev Launcher] Port ${server.port} is inactive. Launching Storybook for ${name}...`,\n  );\n  const child = spawn(server.command, {\n    cwd: server.cwd,\n    stdio: \"pipe\",\n    shell: true,\n  });\n\n  child.stdout?.on(\"data\", (data: Buffer) => {\n    for (const line of data.toString().split(\"\\n\")) {\n      if (line.trim()) console.log(`[${name} SB] ${line.trim()}`);\n    }\n  });\n  child.stderr?.on(\"data\", (data: Buffer) => {\n    for (const line of data.toString().split(\"\\n\")) {\n      if (line.trim()) console.error(`[${name} SB ERROR] ${line.trim()}`);\n    }\n  });\n  child.on(\"error\", (err) => {\n    console.error(`[${name} SB ERROR] Failed to start process:`, err);\n  });\n\n  return child;\n}\n\nfunction openBrowser(url: string): void {\n  const startCmd =\n    process.platform === \"darwin\"\n      ? \"open\"\n      : process.platform === \"win32\"\n        ? \"start\"\n        : \"xdg-open\";\n  console.log(`[Dev Launcher] Auto-launching browser: ${url}`);\n  spawn(startCmd, [url], { shell: process.platform === \"win32\" }).on(\n    \"error\",\n    (err) => {\n      console.error(`[Dev Launcher] Failed to auto-launch browser:`, err);\n    },\n  );\n}\n\nexport interface DevServerOptions {\n  /** Port the dev-mode proxy UI itself listens on. Defaults to 6010. */\n  port?: number;\n}\n\nexport function startDevServer(\n  engineConfig: AdapterTesterConfig,\n  webServers: HarnessWebServerConfig[],\n  options: DevServerOptions = {},\n): void {\n  const [sourceOfTruth, target] = engineConfig.targets;\n  const [sourceOfTruthServer, targetServer] = webServers;\n  if (\n    !sourceOfTruth?.sourceOfTruth ||\n    !target ||\n    target.sourceOfTruth ||\n    !sourceOfTruthServer ||\n    !targetServer\n  ) {\n    throw new Error(\n      \"adapter-tester dev mode requires exactly two targets: [sourceOfTruth, target] — check adapter-tester.config.json.\",\n    );\n  }\n\n  const devPort = options.port ?? 6010;\n  const sourceOfTruthPort = portOf(sourceOfTruth.url);\n  const targetPort = portOf(target.url);\n\n  const app = express();\n  const publicDir = join(distDir, \"../public\");\n  const headerPath = join(distDir, \"../report-header.txt\");\n\n  // Serve the Dev Mode UI at the root path ONLY if there is no query string.\n  // This allows the iframe (which loads with ?path=/story/...) to pass\n  // through to the proxy, avoiding an infinite loop of nested wrappers.\n  app.get(\"/\", (req, res, next) => {\n    if (req.query.path) {\n      next();\n      return;\n    }\n    const html = readFileSync(join(publicDir, \"index.html\"), \"utf8\").replace(\n      \"<head>\",\n      `<head>\\n  <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({\n        ownName: target.name,\n        sourceOfTruthName: sourceOfTruth.name,\n        sourceOfTruthPort,\n      })};</script>`,\n    );\n    res.send(html);\n  });\n\n  // Serve the AI prompt header dynamically so it can be edited externally.\n  app.get(\"/report-header.txt\", (req, res) => {\n    try {\n      res.type(\"text/plain\").send(readFileSync(headerPath, \"utf8\"));\n    } catch {\n      res.status(500).send(\"Error loading report-header.txt\");\n    }\n  });\n\n  // Proxy everything else to this project's own Storybook, preserving\n  // absolute paths (e.g. /@vite/client) so HMR keeps working same-origin.\n  // This is the pane that drives the sync and shows Storybook's nav sidebar.\n  app.use(\n    \"/\",\n    createProxyMiddleware({\n      target: `http://localhost:${targetPort}`,\n      changeOrigin: true,\n      ws: true,\n    }),\n  );\n\n  const spawned: ChildProcess[] = [];\n  let cleaningUp = false;\n  const cleanup = () => {\n    if (cleaningUp) return;\n    cleaningUp = true;\n    console.log(\n      \"\\n[Dev Launcher] Shutting down Dev Mode server and spawned Storybooks...\",\n    );\n    for (const child of spawned) child.kill(\"SIGINT\");\n    process.exit(0);\n  };\n  process.on(\"SIGINT\", cleanup);\n  process.on(\"SIGTERM\", cleanup);\n\n  app.listen(devPort, async () => {\n    console.log(`\n====================================================\n🚀 Adapter Dev Mode proxy running at:\n   http://localhost:${devPort}\n====================================================\n`);\n\n    const [sourceOfTruthRunning, targetRunning] = await Promise.all([\n      isPortActive(sourceOfTruthPort),\n      isPortActive(targetPort),\n    ]);\n\n    if (sourceOfTruthRunning) {\n      console.log(\n        `[Dev Launcher] ${sourceOfTruth.name} is already running on port ${sourceOfTruthPort}.`,\n      );\n    } else {\n      spawned.push(launchStorybook(sourceOfTruth.name, sourceOfTruthServer));\n    }\n    if (targetRunning) {\n      console.log(\n        `[Dev Launcher] ${target.name} is already running on port ${targetPort}.`,\n      );\n    } else {\n      spawned.push(launchStorybook(target.name, targetServer));\n    }\n\n    const waits: Promise<boolean>[] = [];\n    if (!sourceOfTruthRunning) waits.push(waitForPort(sourceOfTruthPort));\n    if (!targetRunning) waits.push(waitForPort(targetPort));\n\n    if (waits.length > 0) {\n      console.log(`[Dev Launcher] Waiting for Storybooks to be responsive...`);\n      const results = await Promise.all(waits);\n      if (results.every(Boolean)) {\n        console.log(`[Dev Launcher] All Storybooks are active and responsive!`);\n      } else {\n        console.warn(\n          `[Dev Launcher] Warning: some Storybooks timed out during startup, but proceeding...`,\n        );\n      }\n    } else {\n      console.log(`[Dev Launcher] Both Storybooks already active.`);\n    }\n\n    openBrowser(`http://localhost:${devPort}`);\n  });\n}\n","import { Ajv } from \"ajv\";\nimport * as ajvFormatsModule from \"ajv-formats\";\nimport type { FormatsPlugin } from \"ajv-formats\";\nimport schema from \"./adapter-tester.schema.json\" with { type: \"json\" };\n\n// ajv-formats ships an ESM-style `export default` on a CJS build with no\n// `\"type\"` field, which under `moduleResolution: NodeNext` TS resolves to\n// the raw module namespace instead of unwrapping the default — a known\n// ajv-formats/TS interop gap, not a version mismatch.\nconst addFormats = (ajvFormatsModule as unknown as { default: FormatsPlugin })\n  .default;\n\nconst ajv = new Ajv({ allErrors: true, strict: true });\naddFormats(ajv);\nconst validate = ajv.compile(schema);\n\n/**\n * Validates a parsed `adapter-tester.config.json` against\n * `adapter-tester.schema.json`. Throws with every violation listed — callers\n * must not silently coerce or drop invalid fields.\n */\nexport function validateFileConfig(data: unknown, path: string): void {\n  if (validate(data)) return;\n\n  const errors = (validate.errors ?? [])\n    .map((error) => {\n      const extra = error.params?.additionalProperty\n        ? ` '${error.params.additionalProperty}'`\n        : \"\";\n      return `  - ${error.instancePath || \"root\"} ${error.message}${extra}`;\n    })\n    .join(\"\\n\");\n  throw new Error(`Invalid ${path}:\\n${errors}`);\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type {\n  AdapterTesterConfig,\n  SourceOfTruthGoldenLocation,\n  StoryOverride,\n} from \"./config.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\nimport { mantineSourceOfTruthWebServer } from \"./harness/mantineSourceOfTruth.js\";\nimport { validateFileConfig } from \"./validateFileConfig.js\";\n\nconst MANTINE_ADAPTER_PACKAGE_NAME = \"@recursica/mantine-adapter\";\n\nexport const CONFIG_FILE_NAME = \"adapter-tester.config.json\";\nconst DEFAULT_STORYBOOK_COMMAND = \"npm run storybook\";\nconst DEFAULT_STORYBOOK_PORT = 6006;\nconst DEFAULT_SOURCE_OF_TRUTH_PORT = 6011;\nconst DEFAULT_SOURCE_OF_TRUTH_NAME = \"Mantine\";\nconst DEFAULT_DIFF_THRESHOLD_PIXELS = 3500;\n\ninterface StorybookTargetFileConfig {\n  /** Port the target's Storybook is served on. Auto-detected from this\n   * project's own `scripts.storybook` (a `-p <port>`/`--port <port>` flag)\n   * when omitted, falling back to Storybook's own default of 6006. */\n  port?: number;\n  /** Command that boots the target's Storybook. Defaults to `npm run storybook`. */\n  command?: string;\n  /** Directory the command runs in, relative to the config file. Defaults to \".\" */\n  cwd?: string;\n}\n\ninterface MantineHarnessSourceOfTruthFileConfig {\n  /** Default mode: boots a throwaway harness that installs the published\n   * `@recursica/mantine-adapter` from npm — no monorepo checkout required. */\n  type?: \"mantine-harness\";\n  port?: number;\n  mantineAdapterVersion?: string;\n  storybookTemplateVersion?: string;\n}\n\ninterface UrlSourceOfTruthFileConfig {\n  /** Non-standard mode: points at an already-addressable Storybook — e.g. a\n   * sibling workspace package's own Storybook inside this monorepo. */\n  type: \"url\";\n  name?: string;\n  port: number;\n  command?: string;\n  cwd?: string;\n}\n\ntype SourceOfTruthFileConfig =\n  | MantineHarnessSourceOfTruthFileConfig\n  | UrlSourceOfTruthFileConfig;\n\nexport interface AdapterTesterFileConfig {\n  /** Label for this project's own target. Defaults to the unscoped name in\n   * this project's package.json (e.g. \"@recursica/mui-adapter\" -> \"mui-adapter\"). */\n  name?: string;\n  storybook?: StorybookTargetFileConfig;\n  sourceOfTruth?: SourceOfTruthFileConfig;\n  diffThresholdPixels?: number;\n  stories?: Record<string, StoryOverride>;\n  excludeTitlePrefixes?: string[];\n  /**\n   * True only for the source-of-truth adapter's own config (mantine-adapter).\n   * Skips `sourceOfTruth` entirely — there's nothing above it to diverge\n   * from — and runs the own-drift golden check standalone, against just this\n   * project's own Storybook. Defaults to false.\n   */\n  isSourceOfTruthAdapter?: boolean;\n}\n\nexport interface ResolvedAdapterTesterConfig {\n  engineConfig: AdapterTesterConfig;\n  webServers: HarnessWebServerConfig[];\n}\n\nexport interface ResolveConfigOverrides {\n  /** From `--source-of-truth-version`. Overrides `sourceOfTruth.mantineAdapterVersion`. */\n  mantineAdapterVersion?: string;\n}\n\nfunction readOwnPackageJson(cwd: string): any {\n  const path = join(cwd, \"package.json\");\n  if (!existsSync(path)) {\n    throw new Error(\n      `No package.json found in ${cwd} — run adapter-tester from the root of the project being tested.`,\n    );\n  }\n  return JSON.parse(readFileSync(path, \"utf8\"));\n}\n\nfunction detectOwnPort(cwd: string): number {\n  const pkg = readOwnPackageJson(cwd);\n  const storybookScript = pkg.scripts?.storybook as string | undefined;\n  const match = storybookScript?.match(/(?:-p|--port)[ =](\\d+)/);\n  return match ? Number(match[1]) : DEFAULT_STORYBOOK_PORT;\n}\n\nfunction detectOwnName(cwd: string): string {\n  const pkg = readOwnPackageJson(cwd);\n  const name = pkg.name as string | undefined;\n  return name ? name.split(\"/\").pop()! : \"Adapter\";\n}\n\nfunction loadFileConfig(cwd: string): AdapterTesterFileConfig {\n  const path = join(cwd, CONFIG_FILE_NAME);\n  if (!existsSync(path)) {\n    return {};\n  }\n  const data = JSON.parse(readFileSync(path, \"utf8\"));\n  validateFileConfig(data, path);\n  return data;\n}\n\n/**\n * Loads `adapter-tester.config.json` from `cwd` (or falls back to defaults\n * when the file doesn't exist) and resolves it into the engine config\n * `resolveVisualRegressionPlan` consumes plus the Playwright `webServer` entries\n * needed to boot both sides of the comparison.\n *\n * Default mode (no `sourceOfTruth`/`storybook` set): compares this project's\n * own Storybook against a throwaway Mantine harness — no monorepo checkout\n * required. Set `sourceOfTruth.type: \"url\"` for the non-standard mode used\n * to compare sibling workspace packages inside this monorepo.\n *\n * `overrides.mantineAdapterVersion` (from `--source-of-truth-version`) pins\n * the mantine-harness install/golden-fetch version for this run, overriding\n * `sourceOfTruth.mantineAdapterVersion`. Throws if passed together with\n * `isSourceOfTruthAdapter` or `sourceOfTruth.type: \"url\"` — neither has a\n * version to pin.\n */\nexport function resolveConfig(\n  cwd: string,\n  overrides: ResolveConfigOverrides = {},\n): ResolvedAdapterTesterConfig {\n  const file = loadFileConfig(cwd);\n  const isSourceOfTruthAdapter = file.isSourceOfTruthAdapter ?? false;\n\n  if (overrides.mantineAdapterVersion && isSourceOfTruthAdapter) {\n    throw new Error(\n      \"--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.\",\n    );\n  }\n\n  const ownName = file.name ?? detectOwnName(cwd);\n  const ownPort = file.storybook?.port ?? detectOwnPort(cwd);\n  const ownCommand = file.storybook?.command ?? DEFAULT_STORYBOOK_COMMAND;\n  const ownCwd = resolve(cwd, file.storybook?.cwd ?? \".\");\n  const ownWebServer: HarnessWebServerConfig = {\n    command: ownCommand,\n    port: ownPort,\n    cwd: ownCwd,\n    reuseExistingServer: !process.env.CI,\n    timeout: 120 * 1000,\n  };\n\n  const sharedEngineConfig = {\n    diffThresholdPixels:\n      file.diffThresholdPixels ?? DEFAULT_DIFF_THRESHOLD_PIXELS,\n    stories: file.stories,\n    excludeTitlePrefixes: file.excludeTitlePrefixes,\n    // Keyed off `ownCwd`, not `cwd` — the project actually being tested, not\n    // wherever the config file happens to live. Matters whenever\n    // `storybook.cwd` points at a sibling package: its goldens must resolve\n    // to that package's own `test/golden/` (the same directory used when\n    // that package runs adapter-tester directly), not a directory under\n    // wherever this config file lives.\n    goldenDir: join(ownCwd, \"test\", \"golden\"),\n    isSourceOfTruthAdapter,\n    // Overwritten by the CLI from --update-golden/--approve-divergence.\n    goldenMode: \"check\" as const,\n    // Overwritten by the CLI from --divergence-only.\n    checkMode: \"own\" as const,\n  };\n\n  // The source-of-truth adapter's own config has nothing above it to\n  // diverge from — no second target, no harness/webServer for it at all.\n  if (isSourceOfTruthAdapter) {\n    return {\n      engineConfig: {\n        ...sharedEngineConfig,\n        targets: [{ name: ownName, url: `http://localhost:${ownPort}` }],\n      },\n      webServers: [ownWebServer],\n    };\n  }\n\n  const sourceOfTruth = file.sourceOfTruth ?? {\n    type: \"mantine-harness\" as const,\n  };\n\n  let sourceOfTruthName: string;\n  let sourceOfTruthPort: number;\n  let sourceOfTruthWebServer: HarnessWebServerConfig;\n  let sourceOfTruthGolden: SourceOfTruthGoldenLocation;\n\n  if (sourceOfTruth.type === \"url\") {\n    if (overrides.mantineAdapterVersion) {\n      throw new Error(\n        '--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.',\n      );\n    }\n    sourceOfTruthName = sourceOfTruth.name ?? DEFAULT_SOURCE_OF_TRUTH_NAME;\n    sourceOfTruthPort = sourceOfTruth.port;\n    const sourceOfTruthCwd = resolve(cwd, sourceOfTruth.cwd ?? \".\");\n    sourceOfTruthWebServer = {\n      command: sourceOfTruth.command ?? DEFAULT_STORYBOOK_COMMAND,\n      port: sourceOfTruth.port,\n      cwd: sourceOfTruthCwd,\n      reuseExistingServer: !process.env.CI,\n      timeout: 120 * 1000,\n    };\n    // Sibling package already checked out locally — read its golden files\n    // directly, including any uncommitted local changes. No install, no\n    // network call.\n    sourceOfTruthGolden = {\n      type: \"local\",\n      dir: join(sourceOfTruthCwd, \"test\", \"golden\"),\n    };\n  } else {\n    sourceOfTruthName = DEFAULT_SOURCE_OF_TRUTH_NAME;\n    sourceOfTruthPort = sourceOfTruth.port ?? DEFAULT_SOURCE_OF_TRUTH_PORT;\n    const mantineAdapterVersion =\n      overrides.mantineAdapterVersion ?? sourceOfTruth.mantineAdapterVersion;\n    sourceOfTruthWebServer = mantineSourceOfTruthWebServer({\n      dir: join(cwd, \".adapter-tester/mantine-harness\"),\n      port: sourceOfTruthPort,\n      mantineAdapterVersion,\n      storybookTemplateVersion: sourceOfTruth.storybookTemplateVersion,\n    });\n    // No local checkout — resolve the installed version against the npm\n    // registry and fetch that version's golden files from the public repo.\n    // Never needs `sourceOfTruthWebServer` above; the golden check on its\n    // own doesn't boot a second Storybook at all (see cli.ts).\n    sourceOfTruthGolden = {\n      type: \"npm\",\n      packageName: MANTINE_ADAPTER_PACKAGE_NAME,\n      versionSpec: mantineAdapterVersion ?? \"latest\",\n      cacheDir: join(cwd, \".adapter-tester/mantine-golden-cache\"),\n    };\n  }\n\n  return {\n    engineConfig: {\n      ...sharedEngineConfig,\n      targets: [\n        {\n          name: sourceOfTruthName,\n          url: `http://localhost:${sourceOfTruthPort}`,\n          sourceOfTruth: true,\n        },\n        { name: ownName, url: `http://localhost:${ownPort}` },\n      ],\n      sourceOfTruthGolden,\n    },\n    // [sourceOfTruth, own] — Dev Mode needs both; the automated golden run\n    // (cli.ts) only ever boots the last entry, since its divergence check\n    // reads stored golden files, not a live source-of-truth page.\n    webServers: [sourceOfTruthWebServer, ownWebServer],\n  };\n}\n","import { spawnSync } from \"node:child_process\";\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport type { AdapterTesterConfig } from \"./config.js\";\nimport { startDevServer } from \"./devServer.js\";\nimport { resolveConfig } from \"./fileConfig.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\n\n// `dist/testing.js` is always a sibling of this file — both inside a\n// consumer's node_modules/@recursica/adapter-tester/dist and inside this\n// monorepo's own packages/adapter-tester/dist when self-hosting — so the\n// generated spec below can reach it without depending on how the package\n// itself resolves at import time.\nconst distDir = dirname(fileURLToPath(import.meta.url));\nconst testingEntry = pathToFileURL(join(distDir, \"testing.js\")).href;\n\n// `--source-of-truth-version <value>` takes a value, unlike every other own\n// flag below — pulled out of argv first so the boolean flags/passthrough\n// logic never has to know it exists.\nconst args = process.argv.slice(2);\nlet sourceOfTruthVersion: string | undefined;\nconst sourceOfTruthVersionFlagIndex = args.indexOf(\"--source-of-truth-version\");\nif (sourceOfTruthVersionFlagIndex !== -1) {\n  const value = args[sourceOfTruthVersionFlagIndex + 1];\n  if (value === undefined || value.startsWith(\"--\")) {\n    throw new Error(\n      \"--source-of-truth-version requires a value, e.g. --source-of-truth-version 0.53.0\",\n    );\n  }\n  sourceOfTruthVersion = value;\n  args.splice(sourceOfTruthVersionFlagIndex, 2);\n}\n\nconst cwd = process.cwd();\nconst { engineConfig, webServers } = resolveConfig(cwd, {\n  mantineAdapterVersion: sourceOfTruthVersion,\n});\n\nif (args.includes(\"--update-golden\")) {\n  engineConfig.goldenMode = \"update-golden\";\n} else if (args.includes(\"--approve-divergence\")) {\n  engineConfig.goldenMode = \"approve-divergence\";\n}\n\nif (args.includes(\"--divergence-only\")) {\n  if (engineConfig.isSourceOfTruthAdapter) {\n    throw new Error(\n      \"--divergence-only has nothing to diverge from — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json.\",\n    );\n  }\n  engineConfig.checkMode = \"divergence\";\n} else if (engineConfig.goldenMode === \"approve-divergence\") {\n  throw new Error(\n    \"--approve-divergence only makes sense with --divergence-only — there's nothing to approve without the divergence check running.\",\n  );\n}\n\nif (args.includes(\"--dry-run\")) {\n  console.log(JSON.stringify({ engineConfig, webServers }, null, 2));\n  process.exit(0);\n}\n\n// Any arg besides our own flags is passed straight through to `playwright\n// test` — e.g. `npm run adapter-tester:automated -- --grep \"Toast\"` to scope\n// a run to matching stories, instead of every invocation running the full\n// suite. Our own flags are consumed above, not forwarded — Playwright itself\n// doesn't know about them.\nconst OWN_FLAGS = new Set([\n  \"--dry-run\",\n  \"--serve\",\n  \"--update-golden\",\n  \"--approve-divergence\",\n  \"--divergence-only\",\n]);\nconst passthroughArgs = args.filter((arg) => !OWN_FLAGS.has(arg));\n\nif (args.includes(\"--serve\")) {\n  if (engineConfig.isSourceOfTruthAdapter) {\n    throw new Error(\n      \"Dev Mode (--serve) has nothing to sync this project's Storybook against — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json.\",\n    );\n  }\n  // Dual-Storybook interactive Dev Mode — no Playwright, no screenshots.\n  // Used by the `adapter-tester` npm script.\n  startDevServer(engineConfig, webServers);\n} else {\n  // The golden-image checks never need the source-of-truth adapter's own\n  // Storybook running — the divergence check reads its stored golden files,\n  // not a live page — so only the last (own) webServer is booted here. Dev\n  // Mode above is the one thing that still needs both.\n  runAutomated(webServers.slice(-1), engineConfig);\n}\n\n/**\n * Generates a throwaway Playwright config + spec under `.adapter-tester/run/`\n * and runs the automated pixel-diff suite. Used by the\n * `adapter-tester:automated` npm script.\n */\nfunction runAutomated(\n  servers: HarnessWebServerConfig[],\n  config: AdapterTesterConfig,\n): void {\n  const runDir = join(cwd, \".adapter-tester/run\");\n  mkdirSync(runDir, { recursive: true });\n\n  writeFileSync(\n    join(runDir, \"playwright.config.js\"),\n    `// Generated by \\`adapter-tester\\` — do not edit, regenerated on every run.\nimport { defineConfig, devices } from \"@playwright/test\";\n\nexport default defineConfig({\n  testDir: ${JSON.stringify(runDir)},\n  // Stories run across Playwright's default worker pool — each golden check\n  // only reads/writes its own story's manifest.json entry, under a lock, so\n  // concurrent workers never race each other (see \\`updateManifestEntry\\`).\n  // Override with \\`--workers <n>\\` (forwarded straight through to Playwright).\n  fullyParallel: true,\n  forbidOnly: !!process.env.CI,\n  retries: process.env.CI ? 2 : 0,\n  reporter: [[\"html\", { open: \"never\" }], [\"list\"]],\n  use: { trace: \"on-first-retry\" },\n  projects: [{ name: \"chromium\", use: { ...devices[\"Desktop Chrome\"] } }],\n  webServer: ${JSON.stringify(servers, null, 2)},\n});\n`,\n  );\n\n  writeFileSync(\n    join(runDir, \"visual-regression.spec.js\"),\n    `// Generated by \\`adapter-tester\\` — do not edit, regenerated on every run.\nimport { test } from \"@playwright/test\";\nimport { resolveVisualRegressionPlan } from ${JSON.stringify(testingEntry)};\n\n// \\`test.describe\\`/\\`test\\` are called here, not inside resolveVisualRegressionPlan,\n// so Playwright's HTML report groups the suite under this file instead of a\n// sourcemapped path into adapter-tester's own library code.\nconst { ownTargetName, suiteLabel, stories, checkStory } =\n  await resolveVisualRegressionPlan(${JSON.stringify(config, null, 2)});\n\ntest.describe(\\`\\${ownTargetName} — \\${suiteLabel}\\`, () => {\n  for (const story of stories) {\n    test(story.id, async ({ browser }, testInfo) => {\n      await checkStory(story, browser, testInfo);\n    });\n  }\n});\n`,\n  );\n\n  const result = spawnSync(\n    \"npx\",\n    [\n      \"playwright\",\n      \"test\",\n      \"--config\",\n      join(runDir, \"playwright.config.js\"),\n      ...passthroughArgs,\n    ],\n    { stdio: \"inherit\", cwd, shell: process.platform === \"win32\" },\n  );\n\n  process.exit(result.status ?? 1);\n}\n"],"names":["distDir","dirname","fileURLToPath","_documentCurrentScript","isPortActive","port","resolve","socket","net","waitForPort","timeoutMs","start","portOf","url","launchStorybook","name","server","child","spawn","_a","data","line","_b","err","openBrowser","startCmd","startDevServer","engineConfig","webServers","options","sourceOfTruth","target","sourceOfTruthServer","targetServer","devPort","sourceOfTruthPort","targetPort","app","express","publicDir","join","headerPath","req","res","next","html","readFileSync","createProxyMiddleware","spawned","cleaningUp","cleanup","sourceOfTruthRunning","targetRunning","waits","addFormats","ajvFormatsModule.default","ajv","Ajv","validate","schema","validateFileConfig","path","errors","error","extra","MANTINE_ADAPTER_PACKAGE_NAME","CONFIG_FILE_NAME","DEFAULT_STORYBOOK_COMMAND","DEFAULT_STORYBOOK_PORT","DEFAULT_SOURCE_OF_TRUTH_PORT","DEFAULT_SOURCE_OF_TRUTH_NAME","DEFAULT_DIFF_THRESHOLD_PIXELS","readOwnPackageJson","cwd","existsSync","detectOwnPort","storybookScript","match","detectOwnName","loadFileConfig","resolveConfig","overrides","file","isSourceOfTruthAdapter","ownName","ownPort","ownCommand","ownCwd","_c","ownWebServer","sharedEngineConfig","sourceOfTruthName","sourceOfTruthWebServer","sourceOfTruthGolden","sourceOfTruthCwd","mantineAdapterVersion","mantineSourceOfTruthWebServer","testingEntry","pathToFileURL","args","sourceOfTruthVersion","sourceOfTruthVersionFlagIndex","value","OWN_FLAGS","passthroughArgs","arg","runAutomated","servers","config","runDir","mkdirSync","writeFileSync","result","spawnSync"],"mappings":"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"}