@recursica/adapter-tester 2.2.0 → 3.0.0

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 (40) hide show
  1. package/README.md +47 -16
  2. package/dist/adapter-tester.schema.json.d.ts +14 -10
  3. package/dist/cli.cjs +20 -24
  4. package/dist/cli.cjs.map +1 -1
  5. package/dist/cli.js +235 -4842
  6. package/dist/cli.js.map +1 -1
  7. package/dist/config.d.ts +46 -6
  8. package/dist/config.d.ts.map +1 -1
  9. package/dist/fileConfig.d.ts +9 -2
  10. package/dist/fileConfig.d.ts.map +1 -1
  11. package/dist/golden/diffPng.d.ts +8 -0
  12. package/dist/golden/diffPng.d.ts.map +1 -0
  13. package/dist/golden/manifest.schema.json.d.ts +27 -0
  14. package/dist/golden/manifestStore.d.ts +15 -0
  15. package/dist/golden/manifestStore.d.ts.map +1 -0
  16. package/dist/golden/resolveSourceOfTruthGolden.d.ts +29 -0
  17. package/dist/golden/resolveSourceOfTruthGolden.d.ts.map +1 -0
  18. package/dist/golden/validateManifest.d.ts +7 -0
  19. package/dist/golden/validateManifest.d.ts.map +1 -0
  20. package/dist/index-C6uYPRmx.cjs +9 -0
  21. package/dist/index-C6uYPRmx.cjs.map +1 -0
  22. package/dist/index-DqQzFSAH.js +4667 -0
  23. package/dist/index-DqQzFSAH.js.map +1 -0
  24. package/dist/index.cjs +1 -1
  25. package/dist/index.cjs.map +1 -1
  26. package/dist/index.js +21 -6
  27. package/dist/index.js.map +1 -1
  28. package/dist/testing/runVisualRegression.d.ts +22 -5
  29. package/dist/testing/runVisualRegression.d.ts.map +1 -1
  30. package/dist/testing.cjs +4 -1
  31. package/dist/testing.cjs.map +1 -1
  32. package/dist/testing.js +221 -151
  33. package/dist/testing.js.map +1 -1
  34. package/package.json +3 -2
  35. package/src/adapter-tester.schema.json +14 -10
  36. package/src/golden/manifest.schema.json +24 -0
  37. package/dist/config-B0Eop8Az.cjs +0 -2
  38. package/dist/config-B0Eop8Az.cjs.map +0 -1
  39. package/dist/config-CDxTeSAY.js +0 -21
  40. package/dist/config-CDxTeSAY.js.map +0 -1
package/dist/index.cjs CHANGED
@@ -1,2 +1,2 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./config-B0Eop8Az.cjs"),r=require("./mantineSourceOfTruth-BUb5MZy0.cjs");exports.defineAdapterTesterConfig=e.defineAdapterTesterConfig;exports.getSourceOfTruth=e.getSourceOfTruth;exports.mantineSourceOfTruthWebServer=r.mantineSourceOfTruthWebServer;exports.scaffoldMantineSourceOfTruthHarness=r.scaffoldMantineSourceOfTruthHarness;
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("./mantineSourceOfTruth-BUb5MZy0.cjs");function n(r){const e=r.targets.filter(t=>t.sourceOfTruth).length;if(e!==1)throw new Error(`adapter-tester config must mark exactly one target as sourceOfTruth (found ${e})`);return r}function o(r){const e=r.targets.find(t=>t.sourceOfTruth);if(!e)throw new Error("adapter-tester config has no target marked sourceOfTruth");return e}exports.mantineSourceOfTruthWebServer=u.mantineSourceOfTruthWebServer;exports.scaffoldMantineSourceOfTruthHarness=u.scaffoldMantineSourceOfTruthHarness;exports.defineAdapterTesterConfig=n;exports.getSourceOfTruth=o;
2
2
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}
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 `runVisualRegression` 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\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /** Global pixel-diff threshold applied to every story comparison. */\n diffThresholdPixels: number;\n /**\n * Per-story diff threshold overrides, keyed by story id prefix (a story\n * matches if its id equals the key or starts with it). Overrides\n * `diffThresholdPixels` for components with acceptable cross-library\n * structural variation (e.g. native control widgets). When more than one\n * key matches, the longest (most specific) key wins.\n */\n storyThresholds?: Record<string, number>;\n /**\n * Story id prefixes (same matching rule as `storyThresholds`) skipped\n * entirely — no own-drift check, no divergence check, no golden captured.\n */\n excludeStoryIds?: string[];\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}\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":"uIAgFO,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 CHANGED
@@ -1,9 +1,24 @@
1
- import { d as t, g as a } from "./config-CDxTeSAY.js";
2
- import { m as o, s } from "./mantineSourceOfTruth-BUkqMNEo.js";
1
+ import { m as s, s as a } from "./mantineSourceOfTruth-BUkqMNEo.js";
2
+ function o(t) {
3
+ const r = t.targets.filter(
4
+ (e) => e.sourceOfTruth
5
+ ).length;
6
+ if (r !== 1)
7
+ throw new Error(
8
+ `adapter-tester config must mark exactly one target as sourceOfTruth (found ${r})`
9
+ );
10
+ return t;
11
+ }
12
+ function u(t) {
13
+ const r = t.targets.find((e) => e.sourceOfTruth);
14
+ if (!r)
15
+ throw new Error("adapter-tester config has no target marked sourceOfTruth");
16
+ return r;
17
+ }
3
18
  export {
4
- t as defineAdapterTesterConfig,
5
- a as getSourceOfTruth,
6
- o as mantineSourceOfTruthWebServer,
7
- s as scaffoldMantineSourceOfTruthHarness
19
+ o as defineAdapterTesterConfig,
20
+ u as getSourceOfTruth,
21
+ s as mantineSourceOfTruthWebServer,
22
+ a as scaffoldMantineSourceOfTruthHarness
8
23
  };
