npm - @recursica/adapter-tester - Versions diffs - 5.0.1 → 5.0.2 - Mend

@recursica/adapter-tester 5.0.1 → 5.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

package/README.md +2 -0
package/dist/adapter-tester.schema.json.d.ts +4 -0
package/dist/cli.cjs +8 -8
package/dist/cli.cjs.map +1 -1
package/dist/cli.js +38 -33
package/dist/cli.js.map +1 -1
package/dist/config.d.ts +3 -0
package/dist/config.d.ts.map +1 -1
package/dist/devServer.d.ts.map +1 -1
package/dist/fileConfig.d.ts +3 -0
package/dist/fileConfig.d.ts.map +1 -1
package/dist/index.cjs.map +1 -1
package/dist/index.js.map +1 -1
package/dist/testing/runVisualRegression.d.ts.map +1 -1
package/dist/testing.cjs +4 -4
package/dist/testing.cjs.map +1 -1
package/dist/testing.js +16 -14
package/dist/testing.js.map +1 -1
package/package.json +1 -1
package/report-header.txt +1 -1
package/src/adapter-tester.schema.json +4 -0

package/dist/cli.js CHANGED Viewed

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { spawn as _, spawnSync as q } from "node:child_process";
-import { readFileSync as S, mkdirSync as F, writeFileSync as O, existsSync as I } from "node:fs";
-import { dirname as D, join as a, resolve as j } from "node:path";
-import { fileURLToPath as M, pathToFileURL as H } from "node:url";
+import { spawn as F, spawnSync as J } from "node:child_process";
+import { readFileSync as S, mkdirSync as _, writeFileSync as O, existsSync as I } from "node:fs";
+import { dirname as P, join as a, resolve as j } from "node:path";
+import { fileURLToPath as M, pathToFileURL as q } from "node:url";
 import W from "express";
 import { createProxyMiddleware as B } from "http-proxy-middleware";
 import K from "node:net";
