@recursica/adapter-tester 3.0.0 → 5.0.0

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sources":["../src/golden/diffPng.ts","../src/golden/validateManifest.ts","../src/golden/manifestStore.ts","../src/golden/resolveSourceOfTruthGolden.ts","../src/testing/runVisualRegression.ts"],"sourcesContent":["import pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\n\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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"}
+{"version":3,"file":"testing.js","sources":["../src/golden/diffPng.ts","../src/golden/validateManifest.ts","../src/golden/manifestStore.ts","../src/golden/resolveSourceOfTruthGolden.ts","../src/testing/runVisualRegression.ts"],"sourcesContent":["import pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\n\nexport interface PngDiffResult {\n  /** Mismatched-pixel count, or `Infinity` if the two images aren't even the\n   * same dimensions — pixelmatch itself throws on a size mismatch, and a size\n   * mismatch is itself a real difference, not something to swallow. */\n  diffPixels: number;\n  /** Visual highlight of the mismatched pixels, encoded as a PNG buffer.\n   * `null` when `diffPixels` is `Infinity` — there's no pixel-aligned diff to\n   * render across two different-sized images. */\n  diffImage: Buffer | null;\n}\n\n/** Pixel-diffs two PNG buffers. */\nexport function diffPngBuffers(a: Buffer, b: Buffer): PngDiffResult {\n  const imgA = PNG.sync.read(a);\n  const imgB = PNG.sync.read(b);\n  if (imgA.width !== imgB.width || imgA.height !== imgB.height) {\n    return { diffPixels: Infinity, diffImage: null };\n  }\n  const diff = new PNG({ width: imgA.width, height: imgA.height });\n  const diffPixels = pixelmatch(\n    imgA.data,\n    imgB.data,\n    diff.data,\n    imgA.width,\n    imgA.height,\n    { threshold: 0.1 },\n  );\n  return { diffPixels, diffImage: PNG.sync.write(diff) };\n}\n","import { Ajv } from \"ajv\";\nimport * as ajvFormatsModule from \"ajv-formats\";\nimport type { FormatsPlugin } from \"ajv-formats\";\nimport schema from \"./manifest.schema.json\" with { type: \"json\" };\n\n// See validateFileConfig.ts for why `.default` has to be unwrapped by hand.\nconst addFormats = (ajvFormatsModule as unknown as { default: FormatsPlugin })\n  .default;\n\nconst ajv = new Ajv({ allErrors: true, strict: true });\naddFormats(ajv);\nconst validate = ajv.compile(schema);\n\n/**\n * Validates a parsed `test/golden/manifest.json` against `manifest.schema.json`.\n * Throws with every violation listed — callers must not silently coerce or\n * drop invalid entries.\n */\nexport function validateGoldenManifest(data: unknown, path: string): void {\n  if (validate(data)) return;\n\n  const errors = (validate.errors ?? [])\n    .map((error) => {\n      const extra = error.params?.additionalProperty\n        ? ` '${error.params.additionalProperty}'`\n        : \"\";\n      return `  - ${error.instancePath || \"root\"} ${error.message}${extra}`;\n    })\n    .join(\"\\n\");\n  throw new Error(`Invalid ${path}:\\n${errors}`);\n}\n","import {\n  closeSync,\n  existsSync,\n  mkdirSync,\n  openSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  unlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\nimport { validateGoldenManifest } from \"./validateManifest.js\";\n\nexport interface GoldenManifestEntry {\n  createdAt: string;\n  sourceOfTruthCreatedAt?: string;\n}\n\nexport type GoldenManifest = Record<string, GoldenManifestEntry>;\n\nexport function manifestPath(goldenDir: string): string {\n  return join(goldenDir, \"manifest.json\");\n}\n\nfunction manifestLockPath(goldenDir: string): string {\n  return join(goldenDir, \"manifest.json.lock\");\n}\n\nexport function goldenImagePath(goldenDir: string, storyId: string): string {\n  return join(goldenDir, `${storyId}.png`);\n}\n\n/** Returns `{}` if no manifest exists yet — a fresh adapter with no goldens\n * captured is the normal starting state, not an error. */\nexport function loadManifest(goldenDir: string): GoldenManifest {\n  const path = manifestPath(goldenDir);\n  if (!existsSync(path)) return {};\n  const data = JSON.parse(readFileSync(path, \"utf8\"));\n  validateGoldenManifest(data, path);\n  return data;\n}\n\n/** Validates before writing, and sorts keys so the diff on a reviewed PR is\n * stable regardless of the order stories happened to run in. Writes to a\n * temp file and renames over the real one — `rename` is atomic, so a\n * concurrent `loadManifest` (running in another Playwright worker) never\n * observes a half-written file. */\nexport function saveManifest(\n  goldenDir: string,\n  manifest: GoldenManifest,\n): void {\n  const path = manifestPath(goldenDir);\n  validateGoldenManifest(manifest, path);\n  const sorted: GoldenManifest = {};\n  for (const key of Object.keys(manifest).sort()) {\n    sorted[key] = manifest[key]!;\n  }\n  mkdirSync(goldenDir, { recursive: true });\n  const tmpPath = `${path}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  writeFileSync(tmpPath, JSON.stringify(sorted, null, 2) + \"\\n\");\n  renameSync(tmpPath, path);\n}\n\nconst LOCK_RETRY_MS = 25;\nconst LOCK_TIMEOUT_MS = 15_000;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Exclusive-create the lock file, spin-retrying until it's free. `wx` fails\n * atomically (`EEXIST`) if another worker process already holds it — that's\n * the only signal we need, no third-party lock library required for a\n * same-machine, same-run lock like this. */\nasync function acquireManifestLock(goldenDir: string): Promise<void> {\n  mkdirSync(goldenDir, { recursive: true });\n  const path = manifestLockPath(goldenDir);\n  const deadline = Date.now() + LOCK_TIMEOUT_MS;\n  for (;;) {\n    try {\n      closeSync(openSync(path, \"wx\"));\n      return;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n      if (Date.now() >= deadline) {\n        throw new Error(\n          `Timed out waiting for the manifest lock at \"${path}\" — delete it if a previous run crashed while holding it.`,\n        );\n      }\n      await sleep(LOCK_RETRY_MS);\n    }\n  }\n}\n\nfunction releaseManifestLock(goldenDir: string): void {\n  rmSync(manifestLockPath(goldenDir), { force: true });\n}\n\n/** Runs `updater` against this story's manifest entry under an exclusive\n * lock on `manifest.json`: reloads the manifest fresh, applies `updater`,\n * and saves it back, all before releasing the lock. Concurrent Playwright\n * workers each own a different story, so this is the only section that\n * needs to serialize — everything else about a story (its screenshot, its\n * golden image file, its diff) is independent of every other story. */\nexport async function updateManifestEntry(\n  goldenDir: string,\n  storyId: string,\n  updater: (\n    entry: GoldenManifestEntry | undefined,\n  ) => GoldenManifestEntry | undefined,\n): Promise<GoldenManifestEntry | undefined> {\n  await acquireManifestLock(goldenDir);\n  try {\n    const manifest = loadManifest(goldenDir);\n    const nextEntry = updater(manifest[storyId]);\n    if (nextEntry === undefined) {\n      delete manifest[storyId];\n    } else {\n      manifest[storyId] = nextEntry;\n    }\n    saveManifest(goldenDir, manifest);\n    return nextEntry;\n  } finally {\n    releaseManifestLock(goldenDir);\n  }\n}\n\nexport function saveGoldenImage(\n  goldenDir: string,\n  storyId: string,\n  buffer: Buffer,\n): void {\n  mkdirSync(goldenDir, { recursive: true });\n  writeFileSync(goldenImagePath(goldenDir, storyId), buffer);\n}\n\n/** Removes the golden `.png` + manifest entry for every story id in the\n * manifest that isn't in `currentStoryIds` (e.g. a story renamed or deleted\n * from Storybook) — otherwise those never get cleaned up on their own,\n * since a run only ever adds/updates entries for stories it actually saw.\n * Returns the pruned ids, for the caller to report. Both the file removal\n * and the manifest delete are idempotent, so it's safe for this to run\n * redundantly from more than one Playwright worker. */\nexport async function pruneOrphanedGoldens(\n  goldenDir: string,\n  currentStoryIds: ReadonlySet<string>,\n): Promise<string[]> {\n  const manifest = loadManifest(goldenDir);\n  const orphanIds = Object.keys(manifest).filter(\n    (id) => !currentStoryIds.has(id),\n  );\n  for (const id of orphanIds) {\n    const imagePath = goldenImagePath(goldenDir, id);\n    if (existsSync(imagePath)) unlinkSync(imagePath);\n    await updateManifestEntry(goldenDir, id, () => undefined);\n  }\n  return orphanIds;\n}\n","import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { SourceOfTruthGoldenLocation } from \"../config.js\";\nimport {\n  goldenImagePath,\n  loadManifest,\n  manifestPath,\n  type GoldenManifest,\n} from \"./manifestStore.js\";\nimport { validateGoldenManifest } from \"./validateManifest.js\";\n\nconst GITHUB_REPO = \"borderux/recursica\";\n\nexport interface SourceOfTruthGolden {\n  manifest: GoldenManifest;\n  /** Returns the golden PNG bytes for a story, or `null` if the source of\n   * truth has no golden captured for it yet. */\n  readImage(storyId: string): Promise<Buffer | null>;\n}\n\nasync function resolveNpmVersion(\n  packageName: string,\n  versionSpec: string,\n): Promise<string> {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(\n      `Could not reach npm registry for ${packageName}: ${response.statusText}`,\n    );\n  }\n  const data = (await response.json()) as {\n    \"dist-tags\"?: Record<string, string>;\n    versions?: Record<string, unknown>;\n  };\n  const resolved =\n    data[\"dist-tags\"]?.[versionSpec] ??\n    (data.versions?.[versionSpec] ? versionSpec : undefined);\n  if (!resolved) {\n    throw new Error(\n      `${packageName} has no version or dist-tag \"${versionSpec}\" on the npm registry.`,\n    );\n  }\n  return resolved;\n}\n\n// This monorepo's packages all live at `packages/<unscoped-name>` — mirrors\n// the same convention `mantineSourceOfTruthHarness` and every existing\n// `packages/*/package.json`'s `repository.directory` field already assume.\nfunction packageDirectory(packageName: string): string {\n  return `packages/${packageName.split(\"/\").pop()}`;\n}\n\n/**\n * Resolves the source-of-truth adapter's golden images for the divergence\n * check. Never boots a Storybook — both location types resolve to plain\n * files, fetched once and cached, not re-diffed per pixel over the wire.\n *\n * `location.type === \"local\"`: a sibling package already checked out (this\n * monorepo's own `sourceOfTruth.type: \"url\"` mode) — read its\n * `test/golden/` directly, including any uncommitted local changes.\n *\n * `location.type === \"npm\"`: no local checkout (the default, standalone-repo\n * mode) — resolve the installed version against the npm registry, then fetch\n * that exact version's `test/golden/` from the public GitHub repo at the\n * matching release tag (changesets tags every release as\n * `<packageName>@<version>`), caching what's downloaded under `cacheDir`.\n *\n * Returns `null` — degrading the divergence check to a skip, not a failure —\n * when no golden baseline exists yet for this version, or the registry/repo\n * is unreachable.\n */\nexport async function resolveSourceOfTruthGolden(\n  location: SourceOfTruthGoldenLocation,\n): Promise<SourceOfTruthGolden | null> {\n  if (location.type === \"local\") {\n    if (!existsSync(manifestPath(location.dir))) {\n      console.warn(\n        `No golden baseline found yet at ${location.dir} — source-of-truth divergence check skipped for this run.`,\n      );\n      return null;\n    }\n    const manifest = loadManifest(location.dir);\n    return {\n      manifest,\n      async readImage(storyId) {\n        const path = goldenImagePath(location.dir, storyId);\n        return existsSync(path) ? readFileSync(path) : null;\n      },\n    };\n  }\n\n  let version: string;\n  try {\n    version = await resolveNpmVersion(\n      location.packageName,\n      location.versionSpec,\n    );\n  } catch (error) {\n    console.warn(\n      `Could not resolve ${location.packageName}@${location.versionSpec} — source-of-truth divergence check skipped for this run.`,\n      error,\n    );\n    return null;\n  }\n\n  const cacheDir = join(location.cacheDir, version);\n  const tag = `${location.packageName}@${version}`;\n  const rawBase = `https://raw.githubusercontent.com/${GITHUB_REPO}/${tag}/${packageDirectory(location.packageName)}/test/golden`;\n\n  let manifest: GoldenManifest;\n  const cachedManifestPath = manifestPath(cacheDir);\n  if (existsSync(cachedManifestPath)) {\n    manifest = loadManifest(cacheDir);\n  } else {\n    let response: Response;\n    try {\n      response = await fetch(`${rawBase}/manifest.json`);\n    } catch (error) {\n      console.warn(\n        `Could not reach GitHub to fetch ${tag}'s golden baseline — source-of-truth divergence check skipped for this run.`,\n        error,\n      );\n      return null;\n    }\n    if (!response.ok) {\n      console.warn(\n        `No golden baseline published for ${tag} — source-of-truth divergence check skipped for this run.`,\n      );\n      return null;\n    }\n    const text = await response.text();\n    const parsed = JSON.parse(text);\n    validateGoldenManifest(parsed, `${rawBase}/manifest.json`);\n    mkdirSync(cacheDir, { recursive: true });\n    writeFileSync(cachedManifestPath, text);\n    manifest = parsed;\n  }\n\n  return {\n    manifest,\n    async readImage(storyId) {\n      const cachedImagePath = goldenImagePath(cacheDir, storyId);\n      if (existsSync(cachedImagePath)) return readFileSync(cachedImagePath);\n      const response = await fetch(`${rawBase}/${storyId}.png`);\n      if (!response.ok) return null;\n      const buffer = Buffer.from(await response.arrayBuffer());\n      mkdirSync(cacheDir, { recursive: true });\n      writeFileSync(cachedImagePath, buffer);\n      return buffer;\n    },\n  };\n}\n","import { expect } from \"@playwright/test\";\nimport type { Browser, TestInfo } from \"@playwright/test\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport type { AdapterTesterConfig } from \"../config.js\";\nimport { diffPngBuffers } from \"../golden/diffPng.js\";\nimport {\n  type GoldenManifestEntry,\n  goldenImagePath,\n  loadManifest,\n  pruneOrphanedGoldens,\n  saveGoldenImage,\n  updateManifestEntry,\n} from \"../golden/manifestStore.js\";\nimport { resolveSourceOfTruthGolden } from \"../golden/resolveSourceOfTruthGolden.js\";\n\nconst DEFAULT_EXCLUDE_TITLE_PREFIXES = [\"Theme\", \"Tokens\", \"Introduction\"];\n\ninterface StorybookEntry {\n  type: string;\n  id: string;\n  name: string;\n  title: string;\n}\n\nfunction matchesPrefix(id: string, prefix: string): boolean {\n  return id === prefix || id.startsWith(prefix);\n}\n\n/** Fetches every story `target`'s Storybook currently has, filtered only by\n * `excludeTitlePrefixes` — not `stories.<id>.exclude`, so callers can still\n * tell an excluded story apart from one that's genuinely missing. */\nasync function fetchStories(\n  target: { name: string; url: string },\n  excludeTitlePrefixes: 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    ) 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 * `defaultThresholdPixels` when nothing matches. */\nfunction resolveThreshold(\n  storyId: string,\n  storyThresholds: Record<string, number>,\n  defaultThresholdPixels: 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    : defaultThresholdPixels;\n}\n\n/** Everything a generated Playwright spec needs to register the golden-image\n * suite itself. Split out from the actual `test.describe`/`test` calls so\n * those calls execute in the spec file that imports this, not in this\n * library file — otherwise Playwright's HTML report groups every story under\n * this file's own (sourcemapped) path instead of a stable spec name. */\nexport interface VisualRegressionPlan {\n  /** `config`'s own (non-source-of-truth) target name, for the suite title. */\n  ownTargetName: string;\n  /** Suite title suffix describing which check mode is running. */\n  suiteLabel: string;\n  /** Stories to check, already filtered and sorted by id. */\n  stories: StorybookEntry[];\n  /** Story ids the source-of-truth adapter has a golden for but this\n   * project's own Storybook doesn't — empty outside `checkMode: \"divergence\"`\n   * or when `sourceOfTruthGolden` didn't resolve. Excludes ids covered by a\n   * `stories.<id>.exclude` entry: an intentional gap, not a sync failure. */\n  missingFromSourceOfTruth: string[];\n  /** Golden-checks one story. Call this from inside a `test(story.id, ...)`\n   * body — safe to run concurrently across Playwright workers, since each\n   * call only ever reads/writes its own story's manifest entry (locked at\n   * the point it writes it back, so concurrent workers never race each\n   * other's entries — see `updateManifestEntry`). */\n  checkStory: (\n    story: StorybookEntry,\n    browser: Browser,\n    testInfo: TestInfo,\n  ) => Promise<void>;\n}\n\n/** Everything a generated Playwright spec needs to register the golden-image\n * suite itself. Split out from the actual `test.describe`/`test` calls so\n * those calls execute in the spec file that imports this, not in this\n * library file — otherwise Playwright's HTML report groups every story under\n * this file's own (sourcemapped) path instead of a stable spec name. */\nexport interface VisualRegressionPlan {\n  /** `config`'s own (non-source-of-truth) target name, for the suite title. */\n  ownTargetName: string;\n  /** Suite title suffix describing which check mode is running. */\n  suiteLabel: string;\n  /** Stories to check, already filtered and sorted by id. */\n  stories: StorybookEntry[];\n  /** Golden-checks one story. Call this from inside a `test(story.id, ...)`\n   * body — safe to run concurrently across Playwright workers, since each\n   * call only ever reads/writes its own story's manifest entry (locked at\n   * the point it writes it back, so concurrent workers never race each\n   * other's entries — see `updateManifestEntry`). */\n  checkStory: (\n    story: StorybookEntry,\n    browser: Browser,\n    testInfo: TestInfo,\n  ) => Promise<void>;\n}\n\n/**\n * Resolves the golden-image plan for `config`'s own target (the one target\n * in `config.targets` not marked `sourceOfTruth`).\n *\n * Two independent checks per story, gated by `config.checkMode`, neither of\n * which boots the source-of-truth adapter's own Storybook — the divergence\n * check below compares stored golden files, not live pages:\n *\n * 1. **Own-drift (`checkMode: \"own\"`, the default; hard fail):** this run's\n *    live render vs this project's own stored `test/golden/<story-id>.png`.\n *    No golden yet for a story is not a failure — one is captured from this\n *    run instead (same as `--update-golden`, scoped to just that story), in\n *    either mode.\n * 2. **Source-of-truth divergence (`checkMode: \"divergence\"`; hard fail):**\n *    this project's own golden vs the source-of-truth's golden (`config`'s\n *    `sourceOfTruthGolden`). Skipped entirely when\n *    `config.isSourceOfTruthAdapter` is true — the\n *    source-of-truth adapter has nothing above it to diverge from — and\n *    skipped per-story when neither side has a baseline yet. A\n *    once-flagged divergence stays quiet after `--approve-divergence`,\n *    until the source of truth's own golden changes again.\n */\nexport async function resolveVisualRegressionPlan(\n  config: AdapterTesterConfig,\n): Promise<VisualRegressionPlan> {\n  const ownTarget = config.isSourceOfTruthAdapter\n    ? config.targets[0]\n    : config.targets.find((target) => !target.sourceOfTruth);\n  if (!ownTarget) {\n    throw new Error(\n      \"adapter-tester config has no non-sourceOfTruth target to run the golden check against.\",\n    );\n  }\n  const excludeTitlePrefixes =\n    config.excludeTitlePrefixes ?? DEFAULT_EXCLUDE_TITLE_PREFIXES;\n  const storyOverrides = config.stories ?? {};\n  const excludeStoryIds = Object.keys(storyOverrides).filter(\n    (id) => storyOverrides[id]!.exclude,\n  );\n  const goldenStoryThresholds = Object.fromEntries(\n    Object.entries(storyOverrides)\n      .filter(([, override]) => override.goldenThreshold !== undefined)\n      .map(([id, override]) => [id, override.goldenThreshold!]),\n  );\n  const sourceOfTruthStoryThresholds = Object.fromEntries(\n    Object.entries(storyOverrides)\n      .filter(([, override]) => override.sourceOfTruthThreshold !== undefined)\n      .map(([id, override]) => [id, override.sourceOfTruthThreshold!]),\n  );\n  const goldenDir = config.goldenDir;\n  const goldenMode = config.goldenMode;\n  const checkMode = config.checkMode;\n\n  // Fetched with only excludeTitlePrefixes applied — not excludeStoryIds —\n  // so the source-of-truth story-parity check below can tell an excluded\n  // story apart from one that's genuinely missing from this Storybook.\n  const ownStories = await fetchStories(ownTarget, excludeTitlePrefixes);\n  const stories = ownStories.filter(\n    (entry) =>\n      !excludeStoryIds.some((prefix) => matchesPrefix(entry.id, prefix)),\n  );\n\n  // `--update-golden` redefines this project's own baseline, so it's also\n  // the point a renamed/removed story's now-orphaned golden gets cleaned up\n  // — otherwise nothing ever prunes it, since a run only ever adds/updates\n  // entries for stories it actually saw in this pass. Uses the full current\n  // story list (not narrowed by any `--grep` Playwright itself applies), so\n  // this catches every orphan regardless of how the run is scoped.\n  if (goldenMode === \"update-golden\") {\n    const prunedStoryIds = await pruneOrphanedGoldens(\n      goldenDir,\n      new Set(stories.map((story) => story.id)),\n    );\n    if (prunedStoryIds.length > 0) {\n      console.warn(\n        `Pruned ${prunedStoryIds.length} orphaned golden(s) no longer in Storybook: ${prunedStoryIds.join(\", \")}`,\n      );\n    }\n  }\n\n  const sourceOfTruthGolden =\n    checkMode !== \"divergence\" ||\n    config.isSourceOfTruthAdapter ||\n    !config.sourceOfTruthGolden\n      ? null\n      : await resolveSourceOfTruthGolden(config.sourceOfTruthGolden);\n\n  // Checked against `ownStories` (title-prefix-excluded only), not `stories`\n  // — a story marked `exclude: true` still counts as \"present\", it's just\n  // not diffed. Only a story the source of truth has that this adapter\n  // never built at all, and hasn't acknowledged via `exclude`, is missing.\n  const ownStoryIds = new Set(ownStories.map((entry) => entry.id));\n  const missingFromSourceOfTruth = sourceOfTruthGolden\n    ? Object.keys(sourceOfTruthGolden.manifest)\n        .filter(\n          (id) =>\n            !ownStoryIds.has(id) &&\n            !excludeStoryIds.some((prefix) => matchesPrefix(id, prefix)),\n        )\n        .sort()\n    : [];\n\n  if (missingFromSourceOfTruth.length > 0) {\n    console.error(\n      `[adapter-tester] ${missingFromSourceOfTruth.length} stor(y/ies) exist in the source of truth but are missing here: ${missingFromSourceOfTruth.join(\", \")}. Add the missing story, or mark it \\`exclude: true\\` under \\`stories\\` in adapter-tester.config.json if intentional.`,\n    );\n  }\n\n  console.log(\n    [\n      `[adapter-tester] target: \"${ownTarget.name}\" (${ownTarget.url})`,\n      `[adapter-tester] checkMode: \"${checkMode}\" (${checkMode === \"divergence\" ? \"this project's golden vs source-of-truth's golden\" : \"live render vs this project's own golden\"})`,\n      `[adapter-tester] goldenMode: \"${goldenMode}\"`,\n      `[adapter-tester] goldenThresholdPixels: ${config.goldenThresholdPixels}`,\n      `[adapter-tester] sourceOfTruthThresholdPixels: ${config.sourceOfTruthThresholdPixels}`,\n      checkMode === \"divergence\"\n        ? config.isSourceOfTruthAdapter\n          ? `[adapter-tester] sourceOfTruthGolden: skipped — this is the source-of-truth adapter, nothing to diverge from`\n          : !config.sourceOfTruthGolden\n            ? `[adapter-tester] sourceOfTruthGolden: skipped — no sourceOfTruthGolden configured`\n            : sourceOfTruthGolden\n              ? `[adapter-tester] sourceOfTruthGolden: resolved, ${Object.keys(sourceOfTruthGolden.manifest).length} golden(s) available (config: ${JSON.stringify(config.sourceOfTruthGolden)})`\n              : `[adapter-tester] sourceOfTruthGolden: unavailable — no baseline found or unreachable (config: ${JSON.stringify(config.sourceOfTruthGolden)}); divergence check will skip every story`\n        : `[adapter-tester] sourceOfTruthGolden: not used in \"own\" checkMode`,\n      `[adapter-tester] stories: ${stories.length} to check (excluded: ${excludeStoryIds.length}, title prefixes excluded: ${excludeTitlePrefixes.join(\", \") || \"none\"})`,\n      `[adapter-tester] story parity with source of truth: ${missingFromSourceOfTruth.length === 0 ? \"OK\" : `${missingFromSourceOfTruth.length} missing (see error above)`}`,\n    ].join(\"\\n\"),\n  );\n\n  const suiteLabel =\n    checkMode === \"divergence\"\n      ? \"Source-of-Truth Divergence Check\"\n      : \"Own-Drift Golden Image Check\";\n\n  return {\n    ownTargetName: ownTarget.name,\n    suiteLabel,\n    stories,\n    missingFromSourceOfTruth,\n    checkStory: async (story, browser, testInfo) => {\n      const page = await browser.newPage();\n      await page.setViewportSize({ width: 800, height: 600 });\n      await page.goto(\n        `${ownTarget.url}/iframe.html?id=${story.id}&viewMode=story`,\n        { waitUntil: \"networkidle\" },\n      );\n      await page.waitForSelector(\"#storybook-root\");\n      await page.waitForTimeout(300);\n      const liveBuffer = await page.screenshot();\n\n      const imagePath = goldenImagePath(goldenDir, story.id);\n      // Only this worker ever touches this story's key, so reading it here\n      // (outside the lock `updateManifestEntry` takes at the end) can't\n      // race another worker — they're all reading/writing different keys.\n      const entry = loadManifest(goldenDir)[story.id];\n      const capturingNewGolden =\n        goldenMode !== \"check\" || !entry || !existsSync(imagePath);\n\n      let currentEntry: GoldenManifestEntry;\n      if (capturingNewGolden) {\n        saveGoldenImage(goldenDir, story.id, liveBuffer);\n        currentEntry = entry?.sourceOfTruthCreatedAt\n          ? {\n              createdAt: new Date().toISOString(),\n              sourceOfTruthCreatedAt: entry.sourceOfTruthCreatedAt,\n            }\n          : { createdAt: new Date().toISOString() };\n        if (!entry) {\n          testInfo.annotations.push({\n            type: \"golden-created\",\n            description: `No golden existed yet for \"${story.id}\" — captured one from this run.`,\n          });\n        }\n      } else {\n        currentEntry = entry;\n        if (checkMode === \"own\") {\n          const goldenBuffer = readFileSync(imagePath);\n          const { diffPixels, diffImage } = diffPngBuffers(\n            liveBuffer,\n            goldenBuffer,\n          );\n          const threshold = resolveThreshold(\n            story.id,\n            goldenStoryThresholds,\n            config.goldenThresholdPixels,\n          );\n          if (diffPixels >= threshold) {\n            await testInfo.attach(\"expected\", {\n              body: goldenBuffer,\n              contentType: \"image/png\",\n            });\n            await testInfo.attach(\"actual\", {\n              body: liveBuffer,\n              contentType: \"image/png\",\n            });\n            if (diffImage) {\n              await testInfo.attach(\"diff\", {\n                body: diffImage,\n                contentType: \"image/png\",\n              });\n            }\n          }\n          expect\n            .soft(\n              diffPixels,\n              `\"${story.id}\" has drifted from its own golden image (${diffPixels} mismatched pixels, threshold ${threshold})`,\n            )\n            .toBeLessThan(threshold);\n        }\n      }\n\n      if (sourceOfTruthGolden) {\n        const sourceOfTruthEntry = sourceOfTruthGolden.manifest[story.id];\n        const sourceOfTruthImage = sourceOfTruthEntry\n          ? await sourceOfTruthGolden.readImage(story.id)\n          : null;\n\n        if (sourceOfTruthEntry && sourceOfTruthImage) {\n          if (goldenMode === \"approve-divergence\") {\n            currentEntry = {\n              ...currentEntry,\n              sourceOfTruthCreatedAt: sourceOfTruthEntry.createdAt,\n            };\n          } else {\n            const ownImage = readFileSync(imagePath);\n            const { diffPixels, diffImage } = diffPngBuffers(\n              ownImage,\n              sourceOfTruthImage,\n            );\n            const threshold = resolveThreshold(\n              story.id,\n              sourceOfTruthStoryThresholds,\n              config.sourceOfTruthThresholdPixels,\n            );\n            const approvedAt = currentEntry.sourceOfTruthCreatedAt;\n            const isKnownDivergence =\n              diffPixels < threshold ||\n              (approvedAt !== undefined &&\n                approvedAt >= sourceOfTruthEntry.createdAt);\n            if (!isKnownDivergence) {\n              await testInfo.attach(\"expected\", {\n                body: sourceOfTruthImage,\n                contentType: \"image/png\",\n              });\n              await testInfo.attach(\"actual\", {\n                body: ownImage,\n                contentType: \"image/png\",\n              });\n              if (diffImage) {\n                await testInfo.attach(\"diff\", {\n                  body: diffImage,\n                  contentType: \"image/png\",\n                });\n              }\n              testInfo.annotations.push({\n                type: \"source-of-truth-divergence\",\n                description: `\"${story.id}\" differs from the source of truth's golden by ${diffPixels} mismatched pixels (threshold ${threshold}) and hasn't been reviewed — run with --approve-divergence if this is intentional, or fix the adapter styling.`,\n              });\n            }\n            expect\n              .soft(\n                isKnownDivergence,\n                `\"${story.id}\" differs from the source of truth's golden by ${diffPixels} mismatched pixels (threshold ${threshold}) and hasn't been reviewed — run with --approve-divergence if this is intentional, or fix the adapter styling.`,\n              )\n              .toBe(true);\n          }\n        }\n      }\n\n      // Locked read-modify-write of just this story's entry — see\n      // `updateManifestEntry` for why that's enough to make this safe\n      // across concurrent Playwright workers.\n      await updateManifestEntry(goldenDir, story.id, () => currentEntry);\n    },\n  };\n}\n"],"names":["diffPngBuffers","a","b","imgA","PNG","imgB","diff","pixelmatch","addFormats","ajvFormatsModule.default","ajv","Ajv","validate","schema","validateGoldenManifest","data","path","errors","error","extra","_a","manifestPath","goldenDir","join","manifestLockPath","goldenImagePath","storyId","loadManifest","existsSync","readFileSync","saveManifest","manifest","sorted","key","mkdirSync","tmpPath","writeFileSync","renameSync","LOCK_RETRY_MS","LOCK_TIMEOUT_MS","sleep","ms","resolve","acquireManifestLock","deadline","closeSync","openSync","releaseManifestLock","rmSync","updateManifestEntry","updater","nextEntry","saveGoldenImage","buffer","pruneOrphanedGoldens","currentStoryIds","orphanIds","id","imagePath","unlinkSync","GITHUB_REPO","resolveNpmVersion","packageName","versionSpec","response","resolved","_b","packageDirectory","resolveSourceOfTruthGolden","location","version","cacheDir","tag","rawBase","cachedManifestPath","text","parsed","cachedImagePath","DEFAULT_EXCLUDE_TITLE_PREFIXES","matchesPrefix","prefix","fetchStories","target","excludeTitlePrefixes","stories","entries","entry","resolveThreshold","storyThresholds","defaultThresholdPixels","bestMatch","resolveVisualRegressionPlan","config","ownTarget","storyOverrides","excludeStoryIds","goldenStoryThresholds","override","sourceOfTruthStoryThresholds","goldenMode","checkMode","ownStories","prunedStoryIds","story","sourceOfTruthGolden","ownStoryIds","missingFromSourceOfTruth","suiteLabel","browser","testInfo","page","liveBuffer","capturingNewGolden","currentEntry","goldenBuffer","diffPixels","diffImage","threshold","expect","sourceOfTruthEntry","sourceOfTruthImage","ownImage","approvedAt","isKnownDivergence"],"mappings":"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"}