9
24
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
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 `runVisualRegression` 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\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /** Global pixel-diff threshold applied to every story comparison. */\n diffThresholdPixels: number;\n /**\n * Per-story diff threshold overrides, keyed by story id prefix (a story\n * matches if its id equals the key or starts with it). Overrides\n * `diffThresholdPixels` for components with acceptable cross-library\n * structural variation (e.g. native control widgets). When more than one\n * key matches, the longest (most specific) key wins.\n */\n storyThresholds?: Record<string, number>;\n /**\n * Story id prefixes (same matching rule as `storyThresholds`) skipped\n * entirely — no own-drift check, no divergence check, no golden captured.\n */\n excludeStoryIds?: string[];\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}\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":";AAgFO,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,10 +1,27 @@
1
1
  import { AdapterTesterConfig } from '../config.js';
2
2
  /**
3
- * Defines a Playwright suite that diffs every target in `config.targets`
4
- * against `config.targets`' single `sourceOfTruth` entry, story by story.
5
- * Call this with a top-level `await` from a Playwright `*.spec.ts` file — it
6
- * calls `test.describe` at module scope, so it must run inside Playwright's
7
- * test runner during test-graph compilation.
3
+ * Defines a Playwright suite that golden-image-tests every story in
4
+ * `config`'s own target (the one target in `config.targets` not marked
5
+ * `sourceOfTruth`). Call this with a top-level `await` from a Playwright
6
+ * `*.spec.ts` file — it calls `test.describe` at module scope, so it must
7
+ * run inside Playwright's test runner during test-graph compilation.
8
+ *
9
+ * Two independent checks per story, neither of which boots the
10
+ * source-of-truth adapter's own Storybook — the divergence check below
11
+ * compares stored golden files, not live pages:
12
+ *
13
+ * 1. **Own-drift (hard fail):** this run's live render vs this project's own
14
+ * stored `test/golden/<story-id>.png`. No golden yet for a story is not a
15
+ * failure — one is captured from this run instead (same as
16
+ * `--update-golden`, scoped to just that story).
17
+ * 2. **Source-of-truth divergence (soft flag, never fails the run):** this
18
+ * project's own golden vs the source-of-truth's golden (`config`'s
19
+ * `sourceOfTruthGolden`). Skipped entirely when
20
+ * `config.isSourceOfTruthAdapter` is true — the source-of-truth adapter
21
+ * has nothing above it to diverge from — and skipped per-story when
22
+ * neither side has a baseline yet. A once-flagged divergence stays quiet
23
+ * after `--approve-divergence`, until the source of truth's own golden
24
+ * changes again.
8
25
  */
9
26
  export declare function runVisualRegression(config: AdapterTesterConfig): Promise<void>;
10
27
  //# sourceMappingURL=runVisualRegression.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"runVisualRegression.d.ts","sourceRoot":"","sources":["../../src/testing/runVisualRegression.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA8GvE;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA+Jf"}