@@ -30,12 +30,12 @@ function te(e) {
   }
 }
 function re(e, t) {
-  F(D(e), { recursive: !0 }), O(e, JSON.stringify({ port: t }));
+  _(P(e), { recursive: !0 }), O(e, JSON.stringify({ port: t }));
 }
 function oe(e, t) {
   return new Promise((r, o) => {
     var y, w;
-    const s = _(e.command, {
+    const s = F(e.command, {
       cwd: e.cwd,
       stdio: "pipe",
       shell: !0
@@ -84,7 +84,7 @@ function x(e, t) {
     timeoutMs: t.timeout
   };
 }
-async function E(e) {
+async function A(e) {
   if (e.reuseExistingServer) {
     const t = te(e.cacheFile);
     if (t !== void 0 && await ee(t))
@@ -98,10 +98,10 @@ async function E(e) {
   }
   return console.log(`[Dev Launcher] Launching Storybook for ${e.name}...`), oe(e, e.timeoutMs ?? 120 * 1e3);
 }
-const N = D(M(import.meta.url));
+const N = P(M(import.meta.url));
 function se(e) {
   const t = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-  console.log(`[Dev Launcher] Auto-launching browser: ${e}`), _(t, [e], { shell: process.platform === "win32" }).on(
+  console.log(`[Dev Launcher] Auto-launching browser: ${e}`), F(t, [e], { shell: process.platform === "win32" }).on(
     "error",
     (r) => {
       console.error("[Dev Launcher] Failed to auto-launch browser:", r);
@@ -119,10 +119,10 @@ async function ne(e, t, r = {}) {
     `[Dev Launcher] Resolving ${o.name} and ${s.name} Storybooks...`
   );
   const [y, w] = await Promise.all([
-    E(
+    A(
       x(o.name, n)
     ),
-    E(x(s.name, d))
+    A(x(s.name, d))
   ]);
   console.log("[Dev Launcher] Both Storybooks are active and responsive!");
   const i = [y.process, w.process].filter(
@@ -133,7 +133,7 @@ async function ne(e, t, r = {}) {
       b();
       return;
     }
-    const J = S(a(l, "index.html"), "utf8").replace(
+    const H = S(a(l, "index.html"), "utf8").replace(
       "<head>",
       `<head>
   <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({
@@ -142,8 +142,12 @@ async function ne(e, t, r = {}) {
         sourceOfTruthPort: y.port
       })};<\/script>`
     );
-    T.send(J);
+    T.send(H);
   }), u.get("/report-header.txt", (f, T) => {
+    if (e.reportHeader !== void 0) {
+      T.type("text/plain").send(e.reportHeader);
+      return;
+    }
     try {
       T.type("text/plain").send(S(v, "utf8"));
     } catch {
@@ -177,7 +181,7 @@ async function ne(e, t, r = {}) {
 `), se(`http://localhost:${h}`);
   });
 }
-const ie = "http://json-schema.org/draft-07/schema#", ae = "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json", ce = "adapter-tester.config.json", ue = "Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.", de = "object", le = !1, pe = { $schema: { type: "string", description: 'Optional pointer to this schema for editor autocomplete, e.g. "https://raw.githubusercontent.com/borderux/recursica/main/packages/adapter-tester/src/adapter-tester.schema.json".' }, name: { type: "string", description: `Label for this project's own target. Defaults to the unscoped name in this project's package.json (e.g. "@recursica/some-adapter" -> "some-adapter").` }, storybook: { type: "object", additionalProperties: !1, description: "This project's own Storybook target.", properties: { port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from this Storybook's own startup output, since Storybook silently falls back to an OS-assigned port whenever this one is taken. Auto-detected from this project's own `scripts.storybook` (a `-p <port>`/`--port <port>` flag) when omitted, falling back to 6006." }, command: { type: "string", description: "Command that boots the target's Storybook. Defaults to `npm run storybook`." }, cwd: { type: "string", description: 'Directory the command runs in, relative to the config file. Defaults to ".".' } } }, sourceOfTruth: { description: 'The comparison target. Defaults to `{ "type": "mantine-harness" }`.', oneOf: [{ type: "object", additionalProperties: !1, description: "Default mode: boots a throwaway harness that installs the published @recursica/mantine-adapter from npm — no monorepo checkout required.", properties: { type: { const: "mantine-harness" }, port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from the throwaway harness's Storybook's own startup output." }, mantineAdapterVersion: { type: "string", description: "npm version/tag of @recursica/mantine-adapter to install in the harness. Defaults to `latest`." }, storybookTemplateVersion: { type: "string", description: "npm version/tag of @recursica/storybook-template to install in the harness. Defaults to `latest`." } } }, { type: "object", additionalProperties: !1, description: "Non-standard mode: points at an already-addressable Storybook — e.g. a sibling workspace package's own Storybook inside this monorepo.", required: ["type"], properties: { type: { const: "url" }, name: { type: "string", description: 'Label for the source-of-truth target. Defaults to "Mantine".' }, port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from the source-of-truth Storybook's own startup output. Defaults to 6011." }, command: { type: "string", description: "Command that boots the source-of-truth Storybook. Defaults to `npm run storybook`." }, cwd: { type: "string", description: 'Directory the command runs in, relative to the config file. Defaults to ".".' } } }] }, isSourceOfTruthAdapter: { type: "boolean", description: "True only for the source-of-truth adapter's own config (mantine-adapter). Skips `sourceOfTruth` entirely — there's nothing above it to diverge from — and runs the own-drift golden check standalone, against just this project's own Storybook. Defaults to false." }, goldenThresholdPixels: { type: "number", minimum: 0, description: "Global visual diff threshold for the own-drift check (this project's live render vs. its own committed `test/golden/` image), in mismatched pixels, before a story is considered a failure. Same library/component on both sides, so this should stay tight. Defaults to 10. AI agents must not modify this field — see AGENT.md.", default: 10 }, sourceOfTruthThresholdPixels: { type: "number", minimum: 0, description: "Global visual diff threshold for the source-of-truth divergence check (this project's golden vs. the source-of-truth adapter's golden), in mismatched pixels, before a difference is flagged. Comparing across two different component libraries has legitimate structural variation (native control widgets, font rendering, etc.), so this is expected to be set much higher than `goldenThresholdPixels`. Ignored on the source-of-truth adapter's own config (`isSourceOfTruthAdapter: true`), which has no divergence check. Defaults to 3500. AI agents must not modify this field — see AGENT.md.", default: 3500 }, stories: { type: "object", additionalProperties: { type: "object", additionalProperties: !1, properties: { goldenThreshold: { type: "number", minimum: 0, description: "Diff threshold override for matching stories' own-drift check, in mismatched pixels. Overrides `goldenThresholdPixels`." }, sourceOfTruthThreshold: { type: "number", minimum: 0, description: "Diff threshold override for matching stories' source-of-truth divergence check, in mismatched pixels. Overrides `sourceOfTruthThresholdPixels`." }, exclude: { type: "boolean", description: "Skip matching stories entirely — no own-drift check, no divergence check, no golden captured. For stories that don't have a cross-adapter counterpart; use `excludeTitlePrefixes` to drop a whole title instead." } } }, description: "Per-story overrides, keyed by story id prefix (a story matches if its id equals the key or starts with it). When more than one key matches a story, the longest (most specific) key wins." }, excludeTitlePrefixes: { type: "array", items: { type: "string" }, description: "Storybook title prefixes to exclude from comparison, in addition to the built-in denylist (`Theme/*`, `Tokens/*`, `Introduction`)." } }, he = {
+const ie = "http://json-schema.org/draft-07/schema#", ae = "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/adapter-tester.schema.json", ce = "adapter-tester.config.json", ue = "Configuration for @recursica/adapter-tester. All fields are optional — an adapter repo with a normal `storybook` npm script needs no config file at all.", de = "object", le = !1, pe = { $schema: { type: "string", description: 'Optional pointer to this schema for editor autocomplete, e.g. "https://raw.githubusercontent.com/borderux/recursica/main/packages/adapter-tester/src/adapter-tester.schema.json".' }, name: { type: "string", description: `Label for this project's own target. Defaults to the unscoped name in this project's package.json (e.g. "@recursica/some-adapter" -> "some-adapter").` }, storybook: { type: "object", additionalProperties: !1, description: "This project's own Storybook target.", properties: { port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from this Storybook's own startup output, since Storybook silently falls back to an OS-assigned port whenever this one is taken. Auto-detected from this project's own `scripts.storybook` (a `-p <port>`/`--port <port>` flag) when omitted, falling back to 6006." }, command: { type: "string", description: "Command that boots the target's Storybook. Defaults to `npm run storybook`." }, cwd: { type: "string", description: 'Directory the command runs in, relative to the config file. Defaults to ".".' } } }, sourceOfTruth: { description: 'The comparison target. Defaults to `{ "type": "mantine-harness" }`.', oneOf: [{ type: "object", additionalProperties: !1, description: "Default mode: boots a throwaway harness that installs the published @recursica/mantine-adapter from npm — no monorepo checkout required.", properties: { type: { const: "mantine-harness" }, port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from the throwaway harness's Storybook's own startup output." }, mantineAdapterVersion: { type: "string", description: "npm version/tag of @recursica/mantine-adapter to install in the harness. Defaults to `latest`." }, storybookTemplateVersion: { type: "string", description: "npm version/tag of @recursica/storybook-template to install in the harness. Defaults to `latest`." } } }, { type: "object", additionalProperties: !1, description: "Non-standard mode: points at an already-addressable Storybook — e.g. a sibling workspace package's own Storybook inside this monorepo.", required: ["type"], properties: { type: { const: "url" }, name: { type: "string", description: 'Label for the source-of-truth target. Defaults to "Mantine".' }, port: { type: "integer", minimum: 1, maximum: 65535, description: "First-guess port only, not authoritative — the real port is auto-detected from the source-of-truth Storybook's own startup output. Defaults to 6011." }, command: { type: "string", description: "Command that boots the source-of-truth Storybook. Defaults to `npm run storybook`." }, cwd: { type: "string", description: 'Directory the command runs in, relative to the config file. Defaults to ".".' } } }] }, isSourceOfTruthAdapter: { type: "boolean", description: "True only for the source-of-truth adapter's own config (mantine-adapter). Skips `sourceOfTruth` entirely — there's nothing above it to diverge from — and runs the own-drift golden check standalone, against just this project's own Storybook. Defaults to false." }, goldenThresholdPixels: { type: "number", minimum: 0, description: "Global visual diff threshold for the own-drift check (this project's live render vs. its own committed `test/golden/` image), in mismatched pixels, before a story is considered a failure. Same library/component on both sides, so this should stay tight. Defaults to 10. AI agents must not modify this field — see AGENT.md.", default: 10 }, sourceOfTruthThresholdPixels: { type: "number", minimum: 0, description: "Global visual diff threshold for the source-of-truth divergence check (this project's golden vs. the source-of-truth adapter's golden), in mismatched pixels, before a difference is flagged. Comparing across two different component libraries has legitimate structural variation (native control widgets, font rendering, etc.), so this is expected to be set much higher than `goldenThresholdPixels`. Ignored on the source-of-truth adapter's own config (`isSourceOfTruthAdapter: true`), which has no divergence check. Defaults to 3500. AI agents must not modify this field — see AGENT.md.", default: 3500 }, stories: { type: "object", additionalProperties: { type: "object", additionalProperties: !1, properties: { goldenThreshold: { type: "number", minimum: 0, description: "Diff threshold override for matching stories' own-drift check, in mismatched pixels. Overrides `goldenThresholdPixels`." }, sourceOfTruthThreshold: { type: "number", minimum: 0, description: "Diff threshold override for matching stories' source-of-truth divergence check, in mismatched pixels. Overrides `sourceOfTruthThresholdPixels`." }, exclude: { type: "boolean", description: "Skip matching stories entirely — no own-drift check, no divergence check, no golden captured. For stories that don't have a cross-adapter counterpart; use `excludeTitlePrefixes` to drop a whole title instead." } } }, description: "Per-story overrides, keyed by story id prefix (a story matches if its id equals the key or starts with it). When more than one key matches a story, the longest (most specific) key wins." }, excludeTitlePrefixes: { type: "array", items: { type: "string" }, description: "Storybook title prefixes to exclude from comparison, in addition to the built-in denylist (`Theme/*`, `Tokens/*`, `Introduction`)." }, reportHeader: { type: "string", description: 'Overrides the AI report header text shown in Dev Mode\'s "Full Report" export. Defaults to the contents of `report-header.txt`.' } }, he = {
   $schema: ie,
   $id: ae,
   title: ce,
@@ -199,7 +203,7 @@ function me(e, t) {
   throw new Error(`Invalid ${t}:
 ${r}`);
 }
-const ge = "@recursica/mantine-adapter", ye = "adapter-tester.config.json", L = "npm run storybook", we = 6006, C = 6011, R = "Mantine", ve = 10, Te = 3500;
+const ge = "@recursica/mantine-adapter", ye = "adapter-tester.config.json", L = "npm run storybook", we = 6006, R = 6011, C = "Mantine", ve = 10, Te = 3500;
 function G(e) {
   const t = a(e, "package.json");
   if (!I(t))
@@ -243,6 +247,7 @@ function Oe(e, t = {}) {
     sourceOfTruthThresholdPixels: r.sourceOfTruthThresholdPixels ?? Te,
     stories: r.stories,
     excludeTitlePrefixes: r.excludeTitlePrefixes,
+    reportHeader: r.reportHeader,
     // Keyed off `ownCwd`, not `cwd` — the project actually being tested, not
     // wherever the config file happens to live. Matters whenever
     // `storybook.cwd` points at a sibling package: its goldens must resolve
@@ -273,7 +278,7 @@ function Oe(e, t = {}) {
       throw new Error(
         `--source-of-truth-version has no effect with sourceOfTruth.type: "url" — that mode reads a sibling package's local checkout directly, not a published version.`
       );
-    u = i.name ?? R, l = i.port ?? C;
+    u = i.name ?? C, l = i.port ?? R;
     const b = j(e, i.cwd ?? ".");
     v = {
       command: i.command ?? L,
@@ -287,7 +292,7 @@ function Oe(e, t = {}) {
       dir: a(b, "test", "golden")
     };
   } else {
-    u = R, l = i.port ?? C;
+    u = C, l = i.port ?? R;
     const b = t.mantineAdapterVersion ?? i.mantineAdapterVersion;
     v = X({
       dir: a(e, ".adapter-tester/mantine-harness"),
@@ -320,7 +325,7 @@ function Oe(e, t = {}) {
     webServers: [v, y]
   };
 }
-const xe = D(M(import.meta.url)), Ee = H(a(xe, "testing.js")).href, g = process.argv.slice(2);
+const xe = P(M(import.meta.url)), Ae = q(a(xe, "testing.js")).href, g = process.argv.slice(2);
 let V;
 const k = g.indexOf("--source-of-truth-version");
 if (k !== -1) {
@@ -331,7 +336,7 @@ if (k !== -1) {
     );
   V = e, g.splice(k, 2);
 }
-const A = process.cwd(), { engineConfig: m, webServers: P } = Oe(A, {
+const E = process.cwd(), { engineConfig: m, webServers: D } = Oe(E, {
   mantineAdapterVersion: V
 });
 g.includes("--update-golden") ? m.goldenMode = "update-golden" : g.includes("--approve-divergence") && (m.goldenMode = "approve-divergence");
@@ -345,38 +350,38 @@ if (g.includes("--divergence-only")) {
   throw new Error(
     "--approve-divergence only makes sense with --divergence-only — there's nothing to approve without the divergence check running."
   );
-g.includes("--dry-run") && (console.log(JSON.stringify({ engineConfig: m, webServers: P }, null, 2)), process.exit(0));
-const Ae = /* @__PURE__ */ new Set([
+g.includes("--dry-run") && (console.log(JSON.stringify({ engineConfig: m, webServers: D }, null, 2)), process.exit(0));
+const Ee = /* @__PURE__ */ new Set([
   "--dry-run",
   "--serve",
   "--update-golden",
   "--approve-divergence",
   "--divergence-only"
-]), Pe = g.filter((e) => !Ae.has(e));
-De().catch((e) => {
+]), De = g.filter((e) => !Ee.has(e));
+Pe().catch((e) => {
   console.error(e), process.exitCode = 1;
 });
-async function De() {
+async function Pe() {
   if (g.includes("--serve")) {
     if (m.isSourceOfTruthAdapter)
       throw new Error(
         "Dev Mode (--serve) has nothing to sync this project's Storybook against — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json."
       );
-    await ne(m, P);
+    await ne(m, D);
   } else {
-    const e = P.at(-1);
+    const e = D.at(-1);
     if (!e)
       throw new Error("resolveConfig() returned no webServers to boot.");
     await je(e, m);
   }
 }
 async function je(e, t) {
-  const r = a(A, ".adapter-tester/run");
-  F(r, { recursive: !0 });
+  const r = a(E, ".adapter-tester/run");
+  _(r, { recursive: !0 });
   const o = t.targets.at(-1);
   if (!o)
     throw new Error("resolveConfig() returned no targets to check.");
-  const { url: s, process: n } = await E(
+  const { url: s, process: n } = await A(
     x(o.name, e)
   );
   o.url = s, O(
@@ -406,7 +411,7 @@ export default defineConfig({
     a(r, "visual-regression.spec.js"),
     `// Generated by \`adapter-tester\` — do not edit, regenerated on every run.
 import { test, expect } from "@playwright/test";
-import { resolveVisualRegressionPlan } from ${JSON.stringify(Ee)};
+import { resolveVisualRegressionPlan } from ${JSON.stringify(Ae)};
 // \`test.describe\`/\`test\` are called here, not inside resolveVisualRegressionPlan,
 // so Playwright's HTML report groups the suite under this file instead of a
@@ -432,16 +437,16 @@ test.describe(\`\${ownTargetName} — \${suiteLabel}\`, () => {
 `
   );
   try {
-    const d = q(
+    const d = J(
       "npx",
       [
         "playwright",
         "test",
         "--config",
         a(r, "playwright.config.js"),
-        ...Pe
+        ...De
       ],
-      { stdio: "inherit", cwd: A, shell: process.platform === "win32" }
+      { stdio: "inherit", cwd: E, shell: process.platform === "win32" }
     );
     process.exitCode = d.status ?? 1;
   } finally {

package/dist/cli.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli.js","sources":["../src/portDiscovery.ts","../src/devServer.ts","../src/validateFileConfig.ts","../src/fileConfig.ts","../src/cli.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport net from \"node:net\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\n\n/*\n Boots a target's Storybook and discovers the real port it ends up on,\n * instead of pinning one via `-p`/`--port`. Storybook silently falls back to\n * an OS-assigned port whenever its default/configured one is taken (this is\n * what caused the flaky `webServer` timeouts noted in mui-adapter), so the\n * only reliable source of truth is the URL it prints in its own startup\n * banner. Used by both the automated/headless run (cli.ts) and Dev Mode\n * (devServer.ts) — neither pins a port anymore.\n /\n\nexport interface LaunchTarget {\n /* Human-readable name used in log lines. /\n name: string;\n command: string;\n cwd: string;\n /* Reuse an already-running instance (detected via the last-known-port\n * cache) instead of spawning a new one. Mirrors the old `reuseExistingServer`\n * behavior, which used to just probe the one fixed configured port. /\n reuseExistingServer: boolean;\n /* File the discovered port is cached in between runs, so a later\n * `reuseExistingServer` run knows where to look. One per target. /\n cacheFile: string;\n timeoutMs?: number;\n}\n\nexport interface DiscoveredServer {\n url: string;\n port: number;\n /* The process we spawned, or `null` if an already-running instance was\n * reused — callers should only kill what they started. /\n process: ChildProcess \| null;\n}\n\n// Storybook prints its bound address in its startup banner wrapped in ANSI\n// color codes and box-drawing chars, e.g.:\n// │ │ - Local: http://localhost:57496/ │ │\n// Strip ANSI first, then match the URL itself.\nconst ANSI_PATTERN = /\\x1b\\[[0-9;]m/g;\nconst LOCAL_URL_PATTERN = /Local:\\s(https?:\\/\\/localhost:\\d+)/;\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\nfunction readCachedPort(cacheFile: string): number \| undefined {\n try {\n const port = JSON.parse(readFileSync(cacheFile, \"utf8\")).port;\n return typeof port === \"number\" ? port : undefined;\n } catch {\n return undefined;\n }\n}\n\nfunction writeCachedPort(cacheFile: string, port: number): void {\n mkdirSync(dirname(cacheFile), { recursive: true });\n writeFileSync(cacheFile, JSON.stringify({ port }));\n}\n\n/* Spawns `target.command`, streaming its output to the console like before,\n * and resolves once it reports the URL it actually bound to. /\nfunction spawnAndDetect(\n target: LaunchTarget,\n timeoutMs: number,\n): Promise<DiscoveredServer> {\n return new Promise((resolve, reject) => {\n const child = spawn(target.command, {\n cwd: target.cwd,\n stdio: \"pipe\",\n shell: true,\n });\n\n let settled = false;\n const timer = setTimeout(() => {\n if (settled) return;\n settled = true;\n child.kill();\n reject(\n new Error(\n `Timed out after ${timeoutMs}ms waiting for ${target.name}'s Storybook to report its URL (no \"Local: http://localhost:<port>\" line seen in its output).`,\n ),\n );\n }, timeoutMs);\n\n const handleOutput = (data: Buffer, isError: boolean) => {\n const text = data.toString();\n for (const line of text.split(\"\\n\")) {\n if (line.trim()) {\n const label = isError\n ? `${target.name} SB ERROR`\n : `${target.name} SB`;\n (isError ? console.error : console.log)(`[${label}] ${line.trim()}`);\n }\n }\n if (settled) return;\n const match = text.replace(ANSI_PATTERN, \"\").match(LOCAL_URL_PATTERN);\n if (match) {\n settled = true;\n clearTimeout(timer);\n // Non-null: LOCAL_URL_PATTERN has exactly one capture group, and a\n // match only happens when it participated.\n const url = match[1]!;\n const port = Number(new URL(url).port);\n writeCachedPort(target.cacheFile, port);\n resolve({ url, port, process: child });\n }\n };\n child.stdout?.on(\"data\", (data: Buffer) => handleOutput(data, false));\n child.stderr?.on(\"data\", (data: Buffer) => handleOutput(data, true));\n child.on(\"error\", (err) => {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n reject(err);\n });\n child.on(\"exit\", (code) => {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n reject(\n new Error(\n `${target.name}'s Storybook exited (code ${code}) before reporting its URL.`,\n ),\n );\n });\n });\n}\n\n/* Adapts a resolved `HarnessWebServerConfig` into a `LaunchTarget`. /\nexport function toLaunchTarget(\n name: string,\n server: HarnessWebServerConfig,\n): LaunchTarget {\n return {\n name,\n command: server.command,\n cwd: server.cwd,\n reuseExistingServer: server.reuseExistingServer,\n cacheFile: server.cacheFile,\n timeoutMs: server.timeout,\n };\n}\n\n/* Reuses an already-running Storybook if `reuseExistingServer` is set and\n * the last-known-port cache points at something still listening; otherwise\n * spawns `target.command` fresh and detects the real port from its output. /\nexport async function launchAndDetectStorybook(\n target: LaunchTarget,\n): Promise<DiscoveredServer> {\n if (target.reuseExistingServer) {\n const cachedPort = readCachedPort(target.cacheFile);\n if (cachedPort !== undefined && (await isPortActive(cachedPort))) {\n console.log(\n `[Dev Launcher] ${target.name} is already running on port ${cachedPort} (reused).`,\n );\n return {\n url: `http://localhost:${cachedPort}`,\n port: cachedPort,\n process: null,\n };\n }\n }\n console.log(`[Dev Launcher] Launching Storybook for ${target.name}...`);\n return spawnAndDetect(target, target.timeoutMs ?? 120 1000);\n}\n","import { spawn, type ChildProcess } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\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\";\nimport { launchAndDetectStorybook, toLaunchTarget } from \"./portDiscovery.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 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 async function startDevServer(\n engineConfig: AdapterTesterConfig,\n webServers: HarnessWebServerConfig[],\n options: DevServerOptions = {},\n): Promise<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\n // Neither Storybook is pinned to a specific port — each one silently\n // falls back to an OS-assigned port whenever its default/configured one is\n // taken, so the real port is only known once it reports it (see\n // portDiscovery.ts). Booted concurrently since neither depends on the other.\n console.log(\n `[Dev Launcher] Resolving ${sourceOfTruth.name} and ${target.name} Storybooks...`,\n );\n const [sourceOfTruthRunning, targetRunning] = await Promise.all([\n launchAndDetectStorybook(\n toLaunchTarget(sourceOfTruth.name, sourceOfTruthServer),\n ),\n launchAndDetectStorybook(toLaunchTarget(target.name, targetServer)),\n ]);\n console.log(`[Dev Launcher] Both Storybooks are active and responsive!`);\n\n const spawned = [sourceOfTruthRunning.process, targetRunning.process].filter(\n (child): child is ChildProcess => child !== null,\n );\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: sourceOfTruthRunning.port,\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: targetRunning.url,\n changeOrigin: true,\n ws: true,\n }),\n );\n\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, () => {\n console.log(`\n====================================================\n🚀 Adapter Dev Mode proxy running at:\n http://localhost:${devPort}\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_GOLDEN_THRESHOLD_PIXELS = 10;\nconst DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS = 3500;\n\ninterface StorybookTargetFileConfig {\n /* First-guess port only, not authoritative — the real port is\n * auto-detected from this Storybook's own startup output, since Storybook\n * silently falls back to an OS-assigned port whenever this one is taken.\n * Auto-detected from this project's own `scripts.storybook` (a `-p\n * <port>`/`--port <port>` flag) when omitted, falling back to 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 /* First-guess port only, not authoritative — see `HarnessWebServerConfig.port`. /\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 /* First-guess port only, not authoritative — see `HarnessWebServerConfig.port`.\n * Defaults to 6011. /\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 goldenThresholdPixels?: number;\n sourceOfTruthThresholdPixels?: 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 cacheFile: join(cwd, \".adapter-tester\", \"last-port-own.json\"),\n timeout: 120 1000,\n };\n\n const sharedEngineConfig = {\n goldenThresholdPixels:\n file.goldenThresholdPixels ?? DEFAULT_GOLDEN_THRESHOLD_PIXELS,\n sourceOfTruthThresholdPixels:\n file.sourceOfTruthThresholdPixels ??\n DEFAULT_SOURCE_OF_TRUTH_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 ?? DEFAULT_SOURCE_OF_TRUTH_PORT;\n const sourceOfTruthCwd = resolve(cwd, sourceOfTruth.cwd ?? \".\");\n sourceOfTruthWebServer = {\n command: sourceOfTruth.command ?? DEFAULT_STORYBOOK_COMMAND,\n port: sourceOfTruthPort,\n cwd: sourceOfTruthCwd,\n reuseExistingServer: !process.env.CI,\n cacheFile: join(cwd, \".adapter-tester\", \"last-port-source-of-truth.json\"),\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\";\nimport { launchAndDetectStorybook, toLaunchTarget } from \"./portDiscovery.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\n// The bundled build target doesn't support top-level await, so the async\n// work (launching Storybook and detecting its real port) lives in main().\nmain().catch((err) => {\n console.error(err);\n process.exitCode = 1;\n});\n\nasync function main(): Promise<void> {\n if (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 await 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 const ownWebServer = webServers.at(-1);\n if (!ownWebServer) {\n throw new Error(\"resolveConfig() returned no webServers to boot.\");\n }\n await runAutomated(ownWebServer, engineConfig);\n }\n}\n\n/*\n Boots this project's own Storybook (auto-detecting the port it actually\n * lands on — see portDiscovery.ts), generates a throwaway Playwright config\n * + spec under `.adapter-tester/run/`, and runs the automated pixel-diff\n * suite against it. Used by the `adapter-tester:automated` npm script.\n \n Playwright's own `webServer` option can't be used here — it only knows how\n * to poll a port/URL decided before the command it spawns runs, but\n * Storybook silently falls back to a different, OS-assigned port whenever\n * its configured one is taken. So this boots and waits for Storybook itself,\n * then points the generated config straight at whatever URL it actually\n * reports.\n */\nasync function runAutomated(\n server: HarnessWebServerConfig,\n config: AdapterTesterConfig,\n): Promise<void> {\n const runDir = join(cwd, \".adapter-tester/run\");\n mkdirSync(runDir, { recursive: true });\n\n const ownTarget = config.targets.at(-1);\n if (!ownTarget) {\n throw new Error(\"resolveConfig() returned no targets to check.\");\n }\n const { url, process: spawned } = await launchAndDetectStorybook(\n toLaunchTarget(ownTarget.name, server),\n );\n ownTarget.url = url;\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 // Each golden check only reads/writes its own story's manifest.json entry,\n // under a lock, so concurrent workers never race each other (see\n // \\`updateManifestEntry\\`). Defaults to 1 worker (1 Chromium instance) to\n // avoid exhausting memory running the full suite; override with\n // \\`--workers <n>\\` (forwarded straight through to Playwright) to parallelize.\n workers: 1,\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 // No webServer entry — this project's own Storybook is already running by\n // the time this config is used (see runAutomated() in cli.ts).\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, expect } 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, missingFromSourceOfTruth, checkStory } =\n await resolveVisualRegressionPlan(${JSON.stringify(config, null, 2)});\n\ntest.describe(\\`\\${ownTargetName} — \\${suiteLabel}\\`, () => {\n if (missingFromSourceOfTruth.length > 0) {\n test(\"story parity with source of truth\", () => {\n expect(\n missingFromSourceOfTruth,\n \\`\\${missingFromSourceOfTruth.length} stor(y/ies) exist in the source of truth but are missing here. Add the missing story, or mark it \\\\\\`exclude: true\\\\\\` under \\\\\\`stories\\\\\\` in adapter-tester.config.json if intentional.\\`,\n ).toEqual([]);\n });\n }\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 try {\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 process.exitCode = result.status ?? 1;\n } finally {\n // Only tear down the Storybook we spawned — an instance we reused via\n // the last-known-port cache was already running before we got here, and\n // should stay running after.\n spawned?.kill(\"SIGTERM\");\n }\n}\n"],"names":["ANSI_PATTERN","LOCAL_URL_PATTERN","isPortActive","port","resolve","socket","net","readCachedPort","cacheFile","readFileSync","writeCachedPort","mkdirSync","dirname","writeFileSync","spawnAndDetect","target","timeoutMs","reject","child","spawn","settled","timer","handleOutput","data","isError","text","line","label","match","url","_a","_b","err","code","toLaunchTarget","name","server","launchAndDetectStorybook","cachedPort","distDir","fileURLToPath","openBrowser","startCmd","startDevServer","engineConfig","webServers","options","sourceOfTruth","sourceOfTruthServer","targetServer","devPort","sourceOfTruthRunning","targetRunning","spawned","app","express","publicDir","join","headerPath","req","res","next","html","createProxyMiddleware","cleaningUp","cleanup","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_GOLDEN_THRESHOLD_PIXELS","DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS","readOwnPackageJson","cwd","existsSync","detectOwnPort","storybookScript","detectOwnName","loadFileConfig","resolveConfig","overrides","file","isSourceOfTruthAdapter","ownName","ownPort","ownCommand","ownCwd","_c","ownWebServer","sharedEngineConfig","sourceOfTruthName","sourceOfTruthPort","sourceOfTruthWebServer","sourceOfTruthGolden","sourceOfTruthCwd","mantineAdapterVersion","mantineSourceOfTruthWebServer","testingEntry","pathToFileURL","args","sourceOfTruthVersion","sourceOfTruthVersionFlagIndex","value","OWN_FLAGS","passthroughArgs","arg","main","runAutomated","config","runDir","ownTarget","result","spawnSync"],"mappings":"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"}
1	+ {"version":3,"file":"cli.js","sources":["../src/portDiscovery.ts","../src/devServer.ts","../src/validateFileConfig.ts","../src/fileConfig.ts","../src/cli.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport net from \"node:net\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\n\n/*\n Boots a target's Storybook and discovers the real port it ends up on,\n * instead of pinning one via `-p`/`--port`. Storybook silently falls back to\n * an OS-assigned port whenever its default/configured one is taken (this is\n * what caused the flaky `webServer` timeouts noted in mui-adapter), so the\n * only reliable source of truth is the URL it prints in its own startup\n * banner. Used by both the automated/headless run (cli.ts) and Dev Mode\n * (devServer.ts) — neither pins a port anymore.\n /\n\nexport interface LaunchTarget {\n /* Human-readable name used in log lines. /\n name: string;\n command: string;\n cwd: string;\n /* Reuse an already-running instance (detected via the last-known-port\n * cache) instead of spawning a new one. Mirrors the old `reuseExistingServer`\n * behavior, which used to just probe the one fixed configured port. /\n reuseExistingServer: boolean;\n /* File the discovered port is cached in between runs, so a later\n * `reuseExistingServer` run knows where to look. One per target. /\n cacheFile: string;\n timeoutMs?: number;\n}\n\nexport interface DiscoveredServer {\n url: string;\n port: number;\n /* The process we spawned, or `null` if an already-running instance was\n * reused — callers should only kill what they started. /\n process: ChildProcess \| null;\n}\n\n// Storybook prints its bound address in its startup banner wrapped in ANSI\n// color codes and box-drawing chars, e.g.:\n// │ │ - Local: http://localhost:57496/ │ │\n// Strip ANSI first, then match the URL itself.\nconst ANSI_PATTERN = /\\x1b\\[[0-9;]m/g;\nconst LOCAL_URL_PATTERN = /Local:\\s(https?:\\/\\/localhost:\\d+)/;\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\nfunction readCachedPort(cacheFile: string): number \| undefined {\n try {\n const port = JSON.parse(readFileSync(cacheFile, \"utf8\")).port;\n return typeof port === \"number\" ? port : undefined;\n } catch {\n return undefined;\n }\n}\n\nfunction writeCachedPort(cacheFile: string, port: number): void {\n mkdirSync(dirname(cacheFile), { recursive: true });\n writeFileSync(cacheFile, JSON.stringify({ port }));\n}\n\n/* Spawns `target.command`, streaming its output to the console like before,\n * and resolves once it reports the URL it actually bound to. /\nfunction spawnAndDetect(\n target: LaunchTarget,\n timeoutMs: number,\n): Promise<DiscoveredServer> {\n return new Promise((resolve, reject) => {\n const child = spawn(target.command, {\n cwd: target.cwd,\n stdio: \"pipe\",\n shell: true,\n });\n\n let settled = false;\n const timer = setTimeout(() => {\n if (settled) return;\n settled = true;\n child.kill();\n reject(\n new Error(\n `Timed out after ${timeoutMs}ms waiting for ${target.name}'s Storybook to report its URL (no \"Local: http://localhost:<port>\" line seen in its output).`,\n ),\n );\n }, timeoutMs);\n\n const handleOutput = (data: Buffer, isError: boolean) => {\n const text = data.toString();\n for (const line of text.split(\"\\n\")) {\n if (line.trim()) {\n const label = isError\n ? `${target.name} SB ERROR`\n : `${target.name} SB`;\n (isError ? console.error : console.log)(`[${label}] ${line.trim()}`);\n }\n }\n if (settled) return;\n const match = text.replace(ANSI_PATTERN, \"\").match(LOCAL_URL_PATTERN);\n if (match) {\n settled = true;\n clearTimeout(timer);\n // Non-null: LOCAL_URL_PATTERN has exactly one capture group, and a\n // match only happens when it participated.\n const url = match[1]!;\n const port = Number(new URL(url).port);\n writeCachedPort(target.cacheFile, port);\n resolve({ url, port, process: child });\n }\n };\n child.stdout?.on(\"data\", (data: Buffer) => handleOutput(data, false));\n child.stderr?.on(\"data\", (data: Buffer) => handleOutput(data, true));\n child.on(\"error\", (err) => {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n reject(err);\n });\n child.on(\"exit\", (code) => {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n reject(\n new Error(\n `${target.name}'s Storybook exited (code ${code}) before reporting its URL.`,\n ),\n );\n });\n });\n}\n\n/* Adapts a resolved `HarnessWebServerConfig` into a `LaunchTarget`. /\nexport function toLaunchTarget(\n name: string,\n server: HarnessWebServerConfig,\n): LaunchTarget {\n return {\n name,\n command: server.command,\n cwd: server.cwd,\n reuseExistingServer: server.reuseExistingServer,\n cacheFile: server.cacheFile,\n timeoutMs: server.timeout,\n };\n}\n\n/* Reuses an already-running Storybook if `reuseExistingServer` is set and\n * the last-known-port cache points at something still listening; otherwise\n * spawns `target.command` fresh and detects the real port from its output. /\nexport async function launchAndDetectStorybook(\n target: LaunchTarget,\n): Promise<DiscoveredServer> {\n if (target.reuseExistingServer) {\n const cachedPort = readCachedPort(target.cacheFile);\n if (cachedPort !== undefined && (await isPortActive(cachedPort))) {\n console.log(\n `[Dev Launcher] ${target.name} is already running on port ${cachedPort} (reused).`,\n );\n return {\n url: `http://localhost:${cachedPort}`,\n port: cachedPort,\n process: null,\n };\n }\n }\n console.log(`[Dev Launcher] Launching Storybook for ${target.name}...`);\n return spawnAndDetect(target, target.timeoutMs ?? 120 1000);\n}\n","import { spawn, type ChildProcess } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\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\";\nimport { launchAndDetectStorybook, toLaunchTarget } from \"./portDiscovery.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 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 async function startDevServer(\n engineConfig: AdapterTesterConfig,\n webServers: HarnessWebServerConfig[],\n options: DevServerOptions = {},\n): Promise<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\n // Neither Storybook is pinned to a specific port — each one silently\n // falls back to an OS-assigned port whenever its default/configured one is\n // taken, so the real port is only known once it reports it (see\n // portDiscovery.ts). Booted concurrently since neither depends on the other.\n console.log(\n `[Dev Launcher] Resolving ${sourceOfTruth.name} and ${target.name} Storybooks...`,\n );\n const [sourceOfTruthRunning, targetRunning] = await Promise.all([\n launchAndDetectStorybook(\n toLaunchTarget(sourceOfTruth.name, sourceOfTruthServer),\n ),\n launchAndDetectStorybook(toLaunchTarget(target.name, targetServer)),\n ]);\n console.log(`[Dev Launcher] Both Storybooks are active and responsive!`);\n\n const spawned = [sourceOfTruthRunning.process, targetRunning.process].filter(\n (child): child is ChildProcess => child !== null,\n );\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: sourceOfTruthRunning.port,\n })};</script>`,\n );\n res.send(html);\n });\n\n // Serve the AI prompt header dynamically so it can be edited externally.\n // `reportHeader` in adapter-tester.config.json overrides the file entirely.\n app.get(\"/report-header.txt\", (req, res) => {\n if (engineConfig.reportHeader !== undefined) {\n res.type(\"text/plain\").send(engineConfig.reportHeader);\n return;\n }\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: targetRunning.url,\n changeOrigin: true,\n ws: true,\n }),\n );\n\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, () => {\n console.log(`\n====================================================\n🚀 Adapter Dev Mode proxy running at:\n http://localhost:${devPort}\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_GOLDEN_THRESHOLD_PIXELS = 10;\nconst DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS = 3500;\n\ninterface StorybookTargetFileConfig {\n /* First-guess port only, not authoritative — the real port is\n * auto-detected from this Storybook's own startup output, since Storybook\n * silently falls back to an OS-assigned port whenever this one is taken.\n * Auto-detected from this project's own `scripts.storybook` (a `-p\n * <port>`/`--port <port>` flag) when omitted, falling back to 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 /* First-guess port only, not authoritative — see `HarnessWebServerConfig.port`. /\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 /* First-guess port only, not authoritative — see `HarnessWebServerConfig.port`.\n * Defaults to 6011. /\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 goldenThresholdPixels?: number;\n sourceOfTruthThresholdPixels?: number;\n stories?: Record<string, StoryOverride>;\n excludeTitlePrefixes?: string[];\n /* Overrides the AI report header text shown in Dev Mode's \"Full Report\"\n * export. Defaults to the contents of `report-header.txt`. /\n reportHeader?: 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 cacheFile: join(cwd, \".adapter-tester\", \"last-port-own.json\"),\n timeout: 120 1000,\n };\n\n const sharedEngineConfig = {\n goldenThresholdPixels:\n file.goldenThresholdPixels ?? DEFAULT_GOLDEN_THRESHOLD_PIXELS,\n sourceOfTruthThresholdPixels:\n file.sourceOfTruthThresholdPixels ??\n DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS,\n stories: file.stories,\n excludeTitlePrefixes: file.excludeTitlePrefixes,\n reportHeader: file.reportHeader,\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 ?? DEFAULT_SOURCE_OF_TRUTH_PORT;\n const sourceOfTruthCwd = resolve(cwd, sourceOfTruth.cwd ?? \".\");\n sourceOfTruthWebServer = {\n command: sourceOfTruth.command ?? DEFAULT_STORYBOOK_COMMAND,\n port: sourceOfTruthPort,\n cwd: sourceOfTruthCwd,\n reuseExistingServer: !process.env.CI,\n cacheFile: join(cwd, \".adapter-tester\", \"last-port-source-of-truth.json\"),\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\";\nimport { launchAndDetectStorybook, toLaunchTarget } from \"./portDiscovery.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\n// The bundled build target doesn't support top-level await, so the async\n// work (launching Storybook and detecting its real port) lives in main().\nmain().catch((err) => {\n console.error(err);\n process.exitCode = 1;\n});\n\nasync function main(): Promise<void> {\n if (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 await 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 const ownWebServer = webServers.at(-1);\n if (!ownWebServer) {\n throw new Error(\"resolveConfig() returned no webServers to boot.\");\n }\n await runAutomated(ownWebServer, engineConfig);\n }\n}\n\n/*\n Boots this project's own Storybook (auto-detecting the port it actually\n * lands on — see portDiscovery.ts), generates a throwaway Playwright config\n * + spec under `.adapter-tester/run/`, and runs the automated pixel-diff\n * suite against it. Used by the `adapter-tester:automated` npm script.\n \n Playwright's own `webServer` option can't be used here — it only knows how\n * to poll a port/URL decided before the command it spawns runs, but\n * Storybook silently falls back to a different, OS-assigned port whenever\n * its configured one is taken. So this boots and waits for Storybook itself,\n * then points the generated config straight at whatever URL it actually\n * reports.\n */\nasync function runAutomated(\n server: HarnessWebServerConfig,\n config: AdapterTesterConfig,\n): Promise<void> {\n const runDir = join(cwd, \".adapter-tester/run\");\n mkdirSync(runDir, { recursive: true });\n\n const ownTarget = config.targets.at(-1);\n if (!ownTarget) {\n throw new Error(\"resolveConfig() returned no targets to check.\");\n }\n const { url, process: spawned } = await launchAndDetectStorybook(\n toLaunchTarget(ownTarget.name, server),\n );\n ownTarget.url = url;\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 // Each golden check only reads/writes its own story's manifest.json entry,\n // under a lock, so concurrent workers never race each other (see\n // \\`updateManifestEntry\\`). Defaults to 1 worker (1 Chromium instance) to\n // avoid exhausting memory running the full suite; override with\n // \\`--workers <n>\\` (forwarded straight through to Playwright) to parallelize.\n workers: 1,\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 // No webServer entry — this project's own Storybook is already running by\n // the time this config is used (see runAutomated() in cli.ts).\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, expect } 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, missingFromSourceOfTruth, checkStory } =\n await resolveVisualRegressionPlan(${JSON.stringify(config, null, 2)});\n\ntest.describe(\\`\\${ownTargetName} — \\${suiteLabel}\\`, () => {\n if (missingFromSourceOfTruth.length > 0) {\n test(\"story parity with source of truth\", () => {\n expect(\n missingFromSourceOfTruth,\n \\`\\${missingFromSourceOfTruth.length} stor(y/ies) exist in the source of truth but are missing here. Add the missing story, or mark it \\\\\\`exclude: true\\\\\\` under \\\\\\`stories\\\\\\` in adapter-tester.config.json if intentional.\\`,\n ).toEqual([]);\n });\n }\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 try {\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 process.exitCode = result.status ?? 1;\n } finally {\n // Only tear down the Storybook we spawned — an instance we reused via\n // the last-known-port cache was already running before we got here, and\n // should stay running after.\n spawned?.kill(\"SIGTERM\");\n }\n}\n"],"names":["ANSI_PATTERN","LOCAL_URL_PATTERN","isPortActive","port","resolve","socket","net","readCachedPort","cacheFile","readFileSync","writeCachedPort","mkdirSync","dirname","writeFileSync","spawnAndDetect","target","timeoutMs","reject","child","spawn","settled","timer","handleOutput","data","isError","text","line","label","match","url","_a","_b","err","code","toLaunchTarget","name","server","launchAndDetectStorybook","cachedPort","distDir","fileURLToPath","openBrowser","startCmd","startDevServer","engineConfig","webServers","options","sourceOfTruth","sourceOfTruthServer","targetServer","devPort","sourceOfTruthRunning","targetRunning","spawned","app","express","publicDir","join","headerPath","req","res","next","html","createProxyMiddleware","cleaningUp","cleanup","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_GOLDEN_THRESHOLD_PIXELS","DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS","readOwnPackageJson","cwd","existsSync","detectOwnPort","storybookScript","detectOwnName","loadFileConfig","resolveConfig","overrides","file","isSourceOfTruthAdapter","ownName","ownPort","ownCommand","ownCwd","_c","ownWebServer","sharedEngineConfig","sourceOfTruthName","sourceOfTruthPort","sourceOfTruthWebServer","sourceOfTruthGolden","sourceOfTruthCwd","mantineAdapterVersion","mantineSourceOfTruthWebServer","testingEntry","pathToFileURL","args","sourceOfTruthVersion","sourceOfTruthVersionFlagIndex","value","OWN_FLAGS","passthroughArgs","arg","main","runAutomated","config","runDir","ownTarget","result","spawnSync"],"mappings":"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"}

package/dist/config.d.ts CHANGED Viewed

@@ -95,6 +95,9 @@ export interface AdapterTesterConfig {
     goldenMode: GoldenMode;
     /** Set by the CLI from `--divergence-only`. Defaults to `"own"`. */
     checkMode: CheckMode;
+    /** Overrides the AI report header text (normally read from
+     * `report-header.txt`) shown in Dev Mode's "Full Report" export. */
+    reportHeader?: string;
 }
 export declare function defineAdapterTesterConfig(config: AdapterTesterConfig): AdapterTesterConfig;
 export declare function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget;

package/dist/config.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;mEAEmE;AACnE,MAAM,MAAM,2BAA2B,GACnC;IACE;+EAC2E;IAC3E,IAAI,EAAE,OAAO,CAAC;IACd,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE;;gFAE4E;IAC5E,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B;kCAC8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;mBAGe;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;oFACgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB;;4BAEwB;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;;kDAK8C;IAC9C,4BAA4B,EAAE,MAAM,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;2CACuC;IACvC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,2FAA2F;IAC3F,UAAU,EAAE,UAAU,CAAC;IACvB,oEAAoE;IACpE,SAAS,EAAE,SAAS,CAAC;~~CACtB~~;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAUrB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAM3E"}
1	+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;mEAEmE;AACnE,MAAM,MAAM,2BAA2B,GACnC;IACE;+EAC2E;IAC3E,IAAI,EAAE,OAAO,CAAC;IACd,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE;;gFAE4E;IAC5E,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B;kCAC8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;mBAGe;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;oFACgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB;;4BAEwB;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;;kDAK8C;IAC9C,4BAA4B,EAAE,MAAM,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;2CACuC;IACvC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,2FAA2F;IAC3F,UAAU,EAAE,UAAU,CAAC;IACvB,oEAAoE;IACpE,SAAS,EAAE,SAAS,CAAC;IACrB;wEACoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAUrB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAM3E"}

package/dist/devServer.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../src/devServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAkChF,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,sBAAsB,EAAE,EACpC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,~~CAsGf~~"}
1	+ {"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../src/devServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAkChF,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,sBAAsB,EAAE,EACpC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA2Gf"}

package/dist/fileConfig.d.ts CHANGED Viewed

@@ -44,6 +44,9 @@ export interface AdapterTesterFileConfig {
     sourceOfTruthThresholdPixels?: number;
     stories?: Record<string, StoryOverride>;
     excludeTitlePrefixes?: string[];
+    /** Overrides the AI report header text shown in Dev Mode's "Full Report"
+     * export. Defaults to the contents of `report-header.txt`. */
+    reportHeader?: string;
     /**
      * True only for the source-of-truth adapter's own config (mantine-adapter).
      * Skips `sourceOfTruth` entirely — there's nothing above it to diverge

package/dist/fileConfig.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"fileConfig.d.ts","sourceRoot":"","sources":["../src/fileConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EAEnB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAMhF,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAQ7D,UAAU,yBAAyB;IACjC;;;;2EAIuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,qCAAqC;IAC7C;gFAC4E;IAC5E,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,0BAA0B;IAClC;yEACqE;IACrE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;2BACuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,KAAK,uBAAuB,GACxB,qCAAqC,GACrC,0BAA0B,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC;uFACmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,sBAA2B,GACrC,2BAA2B,~~CAmI7B~~"}
1	+ {"version":3,"file":"fileConfig.d.ts","sourceRoot":"","sources":["../src/fileConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EAEnB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAMhF,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAQ7D,UAAU,yBAAyB;IACjC;;;;2EAIuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,qCAAqC;IAC7C;gFAC4E;IAC5E,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,0BAA0B;IAClC;yEACqE;IACrE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;2BACuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,KAAK,uBAAuB,GACxB,qCAAqC,GACrC,0BAA0B,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC;uFACmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;kEAC8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,sBAA2B,GACrC,2BAA2B,CAoI7B"}

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.cjs","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n /** Human-readable name used in test titles, report labels, and artifact filenames. /\n name: string;\n /* Base URL the target's Storybook instance is served from. /\n url: string;\n /\n Marks this target as the visual/token source of truth every other target\n * is compared against. Exactly one target in a config must set this true.\n /\n sourceOfTruth?: boolean;\n}\n\n/* How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)\n * own golden images, for the divergence check. Never involves booting a\n * Storybook — both `readImage` targets are plain files on disk. /\nexport type SourceOfTruthGoldenLocation =\n \| {\n /* Sibling package already checked out locally (this monorepo's own\n * `sourceOfTruth.type: \"url\"` mode) — read its `test/golden/` directly. /\n type: \"local\";\n /* Absolute path to the source-of-truth adapter's `test/golden/` directory. /\n dir: string;\n }\n \| {\n /* No local checkout (the default, standalone-repo mode) — resolve the\n * installed version against the npm registry, then fetch that git tag's\n * `test/golden/` from the public GitHub repo, caching what's downloaded. /\n type: \"npm\";\n packageName: string;\n /* npm version/dist-tag to resolve, e.g. \"latest\" or a pinned version. /\n versionSpec: string;\n /* Directory downloaded manifest/images are cached in between runs. /\n cacheDir: string;\n };\n\nexport type GoldenMode = \"check\" \| \"update-golden\" \| \"approve-divergence\";\n\n/\n Which check(s) a run performs. `\"own\"` (the default) is what a normal,\n * fast, no-network run does: this project's own live render vs. its own\n * committed golden images. `\"divergence\"` is the separate, opt-in check\n * against the source-of-truth adapter's published golden images.\n /\nexport type CheckMode = \"own\" \| \"divergence\";\n\nexport interface StoryOverride {\n /* Diff threshold override for this story's own-drift check. Overrides\n * `goldenThresholdPixels`. /\n goldenThreshold?: number;\n /* Diff threshold override for this story's source-of-truth divergence\n * check. Overrides `sourceOfTruthThresholdPixels` for components with\n * acceptable cross-library structural variation (e.g. native control\n * widgets). /\n sourceOfTruthThreshold?: number;\n /* Skip this story entirely — no own-drift check, no divergence check, no\n * golden captured. For stories with no meaningful cross-adapter counterpart. /\n exclude?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /* Global pixel-diff threshold for the own-drift check (this project's live\n * render vs. its own committed golden). Same library on both sides, so this\n * should stay tight. /\n goldenThresholdPixels: number;\n /* Global pixel-diff threshold for the source-of-truth divergence check\n * (this project's golden vs. the source-of-truth adapter's golden).\n * Comparing across two different component libraries has legitimate\n * structural variation, so this is expected to be much higher than\n * `goldenThresholdPixels`. Unused on the source-of-truth adapter's own\n * config (`isSourceOfTruthAdapter: true`). /\n sourceOfTruthThresholdPixels: number;\n /\n Per-story overrides, keyed by story id prefix (a story matches if its id\n * equals the key or starts with it). When more than one key matches, the\n * longest (most specific) key wins.\n /\n stories?: Record<string, StoryOverride>;\n /\n Storybook entry title categories excluded from the comparison — an\n * entry is excluded if its title equals one of these or starts with\n * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n * `@recursica/storybook-template`'s own default token/theme demo stories\n * (which every adapter's Storybook inherits automatically) plus each\n * adapter's own onboarding \"Introduction\" stories — neither has a\n * cross-adapter counterpart to diff against.\n /\n excludeTitlePrefixes?: string[];\n /* Absolute path to this project's own `test/golden/` directory — where\n * golden PNGs and `manifest.json` are stored, committed to git. /\n goldenDir: string;\n /\n True only for the source-of-truth adapter's own config (mantine). It has\n * nothing above it to diverge from, so the divergence check is skipped\n * entirely and `sourceOfTruthGolden` is ignored.\n /\n isSourceOfTruthAdapter: boolean;\n /* How to reach the source-of-truth's golden images. Required unless\n * `isSourceOfTruthAdapter` is true. /\n sourceOfTruthGolden?: SourceOfTruthGoldenLocation;\n /* Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `\"check\"`. /\n goldenMode: GoldenMode;\n /* Set by the CLI from `--divergence-only`. Defaults to `\"own\"`. */\n checkMode: CheckMode;\n}\n\nexport function defineAdapterTesterConfig(\n config: AdapterTesterConfig,\n): AdapterTesterConfig {\n const sourceOfTruthCount = config.targets.filter(\n (target) => target.sourceOfTruth,\n ).length;\n if (sourceOfTruthCount !== 1) {\n throw new Error(\n `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n );\n }\n return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n if (!sourceOfTruth) {\n throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n }\n return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":"~~uIA0GO~~,SAASA,EACdC,EACqB,CACrB,MAAMC,EAAqBD,EAAO,QAAQ,OACvCE,GAAWA,EAAO,aAAA,EACnB,OACF,GAAID,IAAuB,EACzB,MAAM,IAAI,MACR,8EAA8EA,CAAkB,GAAA,EAGpG,OAAOD,CACT,CAEO,SAASG,EAAiBH,EAA4C,CAC3E,MAAMI,EAAgBJ,EAAO,QAAQ,KAAME,GAAWA,EAAO,aAAa,EAC1E,GAAI,CAACE,EACH,MAAM,IAAI,MAAM,0DAA0D,EAE5E,OAAOA,CACT"}
1	+ {"version":3,"file":"index.cjs","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n /** Human-readable name used in test titles, report labels, and artifact filenames. /\n name: string;\n /* Base URL the target's Storybook instance is served from. /\n url: string;\n /\n Marks this target as the visual/token source of truth every other target\n * is compared against. Exactly one target in a config must set this true.\n /\n sourceOfTruth?: boolean;\n}\n\n/* How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)\n * own golden images, for the divergence check. Never involves booting a\n * Storybook — both `readImage` targets are plain files on disk. /\nexport type SourceOfTruthGoldenLocation =\n \| {\n /* Sibling package already checked out locally (this monorepo's own\n * `sourceOfTruth.type: \"url\"` mode) — read its `test/golden/` directly. /\n type: \"local\";\n /* Absolute path to the source-of-truth adapter's `test/golden/` directory. /\n dir: string;\n }\n \| {\n /* No local checkout (the default, standalone-repo mode) — resolve the\n * installed version against the npm registry, then fetch that git tag's\n * `test/golden/` from the public GitHub repo, caching what's downloaded. /\n type: \"npm\";\n packageName: string;\n /* npm version/dist-tag to resolve, e.g. \"latest\" or a pinned version. /\n versionSpec: string;\n /* Directory downloaded manifest/images are cached in between runs. /\n cacheDir: string;\n };\n\nexport type GoldenMode = \"check\" \| \"update-golden\" \| \"approve-divergence\";\n\n/\n Which check(s) a run performs. `\"own\"` (the default) is what a normal,\n * fast, no-network run does: this project's own live render vs. its own\n * committed golden images. `\"divergence\"` is the separate, opt-in check\n * against the source-of-truth adapter's published golden images.\n /\nexport type CheckMode = \"own\" \| \"divergence\";\n\nexport interface StoryOverride {\n /* Diff threshold override for this story's own-drift check. Overrides\n * `goldenThresholdPixels`. /\n goldenThreshold?: number;\n /* Diff threshold override for this story's source-of-truth divergence\n * check. Overrides `sourceOfTruthThresholdPixels` for components with\n * acceptable cross-library structural variation (e.g. native control\n * widgets). /\n sourceOfTruthThreshold?: number;\n /* Skip this story entirely — no own-drift check, no divergence check, no\n * golden captured. For stories with no meaningful cross-adapter counterpart. /\n exclude?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /* Global pixel-diff threshold for the own-drift check (this project's live\n * render vs. its own committed golden). Same library on both sides, so this\n * should stay tight. /\n goldenThresholdPixels: number;\n /* Global pixel-diff threshold for the source-of-truth divergence check\n * (this project's golden vs. the source-of-truth adapter's golden).\n * Comparing across two different component libraries has legitimate\n * structural variation, so this is expected to be much higher than\n * `goldenThresholdPixels`. Unused on the source-of-truth adapter's own\n * config (`isSourceOfTruthAdapter: true`). /\n sourceOfTruthThresholdPixels: number;\n /\n Per-story overrides, keyed by story id prefix (a story matches if its id\n * equals the key or starts with it). When more than one key matches, the\n * longest (most specific) key wins.\n /\n stories?: Record<string, StoryOverride>;\n /\n Storybook entry title categories excluded from the comparison — an\n * entry is excluded if its title equals one of these or starts with\n * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n * `@recursica/storybook-template`'s own default token/theme demo stories\n * (which every adapter's Storybook inherits automatically) plus each\n * adapter's own onboarding \"Introduction\" stories — neither has a\n * cross-adapter counterpart to diff against.\n /\n excludeTitlePrefixes?: string[];\n /* Absolute path to this project's own `test/golden/` directory — where\n * golden PNGs and `manifest.json` are stored, committed to git. /\n goldenDir: string;\n /\n True only for the source-of-truth adapter's own config (mantine). It has\n * nothing above it to diverge from, so the divergence check is skipped\n * entirely and `sourceOfTruthGolden` is ignored.\n /\n isSourceOfTruthAdapter: boolean;\n /* How to reach the source-of-truth's golden images. Required unless\n * `isSourceOfTruthAdapter` is true. /\n sourceOfTruthGolden?: SourceOfTruthGoldenLocation;\n /* Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `\"check\"`. /\n goldenMode: GoldenMode;\n /* Set by the CLI from `--divergence-only`. Defaults to `\"own\"`. /\n checkMode: CheckMode;\n /* Overrides the AI report header text (normally read from\n * `report-header.txt`) shown in Dev Mode's \"Full Report\" export. */\n reportHeader?: string;\n}\n\nexport function defineAdapterTesterConfig(\n config: AdapterTesterConfig,\n): AdapterTesterConfig {\n const sourceOfTruthCount = config.targets.filter(\n (target) => target.sourceOfTruth,\n ).length;\n if (sourceOfTruthCount !== 1) {\n throw new Error(\n `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n );\n }\n return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n if (!sourceOfTruth) {\n throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n }\n return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":"uIA6GO,SAASA,EACdC,EACqB,CACrB,MAAMC,EAAqBD,EAAO,QAAQ,OACvCE,GAAWA,EAAO,aAAA,EACnB,OACF,GAAID,IAAuB,EACzB,MAAM,IAAI,MACR,8EAA8EA,CAAkB,GAAA,EAGpG,OAAOD,CACT,CAEO,SAASG,EAAiBH,EAA4C,CAC3E,MAAMI,EAAgBJ,EAAO,QAAQ,KAAME,GAAWA,EAAO,aAAa,EAC1E,GAAI,CAACE,EACH,MAAM,IAAI,MAAM,0DAA0D,EAE5E,OAAOA,CACT"}

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n /** Human-readable name used in test titles, report labels, and artifact filenames. /\n name: string;\n /* Base URL the target's Storybook instance is served from. /\n url: string;\n /\n Marks this target as the visual/token source of truth every other target\n * is compared against. Exactly one target in a config must set this true.\n /\n sourceOfTruth?: boolean;\n}\n\n/* How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)\n * own golden images, for the divergence check. Never involves booting a\n * Storybook — both `readImage` targets are plain files on disk. /\nexport type SourceOfTruthGoldenLocation =\n \| {\n /* Sibling package already checked out locally (this monorepo's own\n * `sourceOfTruth.type: \"url\"` mode) — read its `test/golden/` directly. /\n type: \"local\";\n /* Absolute path to the source-of-truth adapter's `test/golden/` directory. /\n dir: string;\n }\n \| {\n /* No local checkout (the default, standalone-repo mode) — resolve the\n * installed version against the npm registry, then fetch that git tag's\n * `test/golden/` from the public GitHub repo, caching what's downloaded. /\n type: \"npm\";\n packageName: string;\n /* npm version/dist-tag to resolve, e.g. \"latest\" or a pinned version. /\n versionSpec: string;\n /* Directory downloaded manifest/images are cached in between runs. /\n cacheDir: string;\n };\n\nexport type GoldenMode = \"check\" \| \"update-golden\" \| \"approve-divergence\";\n\n/\n Which check(s) a run performs. `\"own\"` (the default) is what a normal,\n * fast, no-network run does: this project's own live render vs. its own\n * committed golden images. `\"divergence\"` is the separate, opt-in check\n * against the source-of-truth adapter's published golden images.\n /\nexport type CheckMode = \"own\" \| \"divergence\";\n\nexport interface StoryOverride {\n /* Diff threshold override for this story's own-drift check. Overrides\n * `goldenThresholdPixels`. /\n goldenThreshold?: number;\n /* Diff threshold override for this story's source-of-truth divergence\n * check. Overrides `sourceOfTruthThresholdPixels` for components with\n * acceptable cross-library structural variation (e.g. native control\n * widgets). /\n sourceOfTruthThreshold?: number;\n /* Skip this story entirely — no own-drift check, no divergence check, no\n * golden captured. For stories with no meaningful cross-adapter counterpart. /\n exclude?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /* Global pixel-diff threshold for the own-drift check (this project's live\n * render vs. its own committed golden). Same library on both sides, so this\n * should stay tight. /\n goldenThresholdPixels: number;\n /* Global pixel-diff threshold for the source-of-truth divergence check\n * (this project's golden vs. the source-of-truth adapter's golden).\n * Comparing across two different component libraries has legitimate\n * structural variation, so this is expected to be much higher than\n * `goldenThresholdPixels`. Unused on the source-of-truth adapter's own\n * config (`isSourceOfTruthAdapter: true`). /\n sourceOfTruthThresholdPixels: number;\n /\n Per-story overrides, keyed by story id prefix (a story matches if its id\n * equals the key or starts with it). When more than one key matches, the\n * longest (most specific) key wins.\n /\n stories?: Record<string, StoryOverride>;\n /\n Storybook entry title categories excluded from the comparison — an\n * entry is excluded if its title equals one of these or starts with\n * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n * `@recursica/storybook-template`'s own default token/theme demo stories\n * (which every adapter's Storybook inherits automatically) plus each\n * adapter's own onboarding \"Introduction\" stories — neither has a\n * cross-adapter counterpart to diff against.\n /\n excludeTitlePrefixes?: string[];\n /* Absolute path to this project's own `test/golden/` directory — where\n * golden PNGs and `manifest.json` are stored, committed to git. /\n goldenDir: string;\n /\n True only for the source-of-truth adapter's own config (mantine). It has\n * nothing above it to diverge from, so the divergence check is skipped\n * entirely and `sourceOfTruthGolden` is ignored.\n /\n isSourceOfTruthAdapter: boolean;\n /* How to reach the source-of-truth's golden images. Required unless\n * `isSourceOfTruthAdapter` is true. /\n sourceOfTruthGolden?: SourceOfTruthGoldenLocation;\n /* Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `\"check\"`. /\n goldenMode: GoldenMode;\n /* Set by the CLI from `--divergence-only`. Defaults to `\"own\"`. */\n checkMode: CheckMode;\n}\n\nexport function defineAdapterTesterConfig(\n config: AdapterTesterConfig,\n): AdapterTesterConfig {\n const sourceOfTruthCount = config.targets.filter(\n (target) => target.sourceOfTruth,\n ).length;\n if (sourceOfTruthCount !== 1) {\n throw new Error(\n `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n );\n }\n return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n if (!sourceOfTruth) {\n throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n }\n return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":";~~AA0GO~~,SAASA,EACdC,GACqB;AACrB,QAAMC,IAAqBD,EAAO,QAAQ;AAAA,IACxC,CAACE,MAAWA,EAAO;AAAA,EAAA,EACnB;AACF,MAAID,MAAuB;AACzB,UAAM,IAAI;AAAA,MACR,8EAA8EA,CAAkB;AAAA,IAAA;AAGpG,SAAOD;AACT;AAEO,SAASG,EAAiBH,GAA4C;AAC3E,QAAMI,IAAgBJ,EAAO,QAAQ,KAAK,CAACE,MAAWA,EAAO,aAAa;AAC1E,MAAI,CAACE;AACH,UAAM,IAAI,MAAM,0DAA0D;AAE5E,SAAOA;AACT;"}
1	+ {"version":3,"file":"index.js","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n /** Human-readable name used in test titles, report labels, and artifact filenames. /\n name: string;\n /* Base URL the target's Storybook instance is served from. /\n url: string;\n /\n Marks this target as the visual/token source of truth every other target\n * is compared against. Exactly one target in a config must set this true.\n /\n sourceOfTruth?: boolean;\n}\n\n/* How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)\n * own golden images, for the divergence check. Never involves booting a\n * Storybook — both `readImage` targets are plain files on disk. /\nexport type SourceOfTruthGoldenLocation =\n \| {\n /* Sibling package already checked out locally (this monorepo's own\n * `sourceOfTruth.type: \"url\"` mode) — read its `test/golden/` directly. /\n type: \"local\";\n /* Absolute path to the source-of-truth adapter's `test/golden/` directory. /\n dir: string;\n }\n \| {\n /* No local checkout (the default, standalone-repo mode) — resolve the\n * installed version against the npm registry, then fetch that git tag's\n * `test/golden/` from the public GitHub repo, caching what's downloaded. /\n type: \"npm\";\n packageName: string;\n /* npm version/dist-tag to resolve, e.g. \"latest\" or a pinned version. /\n versionSpec: string;\n /* Directory downloaded manifest/images are cached in between runs. /\n cacheDir: string;\n };\n\nexport type GoldenMode = \"check\" \| \"update-golden\" \| \"approve-divergence\";\n\n/\n Which check(s) a run performs. `\"own\"` (the default) is what a normal,\n * fast, no-network run does: this project's own live render vs. its own\n * committed golden images. `\"divergence\"` is the separate, opt-in check\n * against the source-of-truth adapter's published golden images.\n /\nexport type CheckMode = \"own\" \| \"divergence\";\n\nexport interface StoryOverride {\n /* Diff threshold override for this story's own-drift check. Overrides\n * `goldenThresholdPixels`. /\n goldenThreshold?: number;\n /* Diff threshold override for this story's source-of-truth divergence\n * check. Overrides `sourceOfTruthThresholdPixels` for components with\n * acceptable cross-library structural variation (e.g. native control\n * widgets). /\n sourceOfTruthThreshold?: number;\n /* Skip this story entirely — no own-drift check, no divergence check, no\n * golden captured. For stories with no meaningful cross-adapter counterpart. /\n exclude?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /* Global pixel-diff threshold for the own-drift check (this project's live\n * render vs. its own committed golden). Same library on both sides, so this\n * should stay tight. /\n goldenThresholdPixels: number;\n /* Global pixel-diff threshold for the source-of-truth divergence check\n * (this project's golden vs. the source-of-truth adapter's golden).\n * Comparing across two different component libraries has legitimate\n * structural variation, so this is expected to be much higher than\n * `goldenThresholdPixels`. Unused on the source-of-truth adapter's own\n * config (`isSourceOfTruthAdapter: true`). /\n sourceOfTruthThresholdPixels: number;\n /\n Per-story overrides, keyed by story id prefix (a story matches if its id\n * equals the key or starts with it). When more than one key matches, the\n * longest (most specific) key wins.\n /\n stories?: Record<string, StoryOverride>;\n /\n Storybook entry title categories excluded from the comparison — an\n * entry is excluded if its title equals one of these or starts with\n * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n * `@recursica/storybook-template`'s own default token/theme demo stories\n * (which every adapter's Storybook inherits automatically) plus each\n * adapter's own onboarding \"Introduction\" stories — neither has a\n * cross-adapter counterpart to diff against.\n /\n excludeTitlePrefixes?: string[];\n /* Absolute path to this project's own `test/golden/` directory — where\n * golden PNGs and `manifest.json` are stored, committed to git. /\n goldenDir: string;\n /\n True only for the source-of-truth adapter's own config (mantine). It has\n * nothing above it to diverge from, so the divergence check is skipped\n * entirely and `sourceOfTruthGolden` is ignored.\n /\n isSourceOfTruthAdapter: boolean;\n /* How to reach the source-of-truth's golden images. Required unless\n * `isSourceOfTruthAdapter` is true. /\n sourceOfTruthGolden?: SourceOfTruthGoldenLocation;\n /* Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `\"check\"`. /\n goldenMode: GoldenMode;\n /* Set by the CLI from `--divergence-only`. Defaults to `\"own\"`. /\n checkMode: CheckMode;\n /* Overrides the AI report header text (normally read from\n * `report-header.txt`) shown in Dev Mode's \"Full Report\" export. */\n reportHeader?: string;\n}\n\nexport function defineAdapterTesterConfig(\n config: AdapterTesterConfig,\n): AdapterTesterConfig {\n const sourceOfTruthCount = config.targets.filter(\n (target) => target.sourceOfTruth,\n ).length;\n if (sourceOfTruthCount !== 1) {\n throw new Error(\n `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n );\n }\n return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n if (!sourceOfTruth) {\n throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n }\n return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":";AA6GO,SAASA,EACdC,GACqB;AACrB,QAAMC,IAAqBD,EAAO,QAAQ;AAAA,IACxC,CAACE,MAAWA,EAAO;AAAA,EAAA,EACnB;AACF,MAAID,MAAuB;AACzB,UAAM,IAAI;AAAA,MACR,8EAA8EA,CAAkB;AAAA,IAAA;AAGpG,SAAOD;AACT;AAEO,SAASG,EAAiBH,GAA4C;AAC3E,QAAMI,IAAgBJ,EAAO,QAAQ,KAAK,CAACE,MAAWA,EAAO,aAAa;AAC1E,MAAI,CAACE;AACH,UAAM,IAAI,MAAM,0DAA0D;AAE5E,SAAOA;AACT;"}

package/dist/testing/runVisualRegression.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"runVisualRegression.d.ts","sourceRoot":"","sources":["../../src/testing/runVisualRegression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAcxD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAmED;;;;wEAIwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;+EAG2E;IAC3E,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC;;;;uDAImD;IACnD,UAAU,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;wEAIwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;;uDAImD;IACnD,UAAU,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,~~CA2P~~/B"}
1	+ {"version":3,"file":"runVisualRegression.d.ts","sourceRoot":"","sources":["../../src/testing/runVisualRegression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAcxD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAmED;;;;wEAIwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;+EAG2E;IAC3E,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC;;;;uDAImD;IACnD,UAAU,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;wEAIwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;;uDAImD;IACnD,UAAU,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CA8P/B"}