package/package.json

@@ -13,7 +13,7 @@
     "url": "git+https://github.com/borderux/recursica.git",
     "directory": "packages/adapter-tester"
   },
-  "version": "3.0.0",
+  "version": "5.0.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -49,10 +49,7 @@
   },
   "scripts": {
     "build": "vite build --mode library",
-    "postbuild": "chmod +x dist/cli.js",
-    "adapter-tester": "node dist/cli.js --serve",
-    "adapter-tester:automated": "node dist/cli.js",
-    "dev": "tsx src/cli.ts --serve"
+    "postbuild": "chmod +x dist/cli.js"
   },
   "dependencies": {
     "ajv": "^8.17.1",
@@ -73,7 +70,6 @@
     "@types/pixelmatch": "^5.2.6",
     "@types/pngjs": "^6.0.5",
     "playwright": "^1.60.0",
-    "tsx": "^4.22.3",
     "typescript": "~5.8.3",
     "vite": "^6.3.5",
     "vite-plugin-dts": "^4.5.4"

package/src/adapter-tester.schema.json

@@ -8,7 +8,7 @@
   "properties": {
     "$schema": {
       "type": "string",
-      "description": "Optional pointer to this schema for editor autocomplete, e.g. \"./node_modules/@recursica/adapter-tester/src/adapter-tester.schema.json\"."
+      "description": "Optional pointer to this schema for editor autocomplete, e.g. \"https://raw.githubusercontent.com/borderux/recursica/main/packages/adapter-tester/src/adapter-tester.schema.json\"."
     },
     "name": {
       "type": "string",
@@ -23,7 +23,7 @@
           "type": "integer",
           "minimum": 1,
           "maximum": 65535,
-          "description": "Port the target's Storybook is served on. Auto-detected from this project's own `scripts.storybook` (a `-p <port>`/`--port <port>` flag) when omitted, falling back to Storybook's own default of 6006."
+          "description": "First-guess port only, not authoritative — the real port is auto-detected from this Storybook's own startup output, since Storybook silently falls back to an OS-assigned port whenever this one is taken. Auto-detected from this project's own `scripts.storybook` (a `-p <port>`/`--port <port>` flag) when omitted, falling back to 6006."
         },
         "command": {
           "type": "string",
@@ -48,7 +48,7 @@
               "type": "integer",
               "minimum": 1,
               "maximum": 65535,
-              "description": "Port the throwaway harness's Storybook is served on. Defaults to 6011."
+              "description": "First-guess port only, not authoritative — the real port is auto-detected from the throwaway harness's Storybook's own startup output."
             },
             "mantineAdapterVersion": {
               "type": "string",
@@ -64,7 +64,7 @@
           "type": "object",
           "additionalProperties": false,
           "description": "Non-standard mode: points at an already-addressable Storybook — e.g. a sibling workspace package's own Storybook inside this monorepo.",
-          "required": ["type", "port"],
+          "required": ["type"],
           "properties": {
             "type": { "const": "url" },
             "name": {
@@ -75,7 +75,7 @@
               "type": "integer",
               "minimum": 1,
               "maximum": 65535,
-              "description": "Port the source-of-truth Storybook is served on."
+              "description": "First-guess port only, not authoritative — the real port is auto-detected from the source-of-truth Storybook's own startup output. Defaults to 6011."
             },
             "command": {
               "type": "string",
@@ -93,25 +93,46 @@
       "type": "boolean",
       "description": "True only for the source-of-truth adapter's own config (mantine-adapter). Skips `sourceOfTruth` entirely — there's nothing above it to diverge from — and runs the own-drift golden check standalone, against just this project's own Storybook. Defaults to false."
     },
-    "diffThresholdPixels": {
+    "goldenThresholdPixels": {
       "type": "number",
       "minimum": 0,
-      "description": "Global visual diff threshold, in mismatched pixels, before a story is considered a failure. Defaults to 3500. AI agents must not modify this field — see AGENT.md."
+      "description": "Global visual diff threshold for the own-drift check (this project's live render vs. its own committed `test/golden/` image), in mismatched pixels, before a story is considered a failure. Same library/component on both sides, so this should stay tight. Defaults to 10. AI agents must not modify this field — see AGENT.md.",
+      "default": 10
     },
-    "storyThresholds": {
+    "sourceOfTruthThresholdPixels": {
+      "type": "number",
+      "minimum": 0,
+      "description": "Global visual diff threshold for the source-of-truth divergence check (this project's golden vs. the source-of-truth adapter's golden), in mismatched pixels, before a difference is flagged. Comparing across two different component libraries has legitimate structural variation (native control widgets, font rendering, etc.), so this is expected to be set much higher than `goldenThresholdPixels`. Ignored on the source-of-truth adapter's own config (`isSourceOfTruthAdapter: true`), which has no divergence check. Defaults to 3500. AI agents must not modify this field — see AGENT.md.",
+      "default": 3500
+    },
+    "stories": {
       "type": "object",
-      "additionalProperties": { "type": "number", "minimum": 0 },
-      "description": "Per-story diff threshold overrides, keyed by story id prefix (a story matches if its id equals the key or starts with it). Overrides `diffThresholdPixels` for matching stories. When more than one key matches a story, the longest (most specific) key wins."
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "goldenThreshold": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Diff threshold override for matching stories' own-drift check, in mismatched pixels. Overrides `goldenThresholdPixels`."
+          },
+          "sourceOfTruthThreshold": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Diff threshold override for matching stories' source-of-truth divergence check, in mismatched pixels. Overrides `sourceOfTruthThresholdPixels`."
+          },
+          "exclude": {
+            "type": "boolean",
+            "description": "Skip matching stories entirely — no own-drift check, no divergence check, no golden captured. For stories that don't have a cross-adapter counterpart; use `excludeTitlePrefixes` to drop a whole title instead."
+          }
+        }
+      },
+      "description": "Per-story overrides, keyed by story id prefix (a story matches if its id equals the key or starts with it). When more than one key matches a story, the longest (most specific) key wins."
     },
     "excludeTitlePrefixes": {
       "type": "array",
       "items": { "type": "string" },
       "description": "Storybook title prefixes to exclude from comparison, in addition to the built-in denylist (`Theme/*`, `Tokens/*`, `Introduction`)."
-    },
-    "excludeStoryIds": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Story id prefixes to skip entirely — no own-drift check, no divergence check, no golden captured. For excluding individual stories that don't have a cross-adapter counterpart; use `excludeTitlePrefixes` to drop a whole title instead."
     }
   }
 }

