@recursica/adapter-tester 1.1.0 → 2.0.0

package/dist/mantineSourceOfTruth-DCoJ2dU-.cjs

@@ -0,0 +1,54 @@
+"use strict";const o=require("node:fs"),t=require("node:path"),i="^8.0.0",s="^10.3.3",n="^19.0.0",m={"@storybook/addon-docs":s,"@storybook/addon-a11y":s,"storybook-dark-mode":"^5.0.0"},p={"react-markdown":"^10.1.0"};function l(e){return{name:"adapter-tester-mantine-source-of-truth-harness",private:!0,type:"module",scripts:{storybook:`storybook dev -p ${e.port}`},dependencies:{"@recursica/mantine-adapter":e.mantineAdapterVersion,"@recursica/storybook-template":e.storybookTemplateVersion,"@recursica/official-release":"latest","@recursica/adapter-common":"latest","@mantine/core":i,"@mantine/dates":i,react:n,"react-dom":n,storybook:s,"@storybook/react-vite":s,...m,...p}}}const f=`import { createMainConfig } from "@recursica/storybook-template/main";
+
+const config = createMainConfig({
+  stories: [
+    "../node_modules/@recursica/mantine-adapter/src/**/*.stories.@(js|jsx|mjs|ts|tsx)",
+  ],
+  enableCORS: true,
+});
+
+// react-docgen-typescript can't resolve a TS project for a config file living
+// in .storybook/ when the component source it's docgen'ing lives three
+// directories down inside node_modules — it throws "Cannot read properties
+// of undefined (reading 'fileExists')", which surfaces as a plain 404 on
+// preview.tsx. Docgen only powers Storybook's Controls/Docs tables, which
+// this harness never renders, so disabling it is a safe workaround (see
+// PROPOSAL-installed-package-harness.md, gap 3).
+config.typescript = { ...config.typescript, reactDocgen: false };
+
+export default config;
+`,y=`import type { Preview } from "@storybook/react-vite";
+import { createPreviewConfig } from "@recursica/storybook-template/preview";
+import { MantineProvider } from "@mantine/core";
+import "@mantine/core/styles.css";
+import "@mantine/dates/styles.css";
+import "@recursica/adapter-common/style.css";
+import "@recursica/official-release/recursica_variables_scoped.css";
+import recursicaTokens from "@recursica/official-release/recursica_tokens.json";
+import recursicaBrand from "@recursica/official-release/recursica_brand.json";
+import recursicaUIKit from "@recursica/official-release/recursica_ui-kit.json";
+
+const basePreview = createPreviewConfig({
+  defaultTheme: "light",
+  recursicaTokensJsonPath: recursicaTokens,
+  recursicaBrandJsonPath: recursicaBrand,
+  recursicaUIKitJsonPath: recursicaUIKit,
+});
+
+const preview: Preview = {
+  ...basePreview,
+  decorators: [
+    (Story) => (
+      <MantineProvider>
+        <Story />
+      </MantineProvider>
+    ),
+    ...(basePreview.decorators || []),
+  ],
+};
+
+export default preview;
+`;function a(e){const{dir:r,port:c,mantineAdapterVersion:u="latest",storybookTemplateVersion:d="latest"}=e;return o.mkdirSync(t.join(r,".storybook"),{recursive:!0}),o.writeFileSync(t.join(r,"package.json"),JSON.stringify(l({mantineAdapterVersion:u,storybookTemplateVersion:d,port:c}),null,2)+`
+`),o.writeFileSync(t.join(r,".storybook/main.ts"),f),o.writeFileSync(t.join(r,".storybook/preview.tsx"),y),o.writeFileSync(t.join(r,".gitignore"),`node_modules
+`),r}function k(e){const r=a(e);return{command:"npm install --no-audit --no-fund && npm run storybook",port:e.port,cwd:r,reuseExistingServer:!process.env.CI,timeout:180*1e3}}exports.mantineSourceOfTruthWebServer=k;exports.scaffoldMantineSourceOfTruthHarness=a;
+//# sourceMappingURL=mantineSourceOfTruth-DCoJ2dU-.cjs.map