1
+ {"version":3,"file":"runVisualRegression.d.ts","sourceRoot":"","sources":["../../src/testing/runVisualRegression.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAmFxD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Hf"}
package/dist/testing.cjs CHANGED
@@ -1,2 +1,5 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("@playwright/test"),_=require("pixelmatch"),g=require("pngjs"),w=require("node:fs"),G=require("./config-B0Eop8Az.cjs"),R=["Theme","Tokens","Introduction"],D=["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 E(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-")}async function U(t,e){let a;try{const i=await fetch(`${t.url}/index.json`);if(!i.ok)throw new Error(`Failed to fetch Storybook index: ${i.statusText}`);const s=(await i.json()).entries||{};a=Object.values(s).filter(n=>n.type==="story"&&!e.some(c=>n.title===c||n.title.startsWith(`${c}/`))),a.sort((n,c)=>n.id.localeCompare(c.id))}catch(i){throw console.error("Failed to load Storybook index from",`${t.url}/index.json`,i),new Error(`Storybook source of truth "${t.name}" is not responsive or index.json is missing. Please ensure its Storybook is running.`)}return a}async function z(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.`),new Set;const i=(await e.json()).entries||{},y=Object.values(i).filter(s=>s.type==="story").map(s=>s.id);return new Set(y)}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),new Set}}async function I(t){const e=G.getSourceOfTruth(t),a=t.targets.filter(r=>!r.sourceOfTruth),i=t.excludeTitlePrefixes??R,y=t.relaxedThresholdStoryIds??[],s=t.relaxedThresholdPixels,n=await U(e,i),c=new Map;for(const r of a)c.set(r.name,await z(r));for(const r of a){const C=c.get(r.name)??new Set;f.test.describe(`${e.name} vs ${r.name} Dynamic Visual Regression Suite`,()=>{for(const o of n)f.test(`Visual regression for: ${o.title} - ${o.name} (${o.id})`,async({browser:P},u)=>{f.test.skip(!C.has(o.id),`${r.name} has no story with id "${o.id}" yet not yet implemented, not a failure.`);const d=await P.newPage(),l=await P.newPage();await d.setViewportSize({width:800,height:600}),await l.setViewportSize({width:800,height:600}),await Promise.all([d.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([d.waitForSelector("#storybook-root"),l.waitForSelector("#storybook-root")]),await Promise.all([d.waitForTimeout(300),l.waitForTimeout(300)]);const O=b=>{function N($){const x={tag:$.tagName.toLowerCase(),styles:{},children:[]},J=window.getComputedStyle($);for(const m of b)x.styles[m]=J.getPropertyValue(m);for(const m of Array.from($.children))x.children.push(N(m));return x}const M=document.querySelector("#storybook-root");return M?N(M):null},k=await d.evaluate(O,D),j=await l.evaluate(O,D);await u.attach(`${e.name} DOM Tree JSON`,{body:JSON.stringify(k,null,2),contentType:"application/json"}),await u.attach(`${r.name} DOM Tree JSON`,{body:JSON.stringify(j,null,2),contentType:"application/json"});const F=E(e.name),v=E(r.name);w.writeFileSync(`/tmp/${o.id}-${F}DOM.json`,JSON.stringify(k,null,2)),w.writeFileSync(`/tmp/${o.id}-${v}DOM.json`,JSON.stringify(j,null,2));const p=await d.screenshot(),S=await l.screenshot(),h=g.PNG.sync.read(p),V=g.PNG.sync.read(S),T=new g.PNG({width:h.width,height:h.height}),L=_(h.data,V.data,T.data,h.width,h.height,{threshold:.1});w.writeFileSync(`/tmp/${o.id}-diff.png`,g.PNG.sync.write(T)),w.writeFileSync(`/tmp/${o.id}-${F}.png`,p),w.writeFileSync(`/tmp/${o.id}-${v}.png`,S),await u.attach("Visual Diff Overlay",{body:g.PNG.sync.write(T),contentType:"image/png"}),await u.attach(`${e.name} Screenshot (Source of Truth)`,{body:p,contentType:"image/png"}),await u.attach(`${r.name} Screenshot (Target)`,{body:S,contentType:"image/png"});const q=s!==void 0&&y.some(b=>o.id.startsWith(b))?s:t.diffThresholdPixels;f.expect.soft(L).toBeLessThan(q)})})}}exports.runVisualRegression=I;
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("@playwright/test"),a=require("node:fs"),D=require("pixelmatch"),k=require("pngjs"),T=require("node:path"),G=require("./index-C6uYPRmx.cjs");function A(e,t){const r=k.PNG.sync.read(e),s=k.PNG.sync.read(t);if(r.width!==s.width||r.height!==s.height)return 1/0;const n=new k.PNG({width:r.width,height:r.height});return D(r.data,s.data,n.data,r.width,r.height,{threshold:.1})}const B="http://json-schema.org/draft-07/schema#",M="https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/golden/manifest.schema.json",q="test/golden/manifest.json",_="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.",L="object",R={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."}}},V={$schema:B,$id:M,title:q,description:_,type:L,additionalProperties:R},U=G.index,I=new G.ajvExports.Ajv({allErrors:!0,strict:!0});U(I);const E=I.compile(V);function b(e,t){if(E(e))return;const r=(E.errors??[]).map(s=>{var d;const n=(d=s.params)!=null&&d.additionalProperty?` '${s.params.additionalProperty}'`:"";return` - ${s.instancePath||"root"} ${s.message}${n}`}).join(`
2
+ `);throw new Error(`Invalid ${t}:
3
+ ${r}`)}function m(e){return T.join(e,"manifest.json")}function w(e,t){return T.join(e,`${t}.png`)}function x(e){const t=m(e);if(!a.existsSync(t))return{};const r=JSON.parse(a.readFileSync(t,"utf8"));return b(r,t),r}function J(e,t){const r=m(e);b(t,r);const s={};for(const n of Object.keys(t).sort())s[n]=t[n];a.mkdirSync(e,{recursive:!0}),a.writeFileSync(r,JSON.stringify(s,null,2)+`
4
+ `)}function W(e,t,r){a.mkdirSync(e,{recursive:!0}),a.writeFileSync(w(e,t),r)}const H="borderux/recursica";async function K(e,t){var d,h;const r=await fetch(`https://registry.npmjs.org/${e}`);if(!r.ok)throw new Error(`Could not reach npm registry for ${e}: ${r.statusText}`);const s=await r.json(),n=((d=s["dist-tags"])==null?void 0:d[t])??((h=s.versions)!=null&&h[t]?t:void 0);if(!n)throw new Error(`${e} has no version or dist-tag "${t}" on the npm registry.`);return n}function X(e){return`packages/${e.split("/").pop()}`}async function z(e){if(e.type==="local")return a.existsSync(m(e.dir))?{manifest:x(e.dir),async readImage(i){const u=w(e.dir,i);return a.existsSync(u)?a.readFileSync(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{t=await K(e.packageName,e.versionSpec)}catch(c){return console.warn(`Could not resolve ${e.packageName}@${e.versionSpec} — source-of-truth divergence check skipped for this run.`,c),null}const r=T.join(e.cacheDir,t),s=`${e.packageName}@${t}`,n=`https://raw.githubusercontent.com/${H}/${s}/${X(e.packageName)}/test/golden`;let d;const h=m(r);if(a.existsSync(h))d=x(r);else{let c;try{c=await fetch(`${n}/manifest.json`)}catch(o){return console.warn(`Could not reach GitHub to fetch ${s}'s golden baseline — source-of-truth divergence check skipped for this run.`,o),null}if(!c.ok)return console.warn(`No golden baseline published for ${s} — source-of-truth divergence check skipped for this run.`),null;const i=await c.text(),u=JSON.parse(i);b(u,`${n}/manifest.json`),a.mkdirSync(r,{recursive:!0}),a.writeFileSync(h,i),d=u}return{manifest:d,async readImage(c){const i=w(r,c);if(a.existsSync(i))return a.readFileSync(i);const u=await fetch(`${n}/${c}.png`);if(!u.ok)return null;const o=Buffer.from(await u.arrayBuffer());return a.mkdirSync(r,{recursive:!0}),a.writeFileSync(i,o),o}}}const Q=["Theme","Tokens","Introduction"];function F(e,t){return e===t||e.startsWith(t)}async function Y(e,t,r){let s;try{const n=await fetch(`${e.url}/index.json`);if(!n.ok)throw new Error(`Failed to fetch Storybook index: ${n.statusText}`);const h=(await n.json()).entries||{};s=Object.values(h).filter(c=>c.type==="story"&&!t.some(i=>c.title===i||c.title.startsWith(`${i}/`))&&!r.some(i=>F(c.id,i))),s.sort((c,i)=>c.id.localeCompare(i.id))}catch(n){throw console.error("Failed to load Storybook index from",`${e.url}/index.json`,n),new Error(`Storybook target "${e.name}" is not responsive or index.json is missing. Please ensure its Storybook is running.`)}return s}function Z(e,t,r){let s;for(const n of Object.keys(t))F(e,n)&&(!s||n.length>s.length)&&(s=n);return s!==void 0?t[s]:r}async function ee(e){const t=e.isSourceOfTruthAdapter?e.targets[0]:e.targets.find(o=>!o.sourceOfTruth);if(!t)throw new Error("adapter-tester config has no non-sourceOfTruth target to run the golden check against.");const r=e.excludeTitlePrefixes??Q,s=e.excludeStoryIds??[],n=e.storyThresholds??{},d=e.goldenDir,h=e.goldenMode,c=await Y(t,r,s),i=x(d),u=e.isSourceOfTruthAdapter||!e.sourceOfTruthGolden?null:await z(e.sourceOfTruthGolden);S.test.describe(`${t.name} — Golden Image Visual Regression`,()=>{for(const o of c)S.test(`Golden regression for: ${o.title} - ${o.name} (${o.id})`,async({browser:N},y)=>{const p=await N.newPage();await p.setViewportSize({width:800,height:600}),await p.goto(`${t.url}/iframe.html?id=${o.id}&viewMode=story`,{waitUntil:"networkidle"}),await p.waitForSelector("#storybook-root"),await p.waitForTimeout(300);const O=await p.screenshot(),v=w(d,o.id),l=i[o.id];if(h!=="check"||!l||!a.existsSync(v))W(d,o.id,O),i[o.id]=l!=null&&l.sourceOfTruthCreatedAt?{createdAt:new Date().toISOString(),sourceOfTruthCreatedAt:l.sourceOfTruthCreatedAt}:{createdAt:new Date().toISOString()},l||y.annotations.push({type:"golden-created",description:`No golden existed yet for "${o.id}" — captured one from this run.`});else{const f=a.readFileSync(v),g=A(O,f);await y.attach("Live vs Golden Diff",{body:`${g} mismatched pixels`,contentType:"text/plain"});const $=Z(o.id,n,e.diffThresholdPixels);S.expect.soft(g,`"${o.id}" has drifted from its own golden image`).toBeLessThan($)}const j=i[o.id];if(u){const f=u.manifest[o.id],g=f?await u.readImage(o.id):null;if(f&&g)if(h==="approve-divergence")i[o.id]={...j,sourceOfTruthCreatedAt:f.createdAt};else{const $=a.readFileSync(v),C=A($,g),P=j.sourceOfTruthCreatedAt;C===0||P!==void 0&&P>=f.createdAt||y.annotations.push({type:"source-of-truth-divergence",description:`"${o.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.`})}}J(d,i)})})}exports.runVisualRegression=ee;
2
5
  //# sourceMappingURL=testing.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"testing.cjs","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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"}
1
+ {"version":3,"file":"testing.cjs","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\n/**\n * Pixel-diffs two PNG buffers. Returns the mismatched-pixel count, or\n * `Infinity` if the two images aren't even the same dimensions — pixelmatch\n * itself throws on a size mismatch, and a size mismatch is itself a real\n * difference, not something to swallow.\n */\nexport function diffPngBuffers(a: Buffer, b: Buffer): number {\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 Infinity;\n }\n const diff = new PNG({ width: imgA.width, height: imgA.height });\n return pixelmatch(imgA.data, imgB.data, diff.data, imgA.width, imgA.height, {\n threshold: 0.1,\n });\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 { existsSync, mkdirSync, readFileSync, writeFileSync } 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\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. */\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 writeFileSync(path, JSON.stringify(sorted, null, 2) + \"\\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","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 { test, expect } from \"@playwright/test\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport type { AdapterTesterConfig } from \"../config.js\";\nimport { diffPngBuffers } from \"../golden/diffPng.js\";\nimport {\n goldenImagePath,\n loadManifest,\n saveGoldenImage,\n saveManifest,\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/**\n * Defines a Playwright suite that golden-image-tests every story in\n * `config`'s own target (the one target in `config.targets` not marked\n * `sourceOfTruth`). Call this with a top-level `await` from a Playwright\n * `*.spec.ts` file — it calls `test.describe` at module scope, so it must\n * run inside Playwright's test runner during test-graph compilation.\n *\n * Two independent checks per story, neither of which boots the\n * source-of-truth adapter's own Storybook — the divergence check below\n * compares stored golden files, not live pages:\n *\n * 1. **Own-drift (hard fail):** this run's live render vs this project's own\n * stored `test/golden/<story-id>.png`. No golden yet for a story is not a\n * failure — one is captured from this run instead (same as\n * `--update-golden`, scoped to just that story).\n * 2. **Source-of-truth divergence (soft flag, never fails the run):** this\n * project's own golden vs the source-of-truth's golden (`config`'s\n * `sourceOfTruthGolden`). Skipped entirely when\n * `config.isSourceOfTruthAdapter` is true — the source-of-truth adapter\n * has nothing above it to diverge from — and skipped per-story when\n * neither side has a baseline yet. A once-flagged divergence stays quiet\n * after `--approve-divergence`, until the source of truth's own golden\n * changes again.\n */\nexport async function runVisualRegression(\n config: AdapterTesterConfig,\n): Promise<void> {\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 excludeStoryIds = config.excludeStoryIds ?? [];\n const storyThresholds = config.storyThresholds ?? {};\n const goldenDir = config.goldenDir;\n const goldenMode = config.goldenMode;\n\n const stories = await fetchStories(\n ownTarget,\n excludeTitlePrefixes,\n excludeStoryIds,\n );\n const manifest = loadManifest(goldenDir);\n\n const sourceOfTruthGolden =\n config.isSourceOfTruthAdapter || !config.sourceOfTruthGolden\n ? null\n : await resolveSourceOfTruthGolden(config.sourceOfTruthGolden);\n\n test.describe(`${ownTarget.name} — Golden Image Visual Regression`, () => {\n for (const story of stories) {\n test(`Golden regression for: ${story.title} - ${story.name} (${story.id})`, async ({\n browser,\n }, 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 const entry = manifest[story.id];\n const capturingNewGolden =\n goldenMode !== \"check\" || !entry || !existsSync(imagePath);\n\n if (capturingNewGolden) {\n saveGoldenImage(goldenDir, story.id, liveBuffer);\n manifest[story.id] = 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 const goldenBuffer = readFileSync(imagePath);\n const diffPixels = diffPngBuffers(liveBuffer, goldenBuffer);\n await testInfo.attach(\"Live vs Golden Diff\", {\n body: `${diffPixels} mismatched pixels`,\n contentType: \"text/plain\",\n });\n const threshold = resolveThreshold(\n story.id,\n storyThresholds,\n config.diffThresholdPixels,\n );\n expect\n .soft(\n diffPixels,\n `\"${story.id}\" has drifted from its own golden image`,\n )\n .toBeLessThan(threshold);\n }\n\n // Guaranteed set by the branch above — either just captured, or\n // already present since !capturingNewGolden implies `entry` existed.\n const currentEntry = manifest[story.id]!;\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 manifest[story.id] = {\n ...currentEntry,\n sourceOfTruthCreatedAt: sourceOfTruthEntry.createdAt,\n };\n } else {\n const ownImage = readFileSync(imagePath);\n const diffPixels = diffPngBuffers(ownImage, sourceOfTruthImage);\n const approvedAt = currentEntry.sourceOfTruthCreatedAt;\n const isKnownDivergence =\n diffPixels === 0 ||\n (approvedAt !== undefined &&\n approvedAt >= sourceOfTruthEntry.createdAt);\n if (!isKnownDivergence) {\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 // Playwright runs this generated spec with workers: 1 specifically so\n // this read-modify-write is never racing another story's test body.\n saveManifest(goldenDir, manifest);\n });\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","goldenImagePath","storyId","loadManifest","existsSync","readFileSync","saveManifest","manifest","sorted","key","mkdirSync","writeFileSync","saveGoldenImage","buffer","GITHUB_REPO","resolveNpmVersion","packageName","versionSpec","response","resolved","_b","packageDirectory","resolveSourceOfTruthGolden","location","version","cacheDir","tag","rawBase","cachedManifestPath","text","parsed","cachedImagePath","DEFAULT_EXCLUDE_TITLE_PREFIXES","matchesPrefix","id","prefix","fetchStories","target","excludeTitlePrefixes","excludeStoryIds","stories","entries","entry","resolveThreshold","storyThresholds","diffThresholdPixels","bestMatch","runVisualRegression","config","ownTarget","goldenMode","sourceOfTruthGolden","test","story","browser","testInfo","page","liveBuffer","imagePath","goldenBuffer","diffPixels","threshold","expect","currentEntry","sourceOfTruthEntry","sourceOfTruthImage","ownImage","approvedAt"],"mappings":"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"}