package/dist/mantineSourceOfTruth-BUb5MZy0.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"mantineSourceOfTruth-BUb5MZy0.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 { Layer } from \"@recursica/adapter-common\";\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\n// Mirrors mantine-adapter's own .storybook/preview.tsx decorator (every story defaults to\n// withLayer: true, layer: 0, wrapped with 48px padding) — every real adapter's own preview.tsx\n// applies this same wrapping, so a target adapter's story renders inside the same Layer\n// chrome/padding the source-of-truth side does. Without this, target screenshots come out\n// dramatically smaller/differently-positioned than the source of truth's (no Layer padding,\n// background, or border-radius at all), which alone can blow past the pixel-diff threshold\n// regardless of whether the actual Recursica tokens match — a false positive, not a real\n// component bug. ColorSchemeWrapper (mantine-adapter's dark-mode-toggle sync helper) is\n// intentionally not replicated — it only matters for the interactive dev-mode UI, not automated\n// screenshot diffing, which always runs in a single theme.\nconst preview: Preview = {\n  ...basePreview,\n  decorators: [\n    (Story, context) => {\n      const { withLayer = true, layer = 0 } = context.args;\n      const content = <Story />;\n      return (\n        <MantineProvider>\n          {withLayer ? (\n            <Layer layer={layer as 0 | 1 | 2 | 3} style={{ padding: \"48px\" }}>\n              {content}\n            </Layer>\n          ) : (\n            content\n          )}\n        </MantineProvider>\n      );\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  const {\n    mantineAdapterVersion = \"latest\",\n    storybookTemplateVersion = \"latest\",\n  } = options;\n\n  // A bare `npm install` is satisfied by a package-lock.json already sitting\n  // in `dir` from a prior run and skips re-resolving against the registry\n  // entirely — no network call — so a run can silently keep testing against\n  // a stale @recursica/mantine-adapter/storybook-template even after a newer\n  // version is published. Naming the two version-pinned packages as explicit\n  // `pkg@specifier` CLI args instead forces npm to re-check just those two\n  // against the registry every run, while the rest of node_modules stays\n  // cached.\n  const command = `npm install @recursica/mantine-adapter@${mantineAdapterVersion} @recursica/storybook-template@${storybookTemplateVersion} --no-audit --no-fund && npm run storybook`;\n\n  return {\n    command,\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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuDb,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,EACjD,CACJ,sBAAAM,EAAwB,SACxB,yBAAAC,EAA2B,QAAA,EACzBP,EAYJ,MAAO,CACL,QAHc,0CAA0CM,CAAqB,kCAAkCC,CAAwB,6CAIvI,KAAMP,EAAQ,KACd,IAAKI,EACL,oBAAqB,CAAC,QAAQ,IAAI,GAClC,QAAS,IAAM,GAAA,CAEnB"}