package/dist/mantineSourceOfTruth-DCoJ2dU-.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mantineSourceOfTruth-DCoJ2dU-.cjs","sources":["../src/harness/mantineSourceOfTruth.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/**\n * Generates a small, throwaway Storybook project that installs\n * `@recursica/mantine-adapter` as a real npm dependency (not a workspace\n * link) and boots a real Storybook from its published `src/**\\/*.stories.tsx`\n * files, using `@recursica/storybook-template`'s exported factories.\n *\n * This lets any repo — including ones that never checked out the Recursica\n * monorepo — run adapter-tester's visual regression suite against Mantine\n * (Recursica's source-of-truth adapter) as one side of the comparison, while\n * the other side is that repo's own already-running local Storybook.\n *\n * See PROPOSAL-installed-package-harness.md for the verified prototype this\n * is built from, and the three upstream gaps it works around.\n */\n\nexport interface MantineSourceOfTruthHarnessOptions {\n  /**\n   * Directory the harness project is scaffolded into. Regenerated on every\n   * call — add it to your .gitignore rather than committing it.\n   */\n  dir: string;\n  /** Port the harness's Storybook dev server boots on. */\n  port: number;\n  /** npm version/range for @recursica/mantine-adapter. Defaults to \"latest\". */\n  mantineAdapterVersion?: string;\n  /** npm version/range for @recursica/storybook-template. Defaults to \"latest\". */\n  storybookTemplateVersion?: string;\n}\n\nexport interface HarnessWebServerConfig {\n  command: string;\n  port: number;\n  cwd: string;\n  reuseExistingServer: boolean;\n  timeout: number;\n}\n\n// Peer/dev ranges pinned to what @recursica/mantine-adapter and\n// @recursica/storybook-template themselves require, so the harness can't\n// drift onto an incompatible Mantine or Storybook major version.\nconst MANTINE_CORE_RANGE = \"^8.0.0\";\nconst STORYBOOK_RANGE = \"^10.3.3\";\nconst REACT_RANGE = \"^19.0.0\";\n\n// storybook-template's createMainConfig() defaults its addons list to these\n// three but doesn't declare them as peerDependencies (proposal gap 2) — a\n// harness that skips installing any of them gets a silent \"could not\n// resolve addon\" warning at boot, then a hard runtime crash later when Vite\n// pre-bundles preview.tsx's dependency graph. Installed explicitly here.\nconst DEFAULT_ADDON_DEPENDENCIES = {\n  \"@storybook/addon-docs\": STORYBOOK_RANGE,\n  \"@storybook/addon-a11y\": STORYBOOK_RANGE,\n  \"storybook-dark-mode\": \"^5.0.0\",\n};\n\n// mantine-adapter's Introduction.stories.tsx (Version.tsx/OverStyling.tsx)\n// needs react-markdown, but it's a devDependency there — Storybook-only,\n// never bundled into dist — so an external `npm install` of the published\n// package won't pull it in. The harness boots a real Storybook against\n// src/, so it must provide this itself. Installed explicitly here.\nconst WORKAROUND_DEPENDENCIES = {\n  \"react-markdown\": \"^10.1.0\",\n};\n\nfunction harnessPackageJson(options: {\n  mantineAdapterVersion: string;\n  storybookTemplateVersion: string;\n  port: number;\n}) {\n  return {\n    name: \"adapter-tester-mantine-source-of-truth-harness\",\n    private: true,\n    type: \"module\",\n    scripts: {\n      storybook: `storybook dev -p ${options.port}`,\n    },\n    dependencies: {\n      \"@recursica/mantine-adapter\": options.mantineAdapterVersion,\n      \"@recursica/storybook-template\": options.storybookTemplateVersion,\n      \"@recursica/official-release\": \"latest\",\n      \"@recursica/adapter-common\": \"latest\",\n      \"@mantine/core\": MANTINE_CORE_RANGE,\n      \"@mantine/dates\": MANTINE_CORE_RANGE,\n      react: REACT_RANGE,\n      \"react-dom\": REACT_RANGE,\n      storybook: STORYBOOK_RANGE,\n      \"@storybook/react-vite\": STORYBOOK_RANGE,\n      ...DEFAULT_ADDON_DEPENDENCIES,\n      ...WORKAROUND_DEPENDENCIES,\n    },\n  };\n}\n\nconst MAIN_TS = `import { createMainConfig } from \"@recursica/storybook-template/main\";\n\nconst config = createMainConfig({\n  stories: [\n    \"../node_modules/@recursica/mantine-adapter/src/**/*.stories.@(js|jsx|mjs|ts|tsx)\",\n  ],\n  enableCORS: true,\n});\n\n// react-docgen-typescript can't resolve a TS project for a config file living\n// in .storybook/ when the component source it's docgen'ing lives three\n// directories down inside node_modules — it throws \"Cannot read properties\n// of undefined (reading 'fileExists')\", which surfaces as a plain 404 on\n// preview.tsx. Docgen only powers Storybook's Controls/Docs tables, which\n// this harness never renders, so disabling it is a safe workaround (see\n// PROPOSAL-installed-package-harness.md, gap 3).\nconfig.typescript = { ...config.typescript, reactDocgen: false };\n\nexport default config;\n`;\n\nconst PREVIEW_TSX = `import type { Preview } from \"@storybook/react-vite\";\nimport { createPreviewConfig } from \"@recursica/storybook-template/preview\";\nimport { MantineProvider } from \"@mantine/core\";\nimport \"@mantine/core/styles.css\";\nimport \"@mantine/dates/styles.css\";\nimport \"@recursica/adapter-common/style.css\";\nimport \"@recursica/official-release/recursica_variables_scoped.css\";\nimport recursicaTokens from \"@recursica/official-release/recursica_tokens.json\";\nimport recursicaBrand from \"@recursica/official-release/recursica_brand.json\";\nimport recursicaUIKit from \"@recursica/official-release/recursica_ui-kit.json\";\n\nconst basePreview = createPreviewConfig({\n  defaultTheme: \"light\",\n  recursicaTokensJsonPath: recursicaTokens,\n  recursicaBrandJsonPath: recursicaBrand,\n  recursicaUIKitJsonPath: recursicaUIKit,\n});\n\nconst preview: Preview = {\n  ...basePreview,\n  decorators: [\n    (Story) => (\n      <MantineProvider>\n        <Story />\n      </MantineProvider>\n    ),\n    ...(basePreview.decorators || []),\n  ],\n};\n\nexport default preview;\n`;\n\n/** Writes the harness project's files to `options.dir` without booting it. */\nexport function scaffoldMantineSourceOfTruthHarness(\n  options: MantineSourceOfTruthHarnessOptions,\n): string {\n  const {\n    dir,\n    port,\n    mantineAdapterVersion = \"latest\",\n    storybookTemplateVersion = \"latest\",\n  } = options;\n\n  mkdirSync(join(dir, \".storybook\"), { recursive: true });\n  writeFileSync(\n    join(dir, \"package.json\"),\n    JSON.stringify(\n      harnessPackageJson({\n        mantineAdapterVersion,\n        storybookTemplateVersion,\n        port,\n      }),\n      null,\n      2,\n    ) + \"\\n\",\n  );\n  writeFileSync(join(dir, \".storybook/main.ts\"), MAIN_TS);\n  writeFileSync(join(dir, \".storybook/preview.tsx\"), PREVIEW_TSX);\n  writeFileSync(join(dir, \".gitignore\"), \"node_modules\\n\");\n\n  return dir;\n}\n\n/**\n * Scaffolds the harness and returns a Playwright `webServer` entry for it.\n * Spread the result directly into `playwright.config.ts`'s `webServer` array.\n */\nexport function mantineSourceOfTruthWebServer(\n  options: MantineSourceOfTruthHarnessOptions,\n): HarnessWebServerConfig {\n  const dir = scaffoldMantineSourceOfTruthHarness(options);\n  return {\n    command: \"npm install --no-audit --no-fund && npm run storybook\",\n    port: options.port,\n    cwd: dir,\n    reuseExistingServer: !process.env.CI,\n    timeout: 180 * 1000,\n  };\n}\n"],"names":["MANTINE_CORE_RANGE","STORYBOOK_RANGE","REACT_RANGE","DEFAULT_ADDON_DEPENDENCIES","WORKAROUND_DEPENDENCIES","harnessPackageJson","options","MAIN_TS","PREVIEW_TSX","scaffoldMantineSourceOfTruthHarness","dir","port","mantineAdapterVersion","storybookTemplateVersion","mkdirSync","join","writeFileSync","mantineSourceOfTruthWebServer"],"mappings":"+DA2CMA,EAAqB,SACrBC,EAAkB,UAClBC,EAAc,UAOdC,EAA6B,CACjC,wBAAyBF,EACzB,wBAAyBA,EACzB,sBAAuB,QACzB,EAOMG,EAA0B,CAC9B,iBAAkB,SACpB,EAEA,SAASC,EAAmBC,EAIzB,CACD,MAAO,CACL,KAAM,iDACN,QAAS,GACT,KAAM,SACN,QAAS,CACP,UAAW,oBAAoBA,EAAQ,IAAI,EAAA,EAE7C,aAAc,CACZ,6BAA8BA,EAAQ,sBACtC,gCAAiCA,EAAQ,yBACzC,8BAA+B,SAC/B,4BAA6B,SAC7B,gBAAiBN,EACjB,iBAAkBA,EAClB,MAAOE,EACP,YAAaA,EACb,UAAWD,EACX,wBAAyBA,EACzB,GAAGE,EACH,GAAGC,CAAA,CACL,CAEJ,CAEA,MAAMG,EAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBVC,EAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkCb,SAASC,EACdH,EACQ,CACR,KAAM,CACJ,IAAAI,EACA,KAAAC,EACA,sBAAAC,EAAwB,SACxB,yBAAAC,EAA2B,QAAA,EACzBP,EAEJQ,OAAAA,EAAAA,UAAUC,EAAAA,KAAKL,EAAK,YAAY,EAAG,CAAE,UAAW,GAAM,EACtDM,EAAAA,cACED,EAAAA,KAAKL,EAAK,cAAc,EACxB,KAAK,UACHL,EAAmB,CACjB,sBAAAO,EACA,yBAAAC,EACA,KAAAF,CAAA,CACD,EACD,KACA,CAAA,EACE;AAAA,CAAA,EAENK,EAAAA,cAAcD,EAAAA,KAAKL,EAAK,oBAAoB,EAAGH,CAAO,EACtDS,EAAAA,cAAcD,EAAAA,KAAKL,EAAK,wBAAwB,EAAGF,CAAW,EAC9DQ,EAAAA,cAAcD,EAAAA,KAAKL,EAAK,YAAY,EAAG;AAAA,CAAgB,EAEhDA,CACT,CAMO,SAASO,EACdX,EACwB,CACxB,MAAMI,EAAMD,EAAoCH,CAAO,EACvD,MAAO,CACL,QAAS,wDACT,KAAMA,EAAQ,KACd,IAAKI,EACL,oBAAqB,CAAC,QAAQ,IAAI,GAClC,QAAS,IAAM,GAAA,CAEnB"}

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

