@recursica/adapter-tester 2.2.0 → 4.0.0

package/dist/testing.js

@@ -1,171 +1,327 @@
-import { test as x, expect as U } from "@playwright/test";
-import z from "pixelmatch";
-import { PNG as m } from "pngjs";
-import w from "node:fs";
-import { g as I } from "./config-CDxTeSAY.js";
-const R = ["Theme", "Tokens", "Introduction"], E = [
-  "color",
-  "background-color",
-  "padding-top",
-  "padding-right",
-  "padding-bottom",
-  "padding-left",
-  "margin-top",
-  "margin-right",
-  "margin-bottom",
-  "margin-left",
-  "border-top-left-radius",
-  "border-top-right-radius",
-  "border-bottom-left-radius",
-  "border-bottom-right-radius",
-  "font-size",
-  "font-weight",
-  "display",
-  "flex-direction",
-  "gap",
-  "height"
-];
-function C(t) {
-  return t.toLowerCase().replace(/[^a-z0-9]+/g, "-");
-}
-async function A(t, e) {
-  let s;
+import { expect as K } from "@playwright/test";
+import { existsSync as g, unlinkSync as J, readFileSync as $, mkdirSync as x, writeFileSync as P, closeSync as V, openSync as W, renameSync as X, rmSync as q } from "node:fs";
+import H from "pixelmatch";
+import { PNG as S } from "pngjs";
+import { join as E } from "node:path";
+import { a as z, i as Y } from "./index-DqQzFSAH.js";
+function N(e, t) {
+  const n = S.sync.read(e), r = S.sync.read(t);
+  if (n.width !== r.width || n.height !== r.height)
+    return { diffPixels: 1 / 0, diffImage: null };
+  const o = new S({ width: n.width, height: n.height });
+  return { diffPixels: H(
+    n.data,
+    r.data,
+    o.data,
+    n.width,
+    n.height,
+    { threshold: 0.1 }
+  ), diffImage: S.sync.write(o) };
+}
+const Q = "http://json-schema.org/draft-07/schema#", Z = "https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/golden/manifest.schema.json", ee = "test/golden/manifest.json", te = "Tracks golden (baseline) image metadata for @recursica/adapter-tester's golden-image visual regression checks. One manifest lives alongside its adapter's test/golden/<story-id>.png files, keyed by story id.", re = "object", ne = { type: "object", additionalProperties: !1, required: ["createdAt"], properties: { createdAt: { type: "string", format: "date-time", description: "When this story's own golden PNG was last captured, via --update-golden, --approve-divergence, or first-run auto-create." }, sourceOfTruthCreatedAt: { type: "string", format: "date-time", description: "The source-of-truth adapter's (mantine) manifest `createdAt` for this story at the time this adapter's divergence from it was last reviewed via --approve-divergence. Omitted on the source-of-truth adapter's own manifest, and omitted here until the first approval. If mantine's current `createdAt` for this story is newer than this value, the divergence is flagged again for re-review." } } }, oe = {
+  $schema: Q,
+  $id: Z,
+  title: ee,
+  description: te,
+  type: re,
+  additionalProperties: ne
+}, se = Y, B = new z.Ajv({ allErrors: !0, strict: !0 });
+se(B);
+const L = B.compile(oe);
+function M(e, t) {
+  if (L(e)) return;
+  const n = (L.errors ?? []).map((r) => {
+    var a;
+    const o = (a = r.params) != null && a.additionalProperty ? ` '${r.params.additionalProperty}'` : "";
+    return `  - ${r.instancePath || "root"} ${r.message}${o}`;
+  }).join(`
+`);
+  throw new Error(`Invalid ${t}:
+${n}`);
+}
+function j(e) {
+  return E(e, "manifest.json");
+}
+function F(e) {
+  return E(e, "manifest.json.lock");
+}
+function O(e, t) {
+  return E(e, `${t}.png`);
+}
+function b(e) {
+  const t = j(e);
+  if (!g(t)) return {};
+  const n = JSON.parse($(t, "utf8"));
+  return M(n, t), n;
+}
+function ie(e, t) {
+  const n = j(e);
+  M(t, n);
+  const r = {};
+  for (const a of Object.keys(t).sort())
+    r[a] = t[a];
+  x(e, { recursive: !0 });
+  const o = `${n}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;
+  P(o, JSON.stringify(r, null, 2) + `
+`), X(o, n);
+}
+const ae = 25, ce = 15e3;
+function de(e) {
+  return new Promise((t) => setTimeout(t, e));
+}
+async function ue(e) {
+  x(e, { recursive: !0 });
+  const t = F(e), n = Date.now() + ce;
+  for (; ; )
+    try {
+      V(W(t, "wx"));
+      return;
+    } catch (r) {
+      if (r.code !== "EEXIST") throw r;
+      if (Date.now() >= n)
+        throw new Error(
+          `Timed out waiting for the manifest lock at "${t}" — delete it if a previous run crashed while holding it.`
+        );
+      await de(ae);
+    }
+}
+function fe(e) {
+  q(F(e), { force: !0 });
+}
+async function _(e, t, n) {
+  await ue(e);
+  try {
+    const r = b(e), o = n(r[t]);
+    return o === void 0 ? delete r[t] : r[t] = o, ie(e, r), o;
+  } finally {
+    fe(e);
+  }
+}
+function he(e, t, n) {
+  x(e, { recursive: !0 }), P(O(e, t), n);
+}
+async function le(e, t) {
+  const n = b(e), r = Object.keys(n).filter(
+    (o) => !t.has(o)
+  );
+  for (const o of r) {
+    const a = O(e, o);
+    g(a) && J(a), await _(e, o, () => {
+    });
+  }
+  return r;
+}
+const pe = "borderux/recursica";
+async function me(e, t) {
+  var a, d;
+  const n = await fetch(`https://registry.npmjs.org/${e}`);
+  if (!n.ok)
+    throw new Error(
+      `Could not reach npm registry for ${e}: ${n.statusText}`
+    );
+  const r = await n.json(), o = ((a = r["dist-tags"]) == null ? void 0 : a[t]) ?? ((d = r.versions) != null && d[t] ? t : void 0);
+  if (!o)
+    throw new Error(
+      `${e} has no version or dist-tag "${t}" on the npm registry.`
+    );
+  return o;
+}
+function ge(e) {
+  return `packages/${e.split("/").pop()}`;
+}
+async function we(e) {
+  if (e.type === "local")
+    return g(j(e.dir)) ? {
+      manifest: b(e.dir),
+      async readImage(c) {
+        const u = O(e.dir, c);
+        return g(u) ? $(u) : null;
+      }
+    } : (console.warn(
+      `No golden baseline found yet at ${e.dir} — source-of-truth divergence check skipped for this run.`
+    ), null);
+  let t;
   try {
-    const i = await fetch(`${t.url}/index.json`);
+    t = await me(
+      e.packageName,
+      e.versionSpec
+    );
+  } catch (i) {
+    return console.warn(
+      `Could not resolve ${e.packageName}@${e.versionSpec} — source-of-truth divergence check skipped for this run.`,
+      i
+    ), null;
+  }
+  const n = E(e.cacheDir, t), r = `${e.packageName}@${t}`, o = `https://raw.githubusercontent.com/${pe}/${r}/${ge(e.packageName)}/test/golden`;
+  let a;
+  const d = j(n);
+  if (g(d))
+    a = b(n);
+  else {
+    let i;
+    try {
+      i = await fetch(`${o}/manifest.json`);
+    } catch (f) {
+      return console.warn(
+        `Could not reach GitHub to fetch ${r}'s golden baseline — source-of-truth divergence check skipped for this run.`,
+        f
+      ), null;
+    }
     if (!i.ok)
+      return console.warn(
+        `No golden baseline published for ${r} — source-of-truth divergence check skipped for this run.`
+      ), null;
+    const c = await i.text(), u = JSON.parse(c);
+    M(u, `${o}/manifest.json`), x(n, { recursive: !0 }), P(d, c), a = u;
+  }
+  return {
+    manifest: a,
+    async readImage(i) {
+      const c = O(n, i);
+      if (g(c)) return $(c);
+      const u = await fetch(`${o}/${i}.png`);
+      if (!u.ok) return null;
+      const f = Buffer.from(await u.arrayBuffer());
+      return x(n, { recursive: !0 }), P(c, f), f;
+    }
+  };
+}
+const ye = ["Theme", "Tokens", "Introduction"];
+function D(e, t) {
+  return e === t || e.startsWith(t);
+}
+async function ve(e, t, n) {
+  let r;
+  try {
+    const o = await fetch(`${e.url}/index.json`);
+    if (!o.ok)
       throw new Error(
-        `Failed to fetch Storybook index: ${i.statusText}`
+        `Failed to fetch Storybook index: ${o.statusText}`
       );
-    const a = (await i.json()).entries || {};
-    s = Object.values(a).filter(
-      (n) => n.type === "story" && !e.some(
-        (d) => n.title === d || n.title.startsWith(`${d}/`)
-      )
-    ), s.sort((n, d) => n.id.localeCompare(d.id));
-  } catch (i) {
+    const d = (await o.json()).entries || {};
+    r = Object.values(d).filter(
+      (i) => i.type === "story" && !t.some(
+        (c) => i.title === c || i.title.startsWith(`${c}/`)
+      ) && !n.some((c) => D(i.id, c))
+    ), r.sort((i, c) => i.id.localeCompare(c.id));
+  } catch (o) {
     throw console.error(
       "Failed to load Storybook index from",
-      `${t.url}/index.json`,
-      i
+      `${e.url}/index.json`,
+      o
     ), new Error(
-      `Storybook source of truth "${t.name}" is not responsive or index.json is missing. Please ensure its Storybook is running.`
+      `Storybook target "${e.name}" is not responsive or index.json is missing. Please ensure its Storybook is running.`
     );
   }
-  return s;
+  return r;
 }
-async function B(t) {
-  try {
-    const e = await fetch(`${t.url}/index.json`);
-    if (!e.ok)
-      return console.warn(
-        `Could not load Storybook index from target "${t.name}" (${e.status} ${e.statusText}) — every story will be reported as skipped for this target.`
-      ), /* @__PURE__ */ new Set();
-    const i = (await e.json()).entries || {}, g = Object.values(i).filter((a) => a.type === "story").map((a) => a.id);
-    return new Set(g);
-  } catch (e) {
-    return console.warn(
-      `Could not load Storybook index from target "${t.name}" — every story will be reported as skipped for this target.`,
-      e
-    ), /* @__PURE__ */ new Set();
-  }
+function ke(e, t, n) {
+  let r;
+  for (const o of Object.keys(t))
+    D(e, o) && (!r || o.length > r.length) && (r = o);
+  return r !== void 0 ? t[r] : n;
 }
-async function H(t) {
-  const e = I(t), s = t.targets.filter((r) => !r.sourceOfTruth), i = t.excludeTitlePrefixes ?? R, g = t.relaxedThresholdStoryIds ?? [], a = t.relaxedThresholdPixels, n = await A(e, i), d = /* @__PURE__ */ new Map();
-  for (const r of s)
-    d.set(r.name, await B(r));
-  for (const r of s) {
-    const N = d.get(r.name) ?? /* @__PURE__ */ new Set();
-    x.describe(`${e.name} vs ${r.name} — Dynamic Visual Regression Suite`, () => {
-      for (const o of n)
-        x(`Visual regression for: ${o.title} - ${o.name} (${o.id})`, async ({
-          browser: O
-        }, h) => {
-          x.skip(
-            !N.has(o.id),
-            `${r.name} has no story with id "${o.id}" yet — not yet implemented, not a failure.`
-          );
-          const c = await O.newPage(), l = await O.newPage();
-          await c.setViewportSize({ width: 800, height: 600 }), await l.setViewportSize({ width: 800, height: 600 }), await Promise.all([
-            c.goto(
-              `${e.url}/iframe.html?id=${o.id}&viewMode=story`,
-              { waitUntil: "networkidle" }
-            ),
-            l.goto(
-              `${r.url}/iframe.html?id=${o.id}&viewMode=story`,
-              { waitUntil: "networkidle" }
-            )
-          ]), await Promise.all([
-            c.waitForSelector("#storybook-root"),
-            l.waitForSelector("#storybook-root")
-          ]), await Promise.all([
-            c.waitForTimeout(300),
-            l.waitForTimeout(300)
-          ]);
-          const k = ($) => {
-            function M(T) {
-              const b = {
-                tag: T.tagName.toLowerCase(),
-                styles: {},
-                children: []
-              }, _ = window.getComputedStyle(T);
-              for (const y of $)
-                b.styles[y] = _.getPropertyValue(y);
-              for (const y of Array.from(T.children))
-                b.children.push(M(y));
-              return b;
-            }
-            const D = document.querySelector("#storybook-root");
-            return D ? M(D) : null;
-          }, P = await c.evaluate(
-            k,
-            E
-          ), F = await l.evaluate(
-            k,
-            E
-          );
-          await h.attach(`${e.name} DOM Tree JSON`, {
-            body: JSON.stringify(P, null, 2),
-            contentType: "application/json"
-          }), await h.attach(`${r.name} DOM Tree JSON`, {
-            body: JSON.stringify(F, null, 2),
-            contentType: "application/json"
-          });
-          const j = C(e.name), v = C(r.name);
-          w.writeFileSync(
-            `/tmp/${o.id}-${j}DOM.json`,
-            JSON.stringify(P, null, 2)
-          ), w.writeFileSync(
-            `/tmp/${o.id}-${v}DOM.json`,
-            JSON.stringify(F, null, 2)
-          );
-          const f = await c.screenshot(), p = await l.screenshot(), u = m.sync.read(f), L = m.sync.read(p), S = new m({ width: u.width, height: u.height }), V = z(
-            u.data,
-            L.data,
-            S.data,
-            u.width,
-            u.height,
-            { threshold: 0.1 }
-          );
-          w.writeFileSync(`/tmp/${o.id}-diff.png`, m.sync.write(S)), w.writeFileSync(`/tmp/${o.id}-${j}.png`, f), w.writeFileSync(`/tmp/${o.id}-${v}.png`, p), await h.attach("Visual Diff Overlay", {
-            body: m.sync.write(S),
-            contentType: "image/png"
-          }), await h.attach(
-            `${e.name} Screenshot (Source of Truth)`,
-            {
-              body: f,
-              contentType: "image/png"
-            }
-          ), await h.attach(`${r.name} Screenshot (Target)`, {
-            body: p,
-            contentType: "image/png"
-          });
-          const J = a !== void 0 && g.some(($) => o.id.startsWith($)) ? a : t.diffThresholdPixels;
-          U.soft(V).toBeLessThan(J);
-        });
-    });
+async function je(e) {
+  const t = e.isSourceOfTruthAdapter ? e.targets[0] : e.targets.find((s) => !s.sourceOfTruth);
+  if (!t)
+    throw new Error(
+      "adapter-tester config has no non-sourceOfTruth target to run the golden check against."
+    );
+  const n = e.excludeTitlePrefixes ?? ye, r = e.stories ?? {}, o = Object.keys(r).filter(
+    (s) => r[s].exclude
+  ), a = Object.fromEntries(
+    Object.entries(r).filter(([, s]) => s.threshold !== void 0).map(([s, y]) => [s, y.threshold])
+  ), d = e.goldenDir, i = e.goldenMode, c = e.checkMode, u = await ve(
+    t,
+    n,
+    o
+  );
+  if (i === "update-golden") {
+    const s = await le(
+      d,
+      new Set(u.map((y) => y.id))
+    );
+    s.length > 0 && console.warn(
+      `Pruned ${s.length} orphaned golden(s) no longer in Storybook: ${s.join(", ")}`
+    );
   }
+  const f = c !== "divergence" || e.isSourceOfTruthAdapter || !e.sourceOfTruthGolden ? null : await we(e.sourceOfTruthGolden), R = c === "divergence" ? "Source-of-Truth Divergence Check" : "Own-Drift Golden Image Check";
+  return {
+    ownTargetName: t.name,
+    suiteLabel: R,
+    stories: u,
+    checkStory: async (s, y, h) => {
+      const v = await y.newPage();
+      await v.setViewportSize({ width: 800, height: 600 }), await v.goto(
+        `${t.url}/iframe.html?id=${s.id}&viewMode=story`,
+        { waitUntil: "networkidle" }
+      ), await v.waitForSelector("#storybook-root"), await v.waitForTimeout(300);
+      const A = await v.screenshot(), I = O(d, s.id), l = b(d)[s.id], U = i !== "check" || !l || !g(I);
+      let w;
+      if (U)
+        he(d, s.id, A), w = l != null && l.sourceOfTruthCreatedAt ? {
+          createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+          sourceOfTruthCreatedAt: l.sourceOfTruthCreatedAt
+        } : { createdAt: (/* @__PURE__ */ new Date()).toISOString() }, l || h.annotations.push({
+          type: "golden-created",
+          description: `No golden existed yet for "${s.id}" — captured one from this run.`
+        });
+      else if (w = l, c === "own") {
+        const p = $(I), { diffPixels: m, diffImage: k } = N(
+          A,
+          p
+        ), T = ke(
+          s.id,
+          a,
+          e.diffThresholdPixels
+        );
+        m >= T && (await h.attach("expected", {
+          body: p,
+          contentType: "image/png"
+        }), await h.attach("actual", {
+          body: A,
+          contentType: "image/png"
+        }), k && await h.attach("diff", {
+          body: k,
+          contentType: "image/png"
+        })), K.soft(
+          m,
+          `"${s.id}" has drifted from its own golden image (${m} mismatched pixels, threshold ${T})`
+        ).toBeLessThan(T);
+      }
+      if (f) {
+        const p = f.manifest[s.id], m = p ? await f.readImage(s.id) : null;
+        if (p && m)
+          if (i === "approve-divergence")
+            w = {
+              ...w,
+              sourceOfTruthCreatedAt: p.createdAt
+            };
+          else {
+            const k = $(I), { diffPixels: T, diffImage: C } = N(
+              k,
+              m
+            ), G = w.sourceOfTruthCreatedAt;
+            T === 0 || G !== void 0 && G >= p.createdAt || (await h.attach("expected", {
+              body: m,
+              contentType: "image/png"
+            }), await h.attach("actual", {
+              body: k,
+              contentType: "image/png"
+            }), C && await h.attach("diff", {
+              body: C,
+              contentType: "image/png"
+            }), h.annotations.push({
+              type: "source-of-truth-divergence",
+              description: `"${s.id}" differs from the source of truth's golden and hasn't been reviewed — run with --approve-divergence if this is intentional, or fix the adapter styling.`
+            }));
+          }
+      }
+      await _(d, s.id, () => w);
+    }
+  };
 }
 export {
-  H as runVisualRegression
+  je as resolveVisualRegressionPlan
 };
 //# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sources":["../src/testing/runVisualRegression.ts"],"sourcesContent":["import { test, expect } from \"@playwright/test\";\nimport pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\nimport fs from \"node:fs\";\nimport type { AdapterTarget, AdapterTesterConfig } from \"../config.js\";\nimport { getSourceOfTruth } from \"../config.js\";\n\nconst DEFAULT_EXCLUDE_TITLE_PREFIXES = [\"Theme\", \"Tokens\", \"Introduction\"];\n\nconst COMMON_STYLES_TO_CAPTURE = [\n  \"color\",\n  \"background-color\",\n  \"padding-top\",\n  \"padding-right\",\n  \"padding-bottom\",\n  \"padding-left\",\n  \"margin-top\",\n  \"margin-right\",\n  \"margin-bottom\",\n  \"margin-left\",\n  \"border-top-left-radius\",\n  \"border-top-right-radius\",\n  \"border-bottom-left-radius\",\n  \"border-bottom-right-radius\",\n  \"font-size\",\n  \"font-weight\",\n  \"display\",\n  \"flex-direction\",\n  \"gap\",\n  \"height\",\n];\n\ninterface StorybookEntry {\n  type: string;\n  id: string;\n  name: string;\n  title: string;\n}\n\nfunction slug(name: string): string {\n  return name.toLowerCase().replace(/[^a-z0-9]+/g, \"-\");\n}\n\nasync function fetchStories(\n  sourceOfTruth: AdapterTarget,\n  excludeTitlePrefixes: string[],\n): Promise<StorybookEntry[]> {\n  let stories: StorybookEntry[];\n  try {\n    const response = await fetch(`${sourceOfTruth.url}/index.json`);\n    if (!response.ok) {\n      throw new Error(\n        `Failed to fetch Storybook index: ${response.statusText}`,\n      );\n    }\n    const data = (await response.json()) as any;\n    const entries = data.entries || {};\n    stories = Object.values(entries).filter(\n      (entry: any) =>\n        entry.type === \"story\" &&\n        !excludeTitlePrefixes.some(\n          (prefix) =>\n            entry.title === prefix || entry.title.startsWith(`${prefix}/`),\n        ),\n    ) as StorybookEntry[];\n    stories.sort((a, b) => a.id.localeCompare(b.id));\n  } catch (error) {\n    console.error(\n      \"Failed to load Storybook index from\",\n      `${sourceOfTruth.url}/index.json`,\n      error,\n    );\n    throw new Error(\n      `Storybook source of truth \"${sourceOfTruth.name}\" is not responsive or index.json is missing. Please ensure its Storybook is running.`,\n    );\n  }\n  return stories;\n}\n\n/**\n * Fetches just the set of story ids a target's own Storybook actually has —\n * used to skip a comparison up front rather than let it burn the full\n * per-test timeout navigating to a story id the target doesn't implement\n * yet. A target with a partially-built component set (a fresh adapter with\n * a handful of real components and many still-stub ones, for example) is\n * the normal case, not an error, so a failed/empty fetch here degrades to\n * \"assume nothing exists yet\" (every story against this target gets\n * skipped) rather than throwing — unlike `fetchStories` above, where the\n * source of truth being unreachable really is fatal to the whole run.\n */\nasync function fetchTargetStoryIds(target: AdapterTarget): Promise<Set<string>> {\n  try {\n    const response = await fetch(`${target.url}/index.json`);\n    if (!response.ok) {\n      console.warn(\n        `Could not load Storybook index from target \"${target.name}\" (${response.status} ${response.statusText}) — every story will be reported as skipped for this target.`,\n      );\n      return new Set();\n    }\n    const data = (await response.json()) as any;\n    const entries = data.entries || {};\n    const ids = Object.values(entries)\n      .filter((entry: any) => entry.type === \"story\")\n      .map((entry: any) => entry.id as string);\n    return new Set(ids);\n  } catch (error) {\n    console.warn(\n      `Could not load Storybook index from target \"${target.name}\" — every story will be reported as skipped for this target.`,\n      error,\n    );\n    return new Set();\n  }\n}\n\n/**\n * Defines a Playwright suite that diffs every target in `config.targets`\n * against `config.targets`' single `sourceOfTruth` entry, story by story.\n * Call this with a top-level `await` from a Playwright `*.spec.ts` file — it\n * calls `test.describe` at module scope, so it must run inside Playwright's\n * test runner during test-graph compilation.\n */\nexport async function runVisualRegression(\n  config: AdapterTesterConfig,\n): Promise<void> {\n  const sourceOfTruth = getSourceOfTruth(config);\n  const targets = config.targets.filter((target) => !target.sourceOfTruth);\n  const excludeTitlePrefixes =\n    config.excludeTitlePrefixes ?? DEFAULT_EXCLUDE_TITLE_PREFIXES;\n  const relaxedThresholdStoryIds = config.relaxedThresholdStoryIds ?? [];\n  const relaxedThresholdPixels = config.relaxedThresholdPixels;\n\n  // Fetched once at test-graph compilation time and shared by every target's\n  // describe block below.\n  const stories = await fetchStories(sourceOfTruth, excludeTitlePrefixes);\n\n  // One index fetch per target, not per story — a fresh/partially-built adapter is expected to\n  // be missing most of the source of truth's stories, and each miss should be a cheap, fast\n  // skip rather than a full-timeout navigation to a story id that will never resolve.\n  const targetStoryIds = new Map<string, Set<string>>();\n  for (const target of targets) {\n    targetStoryIds.set(target.name, await fetchTargetStoryIds(target));\n  }\n\n  for (const target of targets) {\n    const storyIds = targetStoryIds.get(target.name) ?? new Set<string>();\n    test.describe(`${sourceOfTruth.name} vs ${target.name} — Dynamic Visual Regression Suite`, () => {\n      for (const story of stories) {\n        test(`Visual regression for: ${story.title} - ${story.name} (${story.id})`, async ({\n          browser,\n        }, testInfo) => {\n          test.skip(\n            !storyIds.has(story.id),\n            `${target.name} has no story with id \"${story.id}\" yet — not yet implemented, not a failure.`,\n          );\n\n          const sourcePage = await browser.newPage();\n          const targetPage = await browser.newPage();\n\n          await sourcePage.setViewportSize({ width: 800, height: 600 });\n          await targetPage.setViewportSize({ width: 800, height: 600 });\n\n          await Promise.all([\n            sourcePage.goto(\n              `${sourceOfTruth.url}/iframe.html?id=${story.id}&viewMode=story`,\n              { waitUntil: \"networkidle\" },\n            ),\n            targetPage.goto(\n              `${target.url}/iframe.html?id=${story.id}&viewMode=story`,\n              { waitUntil: \"networkidle\" },\n            ),\n          ]);\n\n          await Promise.all([\n            sourcePage.waitForSelector(\"#storybook-root\"),\n            targetPage.waitForSelector(\"#storybook-root\"),\n          ]);\n\n          await Promise.all([\n            sourcePage.waitForTimeout(300),\n            targetPage.waitForTimeout(300),\n          ]);\n\n          // 1. EXTRACT DOM STRUCTURE AND STYLES\n          const extractFn = (stylesToCapture: string[]) => {\n            function crawl(el: Element): any {\n              const data: any = {\n                tag: el.tagName.toLowerCase(),\n                styles: {},\n                children: [],\n              };\n              const computed = window.getComputedStyle(el);\n              for (const prop of stylesToCapture) {\n                data.styles[prop] = computed.getPropertyValue(prop);\n              }\n              for (const child of Array.from(el.children)) {\n                data.children.push(crawl(child));\n              }\n              return data;\n            }\n            const root = document.querySelector(\"#storybook-root\");\n            return root ? crawl(root) : null;\n          };\n\n          const sourceDOM = await sourcePage.evaluate(\n            extractFn,\n            COMMON_STYLES_TO_CAPTURE,\n          );\n          const targetDOM = await targetPage.evaluate(\n            extractFn,\n            COMMON_STYLES_TO_CAPTURE,\n          );\n\n          await testInfo.attach(`${sourceOfTruth.name} DOM Tree JSON`, {\n            body: JSON.stringify(sourceDOM, null, 2),\n            contentType: \"application/json\",\n          });\n          await testInfo.attach(`${target.name} DOM Tree JSON`, {\n            body: JSON.stringify(targetDOM, null, 2),\n            contentType: \"application/json\",\n          });\n\n          const sourceSlug = slug(sourceOfTruth.name);\n          const targetSlug = slug(target.name);\n          fs.writeFileSync(\n            `/tmp/${story.id}-${sourceSlug}DOM.json`,\n            JSON.stringify(sourceDOM, null, 2),\n          );\n          fs.writeFileSync(\n            `/tmp/${story.id}-${targetSlug}DOM.json`,\n            JSON.stringify(targetDOM, null, 2),\n          );\n\n          // 2. CAPTURE Headless Viewport Screenshots\n          const sourceBuffer = await sourcePage.screenshot();\n          const targetBuffer = await targetPage.screenshot();\n\n          // 3. PIXEL-BY-PIXEL COMPARISON\n          const img1 = PNG.sync.read(sourceBuffer);\n          const img2 = PNG.sync.read(targetBuffer);\n          const diff = new PNG({ width: img1.width, height: img1.height });\n\n          const diffPixels = pixelmatch(\n            img1.data,\n            img2.data,\n            diff.data,\n            img1.width,\n            img1.height,\n            { threshold: 0.1 },\n          );\n\n          fs.writeFileSync(`/tmp/${story.id}-diff.png`, PNG.sync.write(diff));\n          fs.writeFileSync(`/tmp/${story.id}-${sourceSlug}.png`, sourceBuffer);\n          fs.writeFileSync(`/tmp/${story.id}-${targetSlug}.png`, targetBuffer);\n\n          await testInfo.attach(\"Visual Diff Overlay\", {\n            body: PNG.sync.write(diff),\n            contentType: \"image/png\",\n          });\n          await testInfo.attach(\n            `${sourceOfTruth.name} Screenshot (Source of Truth)`,\n            {\n              body: sourceBuffer,\n              contentType: \"image/png\",\n            },\n          );\n          await testInfo.attach(`${target.name} Screenshot (Target)`, {\n            body: targetBuffer,\n            contentType: \"image/png\",\n          });\n\n          const threshold =\n            relaxedThresholdPixels !== undefined &&\n            relaxedThresholdStoryIds.some((id) => story.id.startsWith(id))\n              ? relaxedThresholdPixels\n              : config.diffThresholdPixels;\n\n          // Perform soft assertions so failures are logged but other stories continue\n          expect.soft(diffPixels).toBeLessThan(threshold);\n        });\n      }\n    });\n  }\n}\n"],"names":["DEFAULT_EXCLUDE_TITLE_PREFIXES","COMMON_STYLES_TO_CAPTURE","slug","name","fetchStories","sourceOfTruth","excludeTitlePrefixes","stories","response","entries","entry","prefix","a","b","error","fetchTargetStoryIds","target","ids","runVisualRegression","config","getSourceOfTruth","targets","relaxedThresholdStoryIds","relaxedThresholdPixels","targetStoryIds","storyIds","test","story","browser","testInfo","sourcePage","targetPage","extractFn","stylesToCapture","crawl","el","data","computed","prop","child","root","sourceDOM","targetDOM","sourceSlug","targetSlug","fs","sourceBuffer","targetBuffer","img1","PNG","img2","diff","diffPixels","pixelmatch","threshold","id","expect"],"mappings":"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"}
+{"version":3,"file":"testing.js","sources":["../src/golden/diffPng.ts","../src/golden/validateManifest.ts","../src/golden/manifestStore.ts","../src/golden/resolveSourceOfTruthGolden.ts","../src/testing/runVisualRegression.ts"],"sourcesContent":["import pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\n\nexport interface PngDiffResult {\n  /** Mismatched-pixel count, or `Infinity` if the two images aren't even the\n   * same dimensions — pixelmatch itself throws on a size mismatch, and a size\n   * mismatch is itself a real difference, not something to swallow. */\n  diffPixels: number;\n  /** Visual highlight of the mismatched pixels, encoded as a PNG buffer.\n   * `null` when `diffPixels` is `Infinity` — there's no pixel-aligned diff to\n   * render across two different-sized images. */\n  diffImage: Buffer | null;\n}\n\n/** Pixel-diffs two PNG buffers. */\nexport function diffPngBuffers(a: Buffer, b: Buffer): PngDiffResult {\n  const imgA = PNG.sync.read(a);\n  const imgB = PNG.sync.read(b);\n  if (imgA.width !== imgB.width || imgA.height !== imgB.height) {\n    return { diffPixels: Infinity, diffImage: null };\n  }\n  const diff = new PNG({ width: imgA.width, height: imgA.height });\n  const diffPixels = pixelmatch(\n    imgA.data,\n    imgB.data,\n    diff.data,\n    imgA.width,\n    imgA.height,\n    { threshold: 0.1 },\n  );\n  return { diffPixels, diffImage: PNG.sync.write(diff) };\n}\n","import { Ajv } from \"ajv\";\nimport * as ajvFormatsModule from \"ajv-formats\";\nimport type { FormatsPlugin } from \"ajv-formats\";\nimport schema from \"./manifest.schema.json\" with { type: \"json\" };\n\n// See validateFileConfig.ts for why `.default` has to be unwrapped by hand.\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 `test/golden/manifest.json` against `manifest.schema.json`.\n * Throws with every violation listed — callers must not silently coerce or\n * drop invalid entries.\n */\nexport function validateGoldenManifest(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 {\n  closeSync,\n  existsSync,\n  mkdirSync,\n  openSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  unlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\nimport { validateGoldenManifest } from \"./validateManifest.js\";\n\nexport interface GoldenManifestEntry {\n  createdAt: string;\n  sourceOfTruthCreatedAt?: string;\n}\n\nexport type GoldenManifest = Record<string, GoldenManifestEntry>;\n\nexport function manifestPath(goldenDir: string): string {\n  return join(goldenDir, \"manifest.json\");\n}\n\nfunction manifestLockPath(goldenDir: string): string {\n  return join(goldenDir, \"manifest.json.lock\");\n}\n\nexport function goldenImagePath(goldenDir: string, storyId: string): string {\n  return join(goldenDir, `${storyId}.png`);\n}\n\n/** Returns `{}` if no manifest exists yet — a fresh adapter with no goldens\n * captured is the normal starting state, not an error. */\nexport function loadManifest(goldenDir: string): GoldenManifest {\n  const path = manifestPath(goldenDir);\n  if (!existsSync(path)) return {};\n  const data = JSON.parse(readFileSync(path, \"utf8\"));\n  validateGoldenManifest(data, path);\n  return data;\n}\n\n/** Validates before writing, and sorts keys so the diff on a reviewed PR is\n * stable regardless of the order stories happened to run in. Writes to a\n * temp file and renames over the real one — `rename` is atomic, so a\n * concurrent `loadManifest` (running in another Playwright worker) never\n * observes a half-written file. */\nexport function saveManifest(\n  goldenDir: string,\n  manifest: GoldenManifest,\n): void {\n  const path = manifestPath(goldenDir);\n  validateGoldenManifest(manifest, path);\n  const sorted: GoldenManifest = {};\n  for (const key of Object.keys(manifest).sort()) {\n    sorted[key] = manifest[key]!;\n  }\n  mkdirSync(goldenDir, { recursive: true });\n  const tmpPath = `${path}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  writeFileSync(tmpPath, JSON.stringify(sorted, null, 2) + \"\\n\");\n  renameSync(tmpPath, path);\n}\n\nconst LOCK_RETRY_MS = 25;\nconst LOCK_TIMEOUT_MS = 15_000;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Exclusive-create the lock file, spin-retrying until it's free. `wx` fails\n * atomically (`EEXIST`) if another worker process already holds it — that's\n * the only signal we need, no third-party lock library required for a\n * same-machine, same-run lock like this. */\nasync function acquireManifestLock(goldenDir: string): Promise<void> {\n  mkdirSync(goldenDir, { recursive: true });\n  const path = manifestLockPath(goldenDir);\n  const deadline = Date.now() + LOCK_TIMEOUT_MS;\n  for (;;) {\n    try {\n      closeSync(openSync(path, \"wx\"));\n      return;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n      if (Date.now() >= deadline) {\n        throw new Error(\n          `Timed out waiting for the manifest lock at \"${path}\" — delete it if a previous run crashed while holding it.`,\n        );\n      }\n      await sleep(LOCK_RETRY_MS);\n    }\n  }\n}\n\nfunction releaseManifestLock(goldenDir: string): void {\n  rmSync(manifestLockPath(goldenDir), { force: true });\n}\n\n/** Runs `updater` against this story's manifest entry under an exclusive\n * lock on `manifest.json`: reloads the manifest fresh, applies `updater`,\n * and saves it back, all before releasing the lock. Concurrent Playwright\n * workers each own a different story, so this is the only section that\n * needs to serialize — everything else about a story (its screenshot, its\n * golden image file, its diff) is independent of every other story. */\nexport async function updateManifestEntry(\n  goldenDir: string,\n  storyId: string,\n  updater: (\n    entry: GoldenManifestEntry | undefined,\n  ) => GoldenManifestEntry | undefined,\n): Promise<GoldenManifestEntry | undefined> {\n  await acquireManifestLock(goldenDir);\n  try {\n    const manifest = loadManifest(goldenDir);\n    const nextEntry = updater(manifest[storyId]);\n    if (nextEntry === undefined) {\n      delete manifest[storyId];\n    } else {\n      manifest[storyId] = nextEntry;\n    }\n    saveManifest(goldenDir, manifest);\n    return nextEntry;\n  } finally {\n    releaseManifestLock(goldenDir);\n  }\n}\n\nexport function saveGoldenImage(\n  goldenDir: string,\n  storyId: string,\n  buffer: Buffer,\n): void {\n  mkdirSync(goldenDir, { recursive: true });\n  writeFileSync(goldenImagePath(goldenDir, storyId), buffer);\n}\n\n/** Removes the golden `.png` + manifest entry for every story id in the\n * manifest that isn't in `currentStoryIds` (e.g. a story renamed or deleted\n * from Storybook) — otherwise those never get cleaned up on their own,\n * since a run only ever adds/updates entries for stories it actually saw.\n * Returns the pruned ids, for the caller to report. Both the file removal\n * and the manifest delete are idempotent, so it's safe for this to run\n * redundantly from more than one Playwright worker. */\nexport async function pruneOrphanedGoldens(\n  goldenDir: string,\n  currentStoryIds: ReadonlySet<string>,\n): Promise<string[]> {\n  const manifest = loadManifest(goldenDir);\n  const orphanIds = Object.keys(manifest).filter(\n    (id) => !currentStoryIds.has(id),\n  );\n  for (const id of orphanIds) {\n    const imagePath = goldenImagePath(goldenDir, id);\n    if (existsSync(imagePath)) unlinkSync(imagePath);\n    await updateManifestEntry(goldenDir, id, () => undefined);\n  }\n  return orphanIds;\n}\n","import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { SourceOfTruthGoldenLocation } from \"../config.js\";\nimport {\n  goldenImagePath,\n  loadManifest,\n  manifestPath,\n  type GoldenManifest,\n} from \"./manifestStore.js\";\nimport { validateGoldenManifest } from \"./validateManifest.js\";\n\nconst GITHUB_REPO = \"borderux/recursica\";\n\nexport interface SourceOfTruthGolden {\n  manifest: GoldenManifest;\n  /** Returns the golden PNG bytes for a story, or `null` if the source of\n   * truth has no golden captured for it yet. */\n  readImage(storyId: string): Promise<Buffer | null>;\n}\n\nasync function resolveNpmVersion(\n  packageName: string,\n  versionSpec: string,\n): Promise<string> {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(\n      `Could not reach npm registry for ${packageName}: ${response.statusText}`,\n    );\n  }\n  const data = (await response.json()) as {\n    \"dist-tags\"?: Record<string, string>;\n    versions?: Record<string, unknown>;\n  };\n  const resolved =\n    data[\"dist-tags\"]?.[versionSpec] ??\n    (data.versions?.[versionSpec] ? versionSpec : undefined);\n  if (!resolved) {\n    throw new Error(\n      `${packageName} has no version or dist-tag \"${versionSpec}\" on the npm registry.`,\n    );\n  }\n  return resolved;\n}\n\n// This monorepo's packages all live at `packages/<unscoped-name>` — mirrors\n// the same convention `mantineSourceOfTruthHarness` and every existing\n// `packages/*/package.json`'s `repository.directory` field already assume.\nfunction packageDirectory(packageName: string): string {\n  return `packages/${packageName.split(\"/\").pop()}`;\n}\n\n/**\n * Resolves the source-of-truth adapter's golden images for the divergence\n * check. Never boots a Storybook — both location types resolve to plain\n * files, fetched once and cached, not re-diffed per pixel over the wire.\n *\n * `location.type === \"local\"`: a sibling package already checked out (this\n * monorepo's own `sourceOfTruth.type: \"url\"` mode) — read its\n * `test/golden/` directly, including any uncommitted local changes.\n *\n * `location.type === \"npm\"`: no local checkout (the default, standalone-repo\n * mode) — resolve the installed version against the npm registry, then fetch\n * that exact version's `test/golden/` from the public GitHub repo at the\n * matching release tag (changesets tags every release as\n * `<packageName>@<version>`), caching what's downloaded under `cacheDir`.\n *\n * Returns `null` — degrading the divergence check to a skip, not a failure —\n * when no golden baseline exists yet for this version, or the registry/repo\n * is unreachable.\n */\nexport async function resolveSourceOfTruthGolden(\n  location: SourceOfTruthGoldenLocation,\n): Promise<SourceOfTruthGolden | null> {\n  if (location.type === \"local\") {\n    if (!existsSync(manifestPath(location.dir))) {\n      console.warn(\n        `No golden baseline found yet at ${location.dir} — source-of-truth divergence check skipped for this run.`,\n      );\n      return null;\n    }\n    const manifest = loadManifest(location.dir);\n    return {\n      manifest,\n      async readImage(storyId) {\n        const path = goldenImagePath(location.dir, storyId);\n        return existsSync(path) ? readFileSync(path) : null;\n      },\n    };\n  }\n\n  let version: string;\n  try {\n    version = await resolveNpmVersion(\n      location.packageName,\n      location.versionSpec,\n    );\n  } catch (error) {\n    console.warn(\n      `Could not resolve ${location.packageName}@${location.versionSpec} — source-of-truth divergence check skipped for this run.`,\n      error,\n    );\n    return null;\n  }\n\n  const cacheDir = join(location.cacheDir, version);\n  const tag = `${location.packageName}@${version}`;\n  const rawBase = `https://raw.githubusercontent.com/${GITHUB_REPO}/${tag}/${packageDirectory(location.packageName)}/test/golden`;\n\n  let manifest: GoldenManifest;\n  const cachedManifestPath = manifestPath(cacheDir);\n  if (existsSync(cachedManifestPath)) {\n    manifest = loadManifest(cacheDir);\n  } else {\n    let response: Response;\n    try {\n      response = await fetch(`${rawBase}/manifest.json`);\n    } catch (error) {\n      console.warn(\n        `Could not reach GitHub to fetch ${tag}'s golden baseline — source-of-truth divergence check skipped for this run.`,\n        error,\n      );\n      return null;\n    }\n    if (!response.ok) {\n      console.warn(\n        `No golden baseline published for ${tag} — source-of-truth divergence check skipped for this run.`,\n      );\n      return null;\n    }\n    const text = await response.text();\n    const parsed = JSON.parse(text);\n    validateGoldenManifest(parsed, `${rawBase}/manifest.json`);\n    mkdirSync(cacheDir, { recursive: true });\n    writeFileSync(cachedManifestPath, text);\n    manifest = parsed;\n  }\n\n  return {\n    manifest,\n    async readImage(storyId) {\n      const cachedImagePath = goldenImagePath(cacheDir, storyId);\n      if (existsSync(cachedImagePath)) return readFileSync(cachedImagePath);\n      const response = await fetch(`${rawBase}/${storyId}.png`);\n      if (!response.ok) return null;\n      const buffer = Buffer.from(await response.arrayBuffer());\n      mkdirSync(cacheDir, { recursive: true });\n      writeFileSync(cachedImagePath, buffer);\n      return buffer;\n    },\n  };\n}\n","import { expect } from \"@playwright/test\";\nimport type { Browser, TestInfo } from \"@playwright/test\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport type { AdapterTesterConfig } from \"../config.js\";\nimport { diffPngBuffers } from \"../golden/diffPng.js\";\nimport {\n  type GoldenManifestEntry,\n  goldenImagePath,\n  loadManifest,\n  pruneOrphanedGoldens,\n  saveGoldenImage,\n  updateManifestEntry,\n} from \"../golden/manifestStore.js\";\nimport { resolveSourceOfTruthGolden } from \"../golden/resolveSourceOfTruthGolden.js\";\n\nconst DEFAULT_EXCLUDE_TITLE_PREFIXES = [\"Theme\", \"Tokens\", \"Introduction\"];\n\ninterface StorybookEntry {\n  type: string;\n  id: string;\n  name: string;\n  title: string;\n}\n\nfunction matchesPrefix(id: string, prefix: string): boolean {\n  return id === prefix || id.startsWith(prefix);\n}\n\nasync function fetchStories(\n  target: { name: string; url: string },\n  excludeTitlePrefixes: string[],\n  excludeStoryIds: string[],\n): Promise<StorybookEntry[]> {\n  let stories: StorybookEntry[];\n  try {\n    const response = await fetch(`${target.url}/index.json`);\n    if (!response.ok) {\n      throw new Error(\n        `Failed to fetch Storybook index: ${response.statusText}`,\n      );\n    }\n    const data = (await response.json()) as any;\n    const entries = data.entries || {};\n    stories = Object.values(entries).filter(\n      (entry: any) =>\n        entry.type === \"story\" &&\n        !excludeTitlePrefixes.some(\n          (prefix) =>\n            entry.title === prefix || entry.title.startsWith(`${prefix}/`),\n        ) &&\n        !excludeStoryIds.some((prefix) => matchesPrefix(entry.id, prefix)),\n    ) as StorybookEntry[];\n    stories.sort((a, b) => a.id.localeCompare(b.id));\n  } catch (error) {\n    console.error(\n      \"Failed to load Storybook index from\",\n      `${target.url}/index.json`,\n      error,\n    );\n    throw new Error(\n      `Storybook target \"${target.name}\" is not responsive or index.json is missing. Please ensure its Storybook is running.`,\n    );\n  }\n  return stories;\n}\n\n/** Resolves the diff threshold for `storyId`: the longest (most specific)\n * `storyThresholds` key matching by prefix, falling back to\n * `diffThresholdPixels` when nothing matches. */\nfunction resolveThreshold(\n  storyId: string,\n  storyThresholds: Record<string, number>,\n  diffThresholdPixels: number,\n): number {\n  let bestMatch: string | undefined;\n  for (const prefix of Object.keys(storyThresholds)) {\n    if (\n      matchesPrefix(storyId, prefix) &&\n      (!bestMatch || prefix.length > bestMatch.length)\n    ) {\n      bestMatch = prefix;\n    }\n  }\n  return bestMatch !== undefined\n    ? storyThresholds[bestMatch]!\n    : diffThresholdPixels;\n}\n\n/** Everything a generated Playwright spec needs to register the golden-image\n * suite itself. Split out from the actual `test.describe`/`test` calls so\n * those calls execute in the spec file that imports this, not in this\n * library file — otherwise Playwright's HTML report groups every story under\n * this file's own (sourcemapped) path instead of a stable spec name. */\nexport interface VisualRegressionPlan {\n  /** `config`'s own (non-source-of-truth) target name, for the suite title. */\n  ownTargetName: string;\n  /** Suite title suffix describing which check mode is running. */\n  suiteLabel: string;\n  /** Stories to check, already filtered and sorted by id. */\n  stories: StorybookEntry[];\n  /** Golden-checks one story. Call this from inside a `test(story.id, ...)`\n   * body — safe to run concurrently across Playwright workers, since each\n   * call only ever reads/writes its own story's manifest entry (locked at\n   * the point it writes it back, so concurrent workers never race each\n   * other's entries — see `updateManifestEntry`). */\n  checkStory: (\n    story: StorybookEntry,\n    browser: Browser,\n    testInfo: TestInfo,\n  ) => Promise<void>;\n}\n\n/**\n * Resolves the golden-image plan for `config`'s own target (the one target\n * in `config.targets` not marked `sourceOfTruth`).\n *\n * Two independent checks per story, gated by `config.checkMode`, neither of\n * which boots the source-of-truth adapter's own Storybook — the divergence\n * check below compares stored golden files, not live pages:\n *\n * 1. **Own-drift (`checkMode: \"own\"`, the default; hard fail):** this run's\n *    live render vs this project's own stored `test/golden/<story-id>.png`.\n *    No golden yet for a story is not a failure — one is captured from this\n *    run instead (same as `--update-golden`, scoped to just that story), in\n *    either mode.\n * 2. **Source-of-truth divergence (`checkMode: \"divergence\"`; soft flag,\n *    never fails the run):** this project's own golden vs the\n *    source-of-truth's golden (`config`'s `sourceOfTruthGolden`). Skipped\n *    entirely when `config.isSourceOfTruthAdapter` is true — the\n *    source-of-truth adapter has nothing above it to diverge from — and\n *    skipped per-story when neither side has a baseline yet. A\n *    once-flagged divergence stays quiet after `--approve-divergence`,\n *    until the source of truth's own golden changes again.\n */\nexport async function resolveVisualRegressionPlan(\n  config: AdapterTesterConfig,\n): Promise<VisualRegressionPlan> {\n  const ownTarget = config.isSourceOfTruthAdapter\n    ? config.targets[0]\n    : config.targets.find((target) => !target.sourceOfTruth);\n  if (!ownTarget) {\n    throw new Error(\n      \"adapter-tester config has no non-sourceOfTruth target to run the golden check against.\",\n    );\n  }\n  const excludeTitlePrefixes =\n    config.excludeTitlePrefixes ?? DEFAULT_EXCLUDE_TITLE_PREFIXES;\n  const storyOverrides = config.stories ?? {};\n  const excludeStoryIds = Object.keys(storyOverrides).filter(\n    (id) => storyOverrides[id]!.exclude,\n  );\n  const storyThresholds = Object.fromEntries(\n    Object.entries(storyOverrides)\n      .filter(([, override]) => override.threshold !== undefined)\n      .map(([id, override]) => [id, override.threshold!]),\n  );\n  const goldenDir = config.goldenDir;\n  const goldenMode = config.goldenMode;\n  const checkMode = config.checkMode;\n\n  const stories = await fetchStories(\n    ownTarget,\n    excludeTitlePrefixes,\n    excludeStoryIds,\n  );\n\n  // `--update-golden` redefines this project's own baseline, so it's also\n  // the point a renamed/removed story's now-orphaned golden gets cleaned up\n  // — otherwise nothing ever prunes it, since a run only ever adds/updates\n  // entries for stories it actually saw in this pass. Uses the full current\n  // story list (not narrowed by any `--grep` Playwright itself applies), so\n  // this catches every orphan regardless of how the run is scoped.\n  if (goldenMode === \"update-golden\") {\n    const prunedStoryIds = await pruneOrphanedGoldens(\n      goldenDir,\n      new Set(stories.map((story) => story.id)),\n    );\n    if (prunedStoryIds.length > 0) {\n      console.warn(\n        `Pruned ${prunedStoryIds.length} orphaned golden(s) no longer in Storybook: ${prunedStoryIds.join(\", \")}`,\n      );\n    }\n  }\n\n  const sourceOfTruthGolden =\n    checkMode !== \"divergence\" ||\n    config.isSourceOfTruthAdapter ||\n    !config.sourceOfTruthGolden\n      ? null\n      : await resolveSourceOfTruthGolden(config.sourceOfTruthGolden);\n\n  const suiteLabel =\n    checkMode === \"divergence\"\n      ? \"Source-of-Truth Divergence Check\"\n      : \"Own-Drift Golden Image Check\";\n\n  return {\n    ownTargetName: ownTarget.name,\n    suiteLabel,\n    stories,\n    checkStory: async (story, browser, testInfo) => {\n      const page = await browser.newPage();\n      await page.setViewportSize({ width: 800, height: 600 });\n      await page.goto(\n        `${ownTarget.url}/iframe.html?id=${story.id}&viewMode=story`,\n        { waitUntil: \"networkidle\" },\n      );\n      await page.waitForSelector(\"#storybook-root\");\n      await page.waitForTimeout(300);\n      const liveBuffer = await page.screenshot();\n\n      const imagePath = goldenImagePath(goldenDir, story.id);\n      // Only this worker ever touches this story's key, so reading it here\n      // (outside the lock `updateManifestEntry` takes at the end) can't\n      // race another worker — they're all reading/writing different keys.\n      const entry = loadManifest(goldenDir)[story.id];\n      const capturingNewGolden =\n        goldenMode !== \"check\" || !entry || !existsSync(imagePath);\n\n      let currentEntry: GoldenManifestEntry;\n      if (capturingNewGolden) {\n        saveGoldenImage(goldenDir, story.id, liveBuffer);\n        currentEntry = entry?.sourceOfTruthCreatedAt\n          ? {\n              createdAt: new Date().toISOString(),\n              sourceOfTruthCreatedAt: entry.sourceOfTruthCreatedAt,\n            }\n          : { createdAt: new Date().toISOString() };\n        if (!entry) {\n          testInfo.annotations.push({\n            type: \"golden-created\",\n            description: `No golden existed yet for \"${story.id}\" — captured one from this run.`,\n          });\n        }\n      } else {\n        currentEntry = entry;\n        if (checkMode === \"own\") {\n          const goldenBuffer = readFileSync(imagePath);\n          const { diffPixels, diffImage } = diffPngBuffers(\n            liveBuffer,\n            goldenBuffer,\n          );\n          const threshold = resolveThreshold(\n            story.id,\n            storyThresholds,\n            config.diffThresholdPixels,\n          );\n          if (diffPixels >= threshold) {\n            await testInfo.attach(\"expected\", {\n              body: goldenBuffer,\n              contentType: \"image/png\",\n            });\n            await testInfo.attach(\"actual\", {\n              body: liveBuffer,\n              contentType: \"image/png\",\n            });\n            if (diffImage) {\n              await testInfo.attach(\"diff\", {\n                body: diffImage,\n                contentType: \"image/png\",\n              });\n            }\n          }\n          expect\n            .soft(\n              diffPixels,\n              `\"${story.id}\" has drifted from its own golden image (${diffPixels} mismatched pixels, threshold ${threshold})`,\n            )\n            .toBeLessThan(threshold);\n        }\n      }\n\n      if (sourceOfTruthGolden) {\n        const sourceOfTruthEntry = sourceOfTruthGolden.manifest[story.id];\n        const sourceOfTruthImage = sourceOfTruthEntry\n          ? await sourceOfTruthGolden.readImage(story.id)\n          : null;\n\n        if (sourceOfTruthEntry && sourceOfTruthImage) {\n          if (goldenMode === \"approve-divergence\") {\n            currentEntry = {\n              ...currentEntry,\n              sourceOfTruthCreatedAt: sourceOfTruthEntry.createdAt,\n            };\n          } else {\n            const ownImage = readFileSync(imagePath);\n            const { diffPixels, diffImage } = diffPngBuffers(\n              ownImage,\n              sourceOfTruthImage,\n            );\n            const approvedAt = currentEntry.sourceOfTruthCreatedAt;\n            const isKnownDivergence =\n              diffPixels === 0 ||\n              (approvedAt !== undefined &&\n                approvedAt >= sourceOfTruthEntry.createdAt);\n            if (!isKnownDivergence) {\n              await testInfo.attach(\"expected\", {\n                body: sourceOfTruthImage,\n                contentType: \"image/png\",\n              });\n              await testInfo.attach(\"actual\", {\n                body: ownImage,\n                contentType: \"image/png\",\n              });\n              if (diffImage) {\n                await testInfo.attach(\"diff\", {\n                  body: diffImage,\n                  contentType: \"image/png\",\n                });\n              }\n              testInfo.annotations.push({\n                type: \"source-of-truth-divergence\",\n                description: `\"${story.id}\" differs from the source of truth's golden and hasn't been reviewed — run with --approve-divergence if this is intentional, or fix the adapter styling.`,\n              });\n            }\n          }\n        }\n      }\n\n      // Locked read-modify-write of just this story's entry — see\n      // `updateManifestEntry` for why that's enough to make this safe\n      // across concurrent Playwright workers.\n      await updateManifestEntry(goldenDir, story.id, () => currentEntry);\n    },\n  };\n}\n"],"names":["diffPngBuffers","a","b","imgA","PNG","imgB","diff","pixelmatch","addFormats","ajvFormatsModule.default","ajv","Ajv","validate","schema","validateGoldenManifest","data","path","errors","error","extra","_a","manifestPath","goldenDir","join","manifestLockPath","goldenImagePath","storyId","loadManifest","existsSync","readFileSync","saveManifest","manifest","sorted","key","mkdirSync","tmpPath","writeFileSync","renameSync","LOCK_RETRY_MS","LOCK_TIMEOUT_MS","sleep","ms","resolve","acquireManifestLock","deadline","closeSync","openSync","releaseManifestLock","rmSync","updateManifestEntry","updater","nextEntry","saveGoldenImage","buffer","pruneOrphanedGoldens","currentStoryIds","orphanIds","id","imagePath","unlinkSync","GITHUB_REPO","resolveNpmVersion","packageName","versionSpec","response","resolved","_b","packageDirectory","resolveSourceOfTruthGolden","location","version","cacheDir","tag","rawBase","cachedManifestPath","text","parsed","cachedImagePath","DEFAULT_EXCLUDE_TITLE_PREFIXES","matchesPrefix","prefix","fetchStories","target","excludeTitlePrefixes","excludeStoryIds","stories","entries","entry","resolveThreshold","storyThresholds","diffThresholdPixels","bestMatch","resolveVisualRegressionPlan","config","ownTarget","storyOverrides","override","goldenMode","checkMode","prunedStoryIds","story","sourceOfTruthGolden","suiteLabel","browser","testInfo","page","liveBuffer","capturingNewGolden","currentEntry","goldenBuffer","diffPixels","diffImage","threshold","expect","sourceOfTruthEntry","sourceOfTruthImage","ownImage","approvedAt"],"mappings":"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"}

package/package.json

@@ -13,7 +13,7 @@
     "url": "git+https://github.com/borderux/recursica.git",
     "directory": "packages/adapter-tester"
   },
-  "version": "2.2.0",
+  "version": "4.0.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -34,7 +34,8 @@
     "dist",
     "public",
     "report-header.txt",
-    "src/adapter-tester.schema.json"
+    "src/adapter-tester.schema.json",
+    "src/golden/manifest.schema.json"
   ],
   "keywords": [
     "recursica",
@@ -48,10 +49,7 @@
   },
   "scripts": {
     "build": "vite build --mode library",
-    "postbuild": "chmod +x dist/cli.js",
-    "adapter-tester": "node dist/cli.js --serve",
-    "adapter-tester:automated": "node dist/cli.js",
-    "dev": "tsx src/cli.ts --serve"
+    "postbuild": "chmod +x dist/cli.js"
   },
   "dependencies": {
     "ajv": "^8.17.1",
@@ -72,7 +70,6 @@
     "@types/pixelmatch": "^5.2.6",
     "@types/pngjs": "^6.0.5",
     "playwright": "^1.60.0",
-    "tsx": "^4.22.3",
     "typescript": "~5.8.3",
     "vite": "^6.3.5",
     "vite-plugin-dts": "^4.5.4"