package/dist/mantineSourceOfTruth-BUkqMNEo.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mantineSourceOfTruth-BUkqMNEo.js","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 { Layer } from \"@recursica/adapter-common\";\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\n// Mirrors mantine-adapter's own .storybook/preview.tsx decorator (every story defaults to\n// withLayer: true, layer: 0, wrapped with 48px padding) — every real adapter's own preview.tsx\n// applies this same wrapping, so a target adapter's story renders inside the same Layer\n// chrome/padding the source-of-truth side does. Without this, target screenshots come out\n// dramatically smaller/differently-positioned than the source of truth's (no Layer padding,\n// background, or border-radius at all), which alone can blow past the pixel-diff threshold\n// regardless of whether the actual Recursica tokens match — a false positive, not a real\n// component bug. ColorSchemeWrapper (mantine-adapter's dark-mode-toggle sync helper) is\n// intentionally not replicated — it only matters for the interactive dev-mode UI, not automated\n// screenshot diffing, which always runs in a single theme.\nconst preview: Preview = {\n  ...basePreview,\n  decorators: [\n    (Story, context) => {\n      const { withLayer = true, layer = 0 } = context.args;\n      const content = <Story />;\n      return (\n        <MantineProvider>\n          {withLayer ? (\n            <Layer layer={layer as 0 | 1 | 2 | 3} style={{ padding: \"48px\" }}>\n              {content}\n            </Layer>\n          ) : (\n            content\n          )}\n        </MantineProvider>\n      );\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  const {\n    mantineAdapterVersion = \"latest\",\n    storybookTemplateVersion = \"latest\",\n  } = options;\n\n  // A bare `npm install` is satisfied by a package-lock.json already sitting\n  // in `dir` from a prior run and skips re-resolving against the registry\n  // entirely — no network call — so a run can silently keep testing against\n  // a stale @recursica/mantine-adapter/storybook-template even after a newer\n  // version is published. Naming the two version-pinned packages as explicit\n  // `pkg@specifier` CLI args instead forces npm to re-check just those two\n  // against the registry every run, while the rest of node_modules stays\n  // cached.\n  const command = `npm install @recursica/mantine-adapter@${mantineAdapterVersion} @recursica/storybook-template@${storybookTemplateVersion} --no-audit --no-fund && npm run storybook`;\n\n  return {\n    command,\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":";;AA2CA,MAAMA,IAAqB,UACrBC,IAAkB,WAClBC,IAAc,WAOdC,IAA6B;AAAA,EACjC,yBAAyBF;AAAA,EACzB,yBAAyBA;AAAA,EACzB,uBAAuB;AACzB,GAOMG,IAA0B;AAAA,EAC9B,kBAAkB;AACpB;AAEA,SAASC,EAAmBC,GAIzB;AACD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM;AAAA,IACN,SAAS;AAAA,MACP,WAAW,oBAAoBA,EAAQ,IAAI;AAAA,IAAA;AAAA,IAE7C,cAAc;AAAA,MACZ,8BAA8BA,EAAQ;AAAA,MACtC,iCAAiCA,EAAQ;AAAA,MACzC,+BAA+B;AAAA,MAC/B,6BAA6B;AAAA,MAC7B,iBAAiBN;AAAA,MACjB,kBAAkBA;AAAA,MAClB,OAAOE;AAAA,MACP,aAAaA;AAAA,MACb,WAAWD;AAAA,MACX,yBAAyBA;AAAA,MACzB,GAAGE;AAAA,MACH,GAAGC;AAAA,IAAA;AAAA,EACL;AAEJ;AAEA,MAAMG,IAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAqBVC,IAAc;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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuDb,SAASC,EACdH,GACQ;AACR,QAAM;AAAA,IACJ,KAAAI;AAAA,IACA,MAAAC;AAAA,IACA,uBAAAC,IAAwB;AAAA,IACxB,0BAAAC,IAA2B;AAAA,EAAA,IACzBP;AAEJ,SAAAQ,EAAUC,EAAKL,GAAK,YAAY,GAAG,EAAE,WAAW,IAAM,GACtDM;AAAA,IACED,EAAKL,GAAK,cAAc;AAAA,IACxB,KAAK;AAAA,MACHL,EAAmB;AAAA,QACjB,uBAAAO;AAAA,QACA,0BAAAC;AAAA,QACA,MAAAF;AAAA,MAAA,CACD;AAAA,MACD;AAAA,MACA;AAAA,IAAA,IACE;AAAA;AAAA,EAAA,GAENK,EAAcD,EAAKL,GAAK,oBAAoB,GAAGH,CAAO,GACtDS,EAAcD,EAAKL,GAAK,wBAAwB,GAAGF,CAAW,GAC9DQ,EAAcD,EAAKL,GAAK,YAAY,GAAG;AAAA,CAAgB,GAEhDA;AACT;AAMO,SAASO,EACdX,GACwB;AACxB,QAAMI,IAAMD,EAAoCH,CAAO,GACjD;AAAA,IACJ,uBAAAM,IAAwB;AAAA,IACxB,0BAAAC,IAA2B;AAAA,EAAA,IACzBP;AAYJ,SAAO;AAAA,IACL,SAHc,0CAA0CM,CAAqB,kCAAkCC,CAAwB;AAAA,IAIvI,MAAMP,EAAQ;AAAA,IACd,KAAKI;AAAA,IACL,qBAAqB,CAAC,QAAQ,IAAI;AAAA,IAClC,SAAS,MAAM;AAAA,EAAA;AAEnB;"}