@@ -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;AAyEvE;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAkJf"}
+{"version":3,"file":"runVisualRegression.d.ts","sourceRoot":"","sources":["../../src/testing/runVisualRegression.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA2EvE;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiJf"}

package/dist/testing.cjs.map

@@ -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(`Failed to fetch Storybook index: ${response.statusText}`);\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 * 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  for (const target of targets) {\n    test.describe(\n      `${sourceOfTruth.name} vs ${target.name} — Dynamic Visual Regression Suite`,\n      () => {\n        for (const story of stories) {\n          test(`Visual regression for: ${story.title} - ${story.name} (${story.id})`, async (\n            { browser },\n            testInfo,\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(`${sourceOfTruth.name} Screenshot (Source of Truth)`, {\n              body: sourceBuffer,\n              contentType: \"image/png\",\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}\n"],"names":["DEFAULT_EXCLUDE_TITLE_PREFIXES","COMMON_STYLES_TO_CAPTURE","slug","name","fetchStories","sourceOfTruth","excludeTitlePrefixes","stories","response","entries","entry","prefix","b","error","runVisualRegression","config","getSourceOfTruth","targets","target","relaxedThresholdStoryIds","relaxedThresholdPixels","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.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 * 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  for (const target of targets) {\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          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","b","error","runVisualRegression","config","getSourceOfTruth","targets","target","relaxedThresholdStoryIds","relaxedThresholdPixels","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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"}

package/dist/testing.js

@@ -2,7 +2,7 @@ import { test as M, expect as J } from "@playwright/test";
 import _ from "pixelmatch";
 import { PNG as h } from "pngjs";
 import g from "node:fs";
-import { g as U } from "./config-CKgyDyNF.js";
+import { g as U } from "./config-CDxTeSAY.js";
 const z = ["Theme", "Tokens", "Introduction"], j = [
   "color",
   "background-color",
@@ -33,7 +33,9 @@ async function R(t, r) {
   try {
     const i = await fetch(`${t.url}/index.json`);
     if (!i.ok)
-      throw new Error(`Failed to fetch Storybook index: ${i.statusText}`);
+      throw new Error(
+        `Failed to fetch Storybook index: ${i.statusText}`
+      );
     const m = (await i.json()).entries || {};
     c = Object.values(m).filter(
       (a) => a.type === "story" && !r.some(
@@ -54,88 +56,90 @@ async function R(t, r) {
 async function G(t) {
   const r = U(t), c = t.targets.filter((e) => !e.sourceOfTruth), i = t.excludeTitlePrefixes ?? z, $ = t.relaxedThresholdStoryIds ?? [], m = t.relaxedThresholdPixels, a = await R(r, i);
   for (const e of c)
-    M.describe(
-      `${r.name} vs ${e.name} — Dynamic Visual Regression Suite`,
-      () => {
-        for (const o of a)
-          M(`Visual regression for: ${o.title} - ${o.name} (${o.id})`, async ({ browser: b }, l) => {
-            const s = await b.newPage(), n = await b.newPage();
-            await s.setViewportSize({ width: 800, height: 600 }), await n.setViewportSize({ width: 800, height: 600 }), await Promise.all([
-              s.goto(
-                `${r.url}/iframe.html?id=${o.id}&viewMode=story`,
-                { waitUntil: "networkidle" }
-              ),
-              n.goto(
-                `${e.url}/iframe.html?id=${o.id}&viewMode=story`,
-                { waitUntil: "networkidle" }
-              )
-            ]), await Promise.all([
-              s.waitForSelector("#storybook-root"),
-              n.waitForSelector("#storybook-root")
-            ]), await Promise.all([
-              s.waitForTimeout(300),
-              n.waitForTimeout(300)
-            ]);
-            const x = (y) => {
-              function D(S) {
-                const T = {
-                  tag: S.tagName.toLowerCase(),
-                  styles: {},
-                  children: []
-                }, V = window.getComputedStyle(S);
-                for (const u of y)
-                  T.styles[u] = V.getPropertyValue(u);
-                for (const u of Array.from(S.children))
-                  T.children.push(D(u));
-                return T;
-              }
-              const E = document.querySelector("#storybook-root");
-              return E ? D(E) : null;
-            }, O = await s.evaluate(
-              x,
-              j
-            ), P = await n.evaluate(
-              x,
-              j
-            );
-            await l.attach(`${r.name} DOM Tree JSON`, {
-              body: JSON.stringify(O, null, 2),
-              contentType: "application/json"
-            }), await l.attach(`${e.name} DOM Tree JSON`, {
-              body: JSON.stringify(P, null, 2),
-              contentType: "application/json"
-            });
-            const F = v(r.name), k = v(e.name);
-            g.writeFileSync(
-              `/tmp/${o.id}-${F}DOM.json`,
-              JSON.stringify(O, null, 2)
-            ), g.writeFileSync(
-              `/tmp/${o.id}-${k}DOM.json`,
-              JSON.stringify(P, null, 2)
-            );
-            const w = await s.screenshot(), f = await n.screenshot(), d = h.sync.read(w), N = h.sync.read(f), p = new h({ width: d.width, height: d.height }), C = _(
-              d.data,
-              N.data,
-              p.data,
-              d.width,
-              d.height,
-              { threshold: 0.1 }
-            );
-            g.writeFileSync(`/tmp/${o.id}-diff.png`, h.sync.write(p)), g.writeFileSync(`/tmp/${o.id}-${F}.png`, w), g.writeFileSync(`/tmp/${o.id}-${k}.png`, f), await l.attach("Visual Diff Overlay", {
-              body: h.sync.write(p),
-              contentType: "image/png"
-            }), await l.attach(`${r.name} Screenshot (Source of Truth)`, {
+    M.describe(`${r.name} vs ${e.name} — Dynamic Visual Regression Suite`, () => {
+      for (const o of a)
+        M(`Visual regression for: ${o.title} - ${o.name} (${o.id})`, async ({
+          browser: b
+        }, l) => {
+          const s = await b.newPage(), n = await b.newPage();
+          await s.setViewportSize({ width: 800, height: 600 }), await n.setViewportSize({ width: 800, height: 600 }), await Promise.all([
+            s.goto(
+              `${r.url}/iframe.html?id=${o.id}&viewMode=story`,
+              { waitUntil: "networkidle" }
+            ),
+            n.goto(
+              `${e.url}/iframe.html?id=${o.id}&viewMode=story`,
+              { waitUntil: "networkidle" }
+            )
+          ]), await Promise.all([
+            s.waitForSelector("#storybook-root"),
+            n.waitForSelector("#storybook-root")
+          ]), await Promise.all([
+            s.waitForTimeout(300),
+            n.waitForTimeout(300)
+          ]);
+          const x = (y) => {
+            function D(S) {
+              const T = {
+                tag: S.tagName.toLowerCase(),
+                styles: {},
+                children: []
+              }, V = window.getComputedStyle(S);
+              for (const u of y)
+                T.styles[u] = V.getPropertyValue(u);
+              for (const u of Array.from(S.children))
+                T.children.push(D(u));
+              return T;
+            }
+            const E = document.querySelector("#storybook-root");
+            return E ? D(E) : null;
+          }, O = await s.evaluate(
+            x,
+            j
+          ), P = await n.evaluate(
+            x,
+            j
+          );
+          await l.attach(`${r.name} DOM Tree JSON`, {
+            body: JSON.stringify(O, null, 2),
+            contentType: "application/json"
+          }), await l.attach(`${e.name} DOM Tree JSON`, {
+            body: JSON.stringify(P, null, 2),
+            contentType: "application/json"
+          });
+          const F = v(r.name), k = v(e.name);
+          g.writeFileSync(
+            `/tmp/${o.id}-${F}DOM.json`,
+            JSON.stringify(O, null, 2)
+          ), g.writeFileSync(
+            `/tmp/${o.id}-${k}DOM.json`,
+            JSON.stringify(P, null, 2)
+          );
+          const w = await s.screenshot(), f = await n.screenshot(), d = h.sync.read(w), N = h.sync.read(f), p = new h({ width: d.width, height: d.height }), C = _(
+            d.data,
+            N.data,
+            p.data,
+            d.width,
+            d.height,
+            { threshold: 0.1 }
+          );
+          g.writeFileSync(`/tmp/${o.id}-diff.png`, h.sync.write(p)), g.writeFileSync(`/tmp/${o.id}-${F}.png`, w), g.writeFileSync(`/tmp/${o.id}-${k}.png`, f), await l.attach("Visual Diff Overlay", {
+            body: h.sync.write(p),
+            contentType: "image/png"
+          }), await l.attach(
+            `${r.name} Screenshot (Source of Truth)`,
+            {
               body: w,
               contentType: "image/png"
-            }), await l.attach(`${e.name} Screenshot (Target)`, {
-              body: f,
-              contentType: "image/png"
-            });
-            const L = m !== void 0 && $.some((y) => o.id.startsWith(y)) ? m : t.diffThresholdPixels;
-            J.soft(C).toBeLessThan(L);
+            }
+          ), await l.attach(`${e.name} Screenshot (Target)`, {
+            body: f,
+            contentType: "image/png"
           });
-      }
-    );
+          const L = m !== void 0 && $.some((y) => o.id.startsWith(y)) ? m : t.diffThresholdPixels;
+          J.soft(C).toBeLessThan(L);
+        });
+    });
 }
 export {
   G as runVisualRegression

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(`Failed to fetch Storybook index: ${response.statusText}`);\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 * 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  for (const target of targets) {\n    test.describe(\n      `${sourceOfTruth.name} vs ${target.name} — Dynamic Visual Regression Suite`,\n      () => {\n        for (const story of stories) {\n          test(`Visual regression for: ${story.title} - ${story.name} (${story.id})`, async (\n            { browser },\n            testInfo,\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(`${sourceOfTruth.name} Screenshot (Source of Truth)`, {\n              body: sourceBuffer,\n              contentType: \"image/png\",\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}\n"],"names":["DEFAULT_EXCLUDE_TITLE_PREFIXES","COMMON_STYLES_TO_CAPTURE","slug","name","fetchStories","sourceOfTruth","excludeTitlePrefixes","stories","response","entries","entry","prefix","b","error","runVisualRegression","config","getSourceOfTruth","targets","target","relaxedThresholdStoryIds","relaxedThresholdPixels","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/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 * 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  for (const target of targets) {\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          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","b","error","runVisualRegression","config","getSourceOfTruth","targets","target","relaxedThresholdStoryIds","relaxedThresholdPixels","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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"}

package/dist/validateFileConfig.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validates a parsed `adapter-tester.config.json` against
+ * `adapter-tester.schema.json`. Throws with every violation listed — callers
+ * must not silently coerce or drop invalid fields.
+ */
+export declare function validateFileConfig(data: unknown, path: string): void;
+//# sourceMappingURL=validateFileConfig.d.ts.map

package/dist/validateFileConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateFileConfig.d.ts","sourceRoot":"","sources":["../src/validateFileConfig.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYpE"}

package/package.json

@@ -13,7 +13,7 @@
     "url": "git+https://github.com/borderux/recursica.git",
     "directory": "packages/adapter-tester"
   },
-  "version": "1.1.0",
+  "version": "2.0.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -31,7 +31,10 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "public",
+    "report-header.txt",
+    "src/adapter-tester.schema.json"
   ],
   "keywords": [
     "recursica",
@@ -40,12 +43,21 @@
     "testing",
     "playwright"
   ],
+  "bin": {
+    "adapter-tester": "./dist/cli.js"
+  },
   "scripts": {
     "build": "vite build --mode library",
-    "test:visual": "playwright test",
-    "dev": "ts-node src/dev.ts"
+    "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"
   },
   "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^2.1.1",
+    "express": "^5.2.1",
+    "http-proxy-middleware": "^4.0.0",
     "pixelmatch": "^7.2.0",
     "pngjs": "^7.0.0"
   },
@@ -55,13 +67,11 @@
   "devDependencies": {
     "@playwright/test": "^1.60.0",
     "@repo/typescript-config": "*",
+    "@types/express": "^5.0.0",
     "@types/node": "^25.9.1",
     "@types/pixelmatch": "^5.2.6",
     "@types/pngjs": "^6.0.5",
-    "express": "^5.2.1",
-    "http-proxy-middleware": "^4.0.0",
     "playwright": "^1.60.0",
-    "ts-node": "^10.9.2",
     "tsx": "^4.22.3",
     "typescript": "~5.8.3",
     "vite": "^6.3.5",