@recursica/adapter-tester 5.0.0 → 5.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/dist/adapter-tester.schema.json.d.ts +4 -0
- package/dist/cli.cjs +13 -11
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.js +36 -29
- package/dist/cli.js.map +1 -1
- package/dist/config.d.ts +3 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/devServer.d.ts.map +1 -1
- package/dist/fileConfig.d.ts +3 -0
- package/dist/fileConfig.d.ts.map +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/testing/runVisualRegression.d.ts.map +1 -1
- package/dist/testing.cjs +4 -4
- package/dist/testing.cjs.map +1 -1
- package/dist/testing.js +16 -14
- package/dist/testing.js.map +1 -1
- package/package.json +1 -1
- package/report-header.txt +1 -1
- package/src/adapter-tester.schema.json +4 -0
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sources":["../src/portDiscovery.ts","../src/devServer.ts","../src/validateFileConfig.ts","../src/fileConfig.ts","../src/cli.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport net from \"node:net\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\n\n/**\n * Boots a target's Storybook and discovers the real port it ends up on,\n * instead of pinning one via `-p`/`--port`. Storybook silently falls back to\n * an OS-assigned port whenever its default/configured one is taken (this is\n * what caused the flaky `webServer` timeouts noted in mui-adapter), so the\n * only reliable source of truth is the URL it prints in its own startup\n * banner. Used by both the automated/headless run (cli.ts) and Dev Mode\n * (devServer.ts) — neither pins a port anymore.\n */\n\nexport interface LaunchTarget {\n /** Human-readable name used in log lines. */\n name: string;\n command: string;\n cwd: string;\n /** Reuse an already-running instance (detected via the last-known-port\n * cache) instead of spawning a new one. Mirrors the old `reuseExistingServer`\n * behavior, which used to just probe the one fixed configured port. */\n reuseExistingServer: boolean;\n /** File the discovered port is cached in between runs, so a later\n * `reuseExistingServer` run knows where to look. One per target. */\n cacheFile: string;\n timeoutMs?: number;\n}\n\nexport interface DiscoveredServer {\n url: string;\n port: number;\n /** The process we spawned, or `null` if an already-running instance was\n * reused — callers should only kill what they started. */\n process: ChildProcess | null;\n}\n\n// Storybook prints its bound address in its startup banner wrapped in ANSI\n// color codes and box-drawing chars, e.g.:\n// │ │ - Local: http://localhost:57496/ │ │\n// Strip ANSI first, then match the URL itself.\nconst ANSI_PATTERN = /\\x1b\\[[0-9;]*m/g;\nconst LOCAL_URL_PATTERN = /Local:\\s*(https?:\\/\\/localhost:\\d+)/;\n\nfunction isPortActive(port: number): Promise<boolean> {\n return new Promise((resolve) => {\n const socket = new net.Socket();\n socket.setTimeout(200);\n socket.once(\"connect\", () => {\n socket.destroy();\n resolve(true);\n });\n socket.once(\"timeout\", () => {\n socket.destroy();\n resolve(false);\n });\n socket.once(\"error\", () => {\n socket.destroy();\n resolve(false);\n });\n socket.connect(port, \"127.0.0.1\");\n });\n}\n\nfunction readCachedPort(cacheFile: string): number | undefined {\n try {\n const port = JSON.parse(readFileSync(cacheFile, \"utf8\")).port;\n return typeof port === \"number\" ? port : undefined;\n } catch {\n return undefined;\n }\n}\n\nfunction writeCachedPort(cacheFile: string, port: number): void {\n mkdirSync(dirname(cacheFile), { recursive: true });\n writeFileSync(cacheFile, JSON.stringify({ port }));\n}\n\n/** Spawns `target.command`, streaming its output to the console like before,\n * and resolves once it reports the URL it actually bound to. */\nfunction spawnAndDetect(\n target: LaunchTarget,\n timeoutMs: number,\n): Promise<DiscoveredServer> {\n return new Promise((resolve, reject) => {\n const child = spawn(target.command, {\n cwd: target.cwd,\n stdio: \"pipe\",\n shell: true,\n });\n\n let settled = false;\n const timer = setTimeout(() => {\n if (settled) return;\n settled = true;\n child.kill();\n reject(\n new Error(\n `Timed out after ${timeoutMs}ms waiting for ${target.name}'s Storybook to report its URL (no \"Local: http://localhost:<port>\" line seen in its output).`,\n ),\n );\n }, timeoutMs);\n\n const handleOutput = (data: Buffer, isError: boolean) => {\n const text = data.toString();\n for (const line of text.split(\"\\n\")) {\n if (line.trim()) {\n const label = isError\n ? `${target.name} SB ERROR`\n : `${target.name} SB`;\n (isError ? console.error : console.log)(`[${label}] ${line.trim()}`);\n }\n }\n if (settled) return;\n const match = text.replace(ANSI_PATTERN, \"\").match(LOCAL_URL_PATTERN);\n if (match) {\n settled = true;\n clearTimeout(timer);\n // Non-null: LOCAL_URL_PATTERN has exactly one capture group, and a\n // match only happens when it participated.\n const url = match[1]!;\n const port = Number(new URL(url).port);\n writeCachedPort(target.cacheFile, port);\n resolve({ url, port, process: child });\n }\n };\n child.stdout?.on(\"data\", (data: Buffer) => handleOutput(data, false));\n child.stderr?.on(\"data\", (data: Buffer) => handleOutput(data, true));\n child.on(\"error\", (err) => {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n reject(err);\n });\n child.on(\"exit\", (code) => {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n reject(\n new Error(\n `${target.name}'s Storybook exited (code ${code}) before reporting its URL.`,\n ),\n );\n });\n });\n}\n\n/** Adapts a resolved `HarnessWebServerConfig` into a `LaunchTarget`. */\nexport function toLaunchTarget(\n name: string,\n server: HarnessWebServerConfig,\n): LaunchTarget {\n return {\n name,\n command: server.command,\n cwd: server.cwd,\n reuseExistingServer: server.reuseExistingServer,\n cacheFile: server.cacheFile,\n timeoutMs: server.timeout,\n };\n}\n\n/** Reuses an already-running Storybook if `reuseExistingServer` is set and\n * the last-known-port cache points at something still listening; otherwise\n * spawns `target.command` fresh and detects the real port from its output. */\nexport async function launchAndDetectStorybook(\n target: LaunchTarget,\n): Promise<DiscoveredServer> {\n if (target.reuseExistingServer) {\n const cachedPort = readCachedPort(target.cacheFile);\n if (cachedPort !== undefined && (await isPortActive(cachedPort))) {\n console.log(\n `[Dev Launcher] ${target.name} is already running on port ${cachedPort} (reused).`,\n );\n return {\n url: `http://localhost:${cachedPort}`,\n port: cachedPort,\n process: null,\n };\n }\n }\n console.log(`[Dev Launcher] Launching Storybook for ${target.name}...`);\n return spawnAndDetect(target, target.timeoutMs ?? 120 * 1000);\n}\n","import { spawn, type ChildProcess } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport express from \"express\";\nimport { createProxyMiddleware } from \"http-proxy-middleware\";\nimport type { AdapterTesterConfig } from \"./config.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\nimport { launchAndDetectStorybook, toLaunchTarget } from \"./portDiscovery.js\";\n\n/**\n * Interactive Dev Mode: a synced, side-by-side browser view of this\n * project's own Storybook and the source of truth, with per-story note\n * taking and an AI-report export. Boots both Storybooks (reusing them if\n * already running) behind a proxy so the own/target pane — which drives\n * the sync and carries Storybook's nav sidebar — loads same-origin on the\n * left, with the source of truth following along as a bare preview on the\n * right.\n *\n * Config-driven — takes the same `{ engineConfig, webServers }` shape\n * `resolveConfig()` produces, in the same [sourceOfTruth, target] order.\n */\n\nconst distDir = dirname(fileURLToPath(import.meta.url));\n\nfunction openBrowser(url: string): void {\n const startCmd =\n process.platform === \"darwin\"\n ? \"open\"\n : process.platform === \"win32\"\n ? \"start\"\n : \"xdg-open\";\n console.log(`[Dev Launcher] Auto-launching browser: ${url}`);\n spawn(startCmd, [url], { shell: process.platform === \"win32\" }).on(\n \"error\",\n (err) => {\n console.error(`[Dev Launcher] Failed to auto-launch browser:`, err);\n },\n );\n}\n\nexport interface DevServerOptions {\n /** Port the dev-mode proxy UI itself listens on. Defaults to 6010. */\n port?: number;\n}\n\nexport async function startDevServer(\n engineConfig: AdapterTesterConfig,\n webServers: HarnessWebServerConfig[],\n options: DevServerOptions = {},\n): Promise<void> {\n const [sourceOfTruth, target] = engineConfig.targets;\n const [sourceOfTruthServer, targetServer] = webServers;\n if (\n !sourceOfTruth?.sourceOfTruth ||\n !target ||\n target.sourceOfTruth ||\n !sourceOfTruthServer ||\n !targetServer\n ) {\n throw new Error(\n \"adapter-tester dev mode requires exactly two targets: [sourceOfTruth, target] — check adapter-tester.config.json.\",\n );\n }\n\n const devPort = options.port ?? 6010;\n\n // Neither Storybook is pinned to a specific port — each one silently\n // falls back to an OS-assigned port whenever its default/configured one is\n // taken, so the real port is only known once it reports it (see\n // portDiscovery.ts). Booted concurrently since neither depends on the other.\n console.log(\n `[Dev Launcher] Resolving ${sourceOfTruth.name} and ${target.name} Storybooks...`,\n );\n const [sourceOfTruthRunning, targetRunning] = await Promise.all([\n launchAndDetectStorybook(\n toLaunchTarget(sourceOfTruth.name, sourceOfTruthServer),\n ),\n launchAndDetectStorybook(toLaunchTarget(target.name, targetServer)),\n ]);\n console.log(`[Dev Launcher] Both Storybooks are active and responsive!`);\n\n const spawned = [sourceOfTruthRunning.process, targetRunning.process].filter(\n (child): child is ChildProcess => child !== null,\n );\n\n const app = express();\n const publicDir = join(distDir, \"../public\");\n const headerPath = join(distDir, \"../report-header.txt\");\n\n // Serve the Dev Mode UI at the root path ONLY if there is no query string.\n // This allows the iframe (which loads with ?path=/story/...) to pass\n // through to the proxy, avoiding an infinite loop of nested wrappers.\n app.get(\"/\", (req, res, next) => {\n if (req.query.path) {\n next();\n return;\n }\n const html = readFileSync(join(publicDir, \"index.html\"), \"utf8\").replace(\n \"<head>\",\n `<head>\\n <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({\n ownName: target.name,\n sourceOfTruthName: sourceOfTruth.name,\n sourceOfTruthPort: sourceOfTruthRunning.port,\n })};</script>`,\n );\n res.send(html);\n });\n\n // Serve the AI prompt header dynamically so it can be edited externally.\n app.get(\"/report-header.txt\", (req, res) => {\n try {\n res.type(\"text/plain\").send(readFileSync(headerPath, \"utf8\"));\n } catch {\n res.status(500).send(\"Error loading report-header.txt\");\n }\n });\n\n // Proxy everything else to this project's own Storybook, preserving\n // absolute paths (e.g. /@vite/client) so HMR keeps working same-origin.\n // This is the pane that drives the sync and shows Storybook's nav sidebar.\n app.use(\n \"/\",\n createProxyMiddleware({\n target: targetRunning.url,\n changeOrigin: true,\n ws: true,\n }),\n );\n\n let cleaningUp = false;\n const cleanup = () => {\n if (cleaningUp) return;\n cleaningUp = true;\n console.log(\n \"\\n[Dev Launcher] Shutting down Dev Mode server and spawned Storybooks...\",\n );\n for (const child of spawned) child.kill(\"SIGINT\");\n process.exit(0);\n };\n process.on(\"SIGINT\", cleanup);\n process.on(\"SIGTERM\", cleanup);\n\n app.listen(devPort, () => {\n console.log(`\n====================================================\n🚀 Adapter Dev Mode proxy running at:\n http://localhost:${devPort}\n====================================================\n`);\n openBrowser(`http://localhost:${devPort}`);\n });\n}\n","import { Ajv } from \"ajv\";\nimport * as ajvFormatsModule from \"ajv-formats\";\nimport type { FormatsPlugin } from \"ajv-formats\";\nimport schema from \"./adapter-tester.schema.json\" with { type: \"json\" };\n\n// ajv-formats ships an ESM-style `export default` on a CJS build with no\n// `\"type\"` field, which under `moduleResolution: NodeNext` TS resolves to\n// the raw module namespace instead of unwrapping the default — a known\n// ajv-formats/TS interop gap, not a version mismatch.\nconst addFormats = (ajvFormatsModule as unknown as { default: FormatsPlugin })\n .default;\n\nconst ajv = new Ajv({ allErrors: true, strict: true });\naddFormats(ajv);\nconst validate = ajv.compile(schema);\n\n/**\n * Validates a parsed `adapter-tester.config.json` against\n * `adapter-tester.schema.json`. Throws with every violation listed — callers\n * must not silently coerce or drop invalid fields.\n */\nexport function validateFileConfig(data: unknown, path: string): void {\n if (validate(data)) return;\n\n const errors = (validate.errors ?? [])\n .map((error) => {\n const extra = error.params?.additionalProperty\n ? ` '${error.params.additionalProperty}'`\n : \"\";\n return ` - ${error.instancePath || \"root\"} ${error.message}${extra}`;\n })\n .join(\"\\n\");\n throw new Error(`Invalid ${path}:\\n${errors}`);\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type {\n AdapterTesterConfig,\n SourceOfTruthGoldenLocation,\n StoryOverride,\n} from \"./config.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\nimport { mantineSourceOfTruthWebServer } from \"./harness/mantineSourceOfTruth.js\";\nimport { validateFileConfig } from \"./validateFileConfig.js\";\n\nconst MANTINE_ADAPTER_PACKAGE_NAME = \"@recursica/mantine-adapter\";\n\nexport const CONFIG_FILE_NAME = \"adapter-tester.config.json\";\nconst DEFAULT_STORYBOOK_COMMAND = \"npm run storybook\";\nconst DEFAULT_STORYBOOK_PORT = 6006;\nconst DEFAULT_SOURCE_OF_TRUTH_PORT = 6011;\nconst DEFAULT_SOURCE_OF_TRUTH_NAME = \"Mantine\";\nconst DEFAULT_GOLDEN_THRESHOLD_PIXELS = 10;\nconst DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS = 3500;\n\ninterface StorybookTargetFileConfig {\n /** First-guess port only, not authoritative — the real port is\n * auto-detected from this Storybook's own startup output, since Storybook\n * silently falls back to an OS-assigned port whenever this one is taken.\n * Auto-detected from this project's own `scripts.storybook` (a `-p\n * <port>`/`--port <port>` flag) when omitted, falling back to 6006. */\n port?: number;\n /** Command that boots the target's Storybook. Defaults to `npm run storybook`. */\n command?: string;\n /** Directory the command runs in, relative to the config file. Defaults to \".\" */\n cwd?: string;\n}\n\ninterface MantineHarnessSourceOfTruthFileConfig {\n /** Default mode: boots a throwaway harness that installs the published\n * `@recursica/mantine-adapter` from npm — no monorepo checkout required. */\n type?: \"mantine-harness\";\n /** First-guess port only, not authoritative — see `HarnessWebServerConfig.port`. */\n port?: number;\n mantineAdapterVersion?: string;\n storybookTemplateVersion?: string;\n}\n\ninterface UrlSourceOfTruthFileConfig {\n /** Non-standard mode: points at an already-addressable Storybook — e.g. a\n * sibling workspace package's own Storybook inside this monorepo. */\n type: \"url\";\n name?: string;\n /** First-guess port only, not authoritative — see `HarnessWebServerConfig.port`.\n * Defaults to 6011. */\n port?: number;\n command?: string;\n cwd?: string;\n}\n\ntype SourceOfTruthFileConfig =\n | MantineHarnessSourceOfTruthFileConfig\n | UrlSourceOfTruthFileConfig;\n\nexport interface AdapterTesterFileConfig {\n /** Label for this project's own target. Defaults to the unscoped name in\n * this project's package.json (e.g. \"@recursica/mui-adapter\" -> \"mui-adapter\"). */\n name?: string;\n storybook?: StorybookTargetFileConfig;\n sourceOfTruth?: SourceOfTruthFileConfig;\n goldenThresholdPixels?: number;\n sourceOfTruthThresholdPixels?: number;\n stories?: Record<string, StoryOverride>;\n excludeTitlePrefixes?: string[];\n /**\n * True only for the source-of-truth adapter's own config (mantine-adapter).\n * Skips `sourceOfTruth` entirely — there's nothing above it to diverge\n * from — and runs the own-drift golden check standalone, against just this\n * project's own Storybook. Defaults to false.\n */\n isSourceOfTruthAdapter?: boolean;\n}\n\nexport interface ResolvedAdapterTesterConfig {\n engineConfig: AdapterTesterConfig;\n webServers: HarnessWebServerConfig[];\n}\n\nexport interface ResolveConfigOverrides {\n /** From `--source-of-truth-version`. Overrides `sourceOfTruth.mantineAdapterVersion`. */\n mantineAdapterVersion?: string;\n}\n\nfunction readOwnPackageJson(cwd: string): any {\n const path = join(cwd, \"package.json\");\n if (!existsSync(path)) {\n throw new Error(\n `No package.json found in ${cwd} — run adapter-tester from the root of the project being tested.`,\n );\n }\n return JSON.parse(readFileSync(path, \"utf8\"));\n}\n\nfunction detectOwnPort(cwd: string): number {\n const pkg = readOwnPackageJson(cwd);\n const storybookScript = pkg.scripts?.storybook as string | undefined;\n const match = storybookScript?.match(/(?:-p|--port)[ =](\\d+)/);\n return match ? Number(match[1]) : DEFAULT_STORYBOOK_PORT;\n}\n\nfunction detectOwnName(cwd: string): string {\n const pkg = readOwnPackageJson(cwd);\n const name = pkg.name as string | undefined;\n return name ? name.split(\"/\").pop()! : \"Adapter\";\n}\n\nfunction loadFileConfig(cwd: string): AdapterTesterFileConfig {\n const path = join(cwd, CONFIG_FILE_NAME);\n if (!existsSync(path)) {\n return {};\n }\n const data = JSON.parse(readFileSync(path, \"utf8\"));\n validateFileConfig(data, path);\n return data;\n}\n\n/**\n * Loads `adapter-tester.config.json` from `cwd` (or falls back to defaults\n * when the file doesn't exist) and resolves it into the engine config\n * `resolveVisualRegressionPlan` consumes plus the Playwright `webServer` entries\n * needed to boot both sides of the comparison.\n *\n * Default mode (no `sourceOfTruth`/`storybook` set): compares this project's\n * own Storybook against a throwaway Mantine harness — no monorepo checkout\n * required. Set `sourceOfTruth.type: \"url\"` for the non-standard mode used\n * to compare sibling workspace packages inside this monorepo.\n *\n * `overrides.mantineAdapterVersion` (from `--source-of-truth-version`) pins\n * the mantine-harness install/golden-fetch version for this run, overriding\n * `sourceOfTruth.mantineAdapterVersion`. Throws if passed together with\n * `isSourceOfTruthAdapter` or `sourceOfTruth.type: \"url\"` — neither has a\n * version to pin.\n */\nexport function resolveConfig(\n cwd: string,\n overrides: ResolveConfigOverrides = {},\n): ResolvedAdapterTesterConfig {\n const file = loadFileConfig(cwd);\n const isSourceOfTruthAdapter = file.isSourceOfTruthAdapter ?? false;\n\n if (overrides.mantineAdapterVersion && isSourceOfTruthAdapter) {\n throw new Error(\n \"--source-of-truth-version has no effect on the source-of-truth adapter's own config (isSourceOfTruthAdapter: true) — there's nothing to pin a version for.\",\n );\n }\n\n const ownName = file.name ?? detectOwnName(cwd);\n const ownPort = file.storybook?.port ?? detectOwnPort(cwd);\n const ownCommand = file.storybook?.command ?? DEFAULT_STORYBOOK_COMMAND;\n const ownCwd = resolve(cwd, file.storybook?.cwd ?? \".\");\n const ownWebServer: HarnessWebServerConfig = {\n command: ownCommand,\n port: ownPort,\n cwd: ownCwd,\n reuseExistingServer: !process.env.CI,\n cacheFile: join(cwd, \".adapter-tester\", \"last-port-own.json\"),\n timeout: 120 * 1000,\n };\n\n const sharedEngineConfig = {\n goldenThresholdPixels:\n file.goldenThresholdPixels ?? DEFAULT_GOLDEN_THRESHOLD_PIXELS,\n sourceOfTruthThresholdPixels:\n file.sourceOfTruthThresholdPixels ??\n DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS,\n stories: file.stories,\n excludeTitlePrefixes: file.excludeTitlePrefixes,\n // Keyed off `ownCwd`, not `cwd` — the project actually being tested, not\n // wherever the config file happens to live. Matters whenever\n // `storybook.cwd` points at a sibling package: its goldens must resolve\n // to that package's own `test/golden/` (the same directory used when\n // that package runs adapter-tester directly), not a directory under\n // wherever this config file lives.\n goldenDir: join(ownCwd, \"test\", \"golden\"),\n isSourceOfTruthAdapter,\n // Overwritten by the CLI from --update-golden/--approve-divergence.\n goldenMode: \"check\" as const,\n // Overwritten by the CLI from --divergence-only.\n checkMode: \"own\" as const,\n };\n\n // The source-of-truth adapter's own config has nothing above it to\n // diverge from — no second target, no harness/webServer for it at all.\n if (isSourceOfTruthAdapter) {\n return {\n engineConfig: {\n ...sharedEngineConfig,\n targets: [{ name: ownName, url: `http://localhost:${ownPort}` }],\n },\n webServers: [ownWebServer],\n };\n }\n\n const sourceOfTruth = file.sourceOfTruth ?? {\n type: \"mantine-harness\" as const,\n };\n\n let sourceOfTruthName: string;\n let sourceOfTruthPort: number;\n let sourceOfTruthWebServer: HarnessWebServerConfig;\n let sourceOfTruthGolden: SourceOfTruthGoldenLocation;\n\n if (sourceOfTruth.type === \"url\") {\n if (overrides.mantineAdapterVersion) {\n throw new Error(\n '--source-of-truth-version has no effect with sourceOfTruth.type: \"url\" — that mode reads a sibling package\\'s local checkout directly, not a published version.',\n );\n }\n sourceOfTruthName = sourceOfTruth.name ?? DEFAULT_SOURCE_OF_TRUTH_NAME;\n sourceOfTruthPort = sourceOfTruth.port ?? DEFAULT_SOURCE_OF_TRUTH_PORT;\n const sourceOfTruthCwd = resolve(cwd, sourceOfTruth.cwd ?? \".\");\n sourceOfTruthWebServer = {\n command: sourceOfTruth.command ?? DEFAULT_STORYBOOK_COMMAND,\n port: sourceOfTruthPort,\n cwd: sourceOfTruthCwd,\n reuseExistingServer: !process.env.CI,\n cacheFile: join(cwd, \".adapter-tester\", \"last-port-source-of-truth.json\"),\n timeout: 120 * 1000,\n };\n // Sibling package already checked out locally — read its golden files\n // directly, including any uncommitted local changes. No install, no\n // network call.\n sourceOfTruthGolden = {\n type: \"local\",\n dir: join(sourceOfTruthCwd, \"test\", \"golden\"),\n };\n } else {\n sourceOfTruthName = DEFAULT_SOURCE_OF_TRUTH_NAME;\n sourceOfTruthPort = sourceOfTruth.port ?? DEFAULT_SOURCE_OF_TRUTH_PORT;\n const mantineAdapterVersion =\n overrides.mantineAdapterVersion ?? sourceOfTruth.mantineAdapterVersion;\n sourceOfTruthWebServer = mantineSourceOfTruthWebServer({\n dir: join(cwd, \".adapter-tester/mantine-harness\"),\n port: sourceOfTruthPort,\n mantineAdapterVersion,\n storybookTemplateVersion: sourceOfTruth.storybookTemplateVersion,\n });\n // No local checkout — resolve the installed version against the npm\n // registry and fetch that version's golden files from the public repo.\n // Never needs `sourceOfTruthWebServer` above; the golden check on its\n // own doesn't boot a second Storybook at all (see cli.ts).\n sourceOfTruthGolden = {\n type: \"npm\",\n packageName: MANTINE_ADAPTER_PACKAGE_NAME,\n versionSpec: mantineAdapterVersion ?? \"latest\",\n cacheDir: join(cwd, \".adapter-tester/mantine-golden-cache\"),\n };\n }\n\n return {\n engineConfig: {\n ...sharedEngineConfig,\n targets: [\n {\n name: sourceOfTruthName,\n url: `http://localhost:${sourceOfTruthPort}`,\n sourceOfTruth: true,\n },\n { name: ownName, url: `http://localhost:${ownPort}` },\n ],\n sourceOfTruthGolden,\n },\n // [sourceOfTruth, own] — Dev Mode needs both; the automated golden run\n // (cli.ts) only ever boots the last entry, since its divergence check\n // reads stored golden files, not a live source-of-truth page.\n webServers: [sourceOfTruthWebServer, ownWebServer],\n };\n}\n","import { spawnSync } from \"node:child_process\";\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport type { AdapterTesterConfig } from \"./config.js\";\nimport { startDevServer } from \"./devServer.js\";\nimport { resolveConfig } from \"./fileConfig.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\nimport { launchAndDetectStorybook, toLaunchTarget } from \"./portDiscovery.js\";\n\n// `dist/testing.js` is always a sibling of this file — both inside a\n// consumer's node_modules/@recursica/adapter-tester/dist and inside this\n// monorepo's own packages/adapter-tester/dist when self-hosting — so the\n// generated spec below can reach it without depending on how the package\n// itself resolves at import time.\nconst distDir = dirname(fileURLToPath(import.meta.url));\nconst testingEntry = pathToFileURL(join(distDir, \"testing.js\")).href;\n\n// `--source-of-truth-version <value>` takes a value, unlike every other own\n// flag below — pulled out of argv first so the boolean flags/passthrough\n// logic never has to know it exists.\nconst args = process.argv.slice(2);\nlet sourceOfTruthVersion: string | undefined;\nconst sourceOfTruthVersionFlagIndex = args.indexOf(\"--source-of-truth-version\");\nif (sourceOfTruthVersionFlagIndex !== -1) {\n const value = args[sourceOfTruthVersionFlagIndex + 1];\n if (value === undefined || value.startsWith(\"--\")) {\n throw new Error(\n \"--source-of-truth-version requires a value, e.g. --source-of-truth-version 0.53.0\",\n );\n }\n sourceOfTruthVersion = value;\n args.splice(sourceOfTruthVersionFlagIndex, 2);\n}\n\nconst cwd = process.cwd();\nconst { engineConfig, webServers } = resolveConfig(cwd, {\n mantineAdapterVersion: sourceOfTruthVersion,\n});\n\nif (args.includes(\"--update-golden\")) {\n engineConfig.goldenMode = \"update-golden\";\n} else if (args.includes(\"--approve-divergence\")) {\n engineConfig.goldenMode = \"approve-divergence\";\n}\n\nif (args.includes(\"--divergence-only\")) {\n if (engineConfig.isSourceOfTruthAdapter) {\n throw new Error(\n \"--divergence-only has nothing to diverge from — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json.\",\n );\n }\n engineConfig.checkMode = \"divergence\";\n} else if (engineConfig.goldenMode === \"approve-divergence\") {\n throw new Error(\n \"--approve-divergence only makes sense with --divergence-only — there's nothing to approve without the divergence check running.\",\n );\n}\n\nif (args.includes(\"--dry-run\")) {\n console.log(JSON.stringify({ engineConfig, webServers }, null, 2));\n process.exit(0);\n}\n\n// Any arg besides our own flags is passed straight through to `playwright\n// test` — e.g. `npm run adapter-tester:automated -- --grep \"Toast\"` to scope\n// a run to matching stories, instead of every invocation running the full\n// suite. Our own flags are consumed above, not forwarded — Playwright itself\n// doesn't know about them.\nconst OWN_FLAGS = new Set([\n \"--dry-run\",\n \"--serve\",\n \"--update-golden\",\n \"--approve-divergence\",\n \"--divergence-only\",\n]);\nconst passthroughArgs = args.filter((arg) => !OWN_FLAGS.has(arg));\n\n// The bundled build target doesn't support top-level await, so the async\n// work (launching Storybook and detecting its real port) lives in main().\nmain().catch((err) => {\n console.error(err);\n process.exitCode = 1;\n});\n\nasync function main(): Promise<void> {\n if (args.includes(\"--serve\")) {\n if (engineConfig.isSourceOfTruthAdapter) {\n throw new Error(\n \"Dev Mode (--serve) has nothing to sync this project's Storybook against — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json.\",\n );\n }\n // Dual-Storybook interactive Dev Mode — no Playwright, no screenshots.\n // Used by the `adapter-tester` npm script.\n await startDevServer(engineConfig, webServers);\n } else {\n // The golden-image checks never need the source-of-truth adapter's own\n // Storybook running — the divergence check reads its stored golden files,\n // not a live page — so only the last (own) webServer is booted here. Dev\n // Mode above is the one thing that still needs both.\n const ownWebServer = webServers.at(-1);\n if (!ownWebServer) {\n throw new Error(\"resolveConfig() returned no webServers to boot.\");\n }\n await runAutomated(ownWebServer, engineConfig);\n }\n}\n\n/**\n * Boots this project's own Storybook (auto-detecting the port it actually\n * lands on — see portDiscovery.ts), generates a throwaway Playwright config\n * + spec under `.adapter-tester/run/`, and runs the automated pixel-diff\n * suite against it. Used by the `adapter-tester:automated` npm script.\n *\n * Playwright's own `webServer` option can't be used here — it only knows how\n * to poll a port/URL decided *before* the command it spawns runs, but\n * Storybook silently falls back to a different, OS-assigned port whenever\n * its configured one is taken. So this boots and waits for Storybook itself,\n * then points the generated config straight at whatever URL it actually\n * reports.\n */\nasync function runAutomated(\n server: HarnessWebServerConfig,\n config: AdapterTesterConfig,\n): Promise<void> {\n const runDir = join(cwd, \".adapter-tester/run\");\n mkdirSync(runDir, { recursive: true });\n\n const ownTarget = config.targets.at(-1);\n if (!ownTarget) {\n throw new Error(\"resolveConfig() returned no targets to check.\");\n }\n const { url, process: spawned } = await launchAndDetectStorybook(\n toLaunchTarget(ownTarget.name, server),\n );\n ownTarget.url = url;\n\n writeFileSync(\n join(runDir, \"playwright.config.js\"),\n `// Generated by \\`adapter-tester\\` — do not edit, regenerated on every run.\nimport { defineConfig, devices } from \"@playwright/test\";\n\nexport default defineConfig({\n testDir: ${JSON.stringify(runDir)},\n // Stories run across Playwright's default worker pool — each golden check\n // only reads/writes its own story's manifest.json entry, under a lock, so\n // concurrent workers never race each other (see \\`updateManifestEntry\\`).\n // Override with \\`--workers <n>\\` (forwarded straight through to Playwright).\n fullyParallel: true,\n forbidOnly: !!process.env.CI,\n retries: process.env.CI ? 2 : 0,\n reporter: [[\"html\", { open: \"never\" }], [\"list\"]],\n use: { trace: \"on-first-retry\" },\n projects: [{ name: \"chromium\", use: { ...devices[\"Desktop Chrome\"] } }],\n // No webServer entry — this project's own Storybook is already running by\n // the time this config is used (see runAutomated() in cli.ts).\n});\n`,\n );\n\n writeFileSync(\n join(runDir, \"visual-regression.spec.js\"),\n `// Generated by \\`adapter-tester\\` — do not edit, regenerated on every run.\nimport { test, expect } from \"@playwright/test\";\nimport { resolveVisualRegressionPlan } from ${JSON.stringify(testingEntry)};\n\n// \\`test.describe\\`/\\`test\\` are called here, not inside resolveVisualRegressionPlan,\n// so Playwright's HTML report groups the suite under this file instead of a\n// sourcemapped path into adapter-tester's own library code.\nconst { ownTargetName, suiteLabel, stories, missingFromSourceOfTruth, checkStory } =\n await resolveVisualRegressionPlan(${JSON.stringify(config, null, 2)});\n\ntest.describe(\\`\\${ownTargetName} — \\${suiteLabel}\\`, () => {\n if (missingFromSourceOfTruth.length > 0) {\n test(\"story parity with source of truth\", () => {\n expect(\n missingFromSourceOfTruth,\n \\`\\${missingFromSourceOfTruth.length} stor(y/ies) exist in the source of truth but are missing here. Add the missing story, or mark it \\\\\\`exclude: true\\\\\\` under \\\\\\`stories\\\\\\` in adapter-tester.config.json if intentional.\\`,\n ).toEqual([]);\n });\n }\n for (const story of stories) {\n test(story.id, async ({ browser }, testInfo) => {\n await checkStory(story, browser, testInfo);\n });\n }\n});\n`,\n );\n\n try {\n const result = spawnSync(\n \"npx\",\n [\n \"playwright\",\n \"test\",\n \"--config\",\n join(runDir, \"playwright.config.js\"),\n ...passthroughArgs,\n ],\n { stdio: \"inherit\", cwd, shell: process.platform === \"win32\" },\n );\n process.exitCode = result.status ?? 1;\n } finally {\n // Only tear down the Storybook we spawned — an instance we reused via\n // the last-known-port cache was already running before we got here, and\n // should stay running after.\n spawned?.kill(\"SIGTERM\");\n }\n}\n"],"names":["ANSI_PATTERN","LOCAL_URL_PATTERN","isPortActive","port","resolve","socket","net","readCachedPort","cacheFile","readFileSync","writeCachedPort","mkdirSync","dirname","writeFileSync","spawnAndDetect","target","timeoutMs","reject","child","spawn","settled","timer","handleOutput","data","isError","text","line","label","match","url","_a","_b","err","code","toLaunchTarget","name","server","launchAndDetectStorybook","cachedPort","distDir","fileURLToPath","openBrowser","startCmd","startDevServer","engineConfig","webServers","options","sourceOfTruth","sourceOfTruthServer","targetServer","devPort","sourceOfTruthRunning","targetRunning","spawned","app","express","publicDir","join","headerPath","req","res","next","html","createProxyMiddleware","cleaningUp","cleanup","addFormats","ajvFormatsModule.default","ajv","Ajv","validate","schema","validateFileConfig","path","errors","error","extra","MANTINE_ADAPTER_PACKAGE_NAME","CONFIG_FILE_NAME","DEFAULT_STORYBOOK_COMMAND","DEFAULT_STORYBOOK_PORT","DEFAULT_SOURCE_OF_TRUTH_PORT","DEFAULT_SOURCE_OF_TRUTH_NAME","DEFAULT_GOLDEN_THRESHOLD_PIXELS","DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS","readOwnPackageJson","cwd","existsSync","detectOwnPort","storybookScript","detectOwnName","loadFileConfig","resolveConfig","overrides","file","isSourceOfTruthAdapter","ownName","ownPort","ownCommand","ownCwd","_c","ownWebServer","sharedEngineConfig","sourceOfTruthName","sourceOfTruthPort","sourceOfTruthWebServer","sourceOfTruthGolden","sourceOfTruthCwd","mantineAdapterVersion","mantineSourceOfTruthWebServer","testingEntry","pathToFileURL","args","sourceOfTruthVersion","sourceOfTruthVersionFlagIndex","value","OWN_FLAGS","passthroughArgs","arg","main","runAutomated","config","runDir","ownTarget","result","spawnSync"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"cli.js","sources":["../src/portDiscovery.ts","../src/devServer.ts","../src/validateFileConfig.ts","../src/fileConfig.ts","../src/cli.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport net from \"node:net\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\n\n/**\n * Boots a target's Storybook and discovers the real port it ends up on,\n * instead of pinning one via `-p`/`--port`. Storybook silently falls back to\n * an OS-assigned port whenever its default/configured one is taken (this is\n * what caused the flaky `webServer` timeouts noted in mui-adapter), so the\n * only reliable source of truth is the URL it prints in its own startup\n * banner. Used by both the automated/headless run (cli.ts) and Dev Mode\n * (devServer.ts) — neither pins a port anymore.\n */\n\nexport interface LaunchTarget {\n /** Human-readable name used in log lines. */\n name: string;\n command: string;\n cwd: string;\n /** Reuse an already-running instance (detected via the last-known-port\n * cache) instead of spawning a new one. Mirrors the old `reuseExistingServer`\n * behavior, which used to just probe the one fixed configured port. */\n reuseExistingServer: boolean;\n /** File the discovered port is cached in between runs, so a later\n * `reuseExistingServer` run knows where to look. One per target. */\n cacheFile: string;\n timeoutMs?: number;\n}\n\nexport interface DiscoveredServer {\n url: string;\n port: number;\n /** The process we spawned, or `null` if an already-running instance was\n * reused — callers should only kill what they started. */\n process: ChildProcess | null;\n}\n\n// Storybook prints its bound address in its startup banner wrapped in ANSI\n// color codes and box-drawing chars, e.g.:\n// │ │ - Local: http://localhost:57496/ │ │\n// Strip ANSI first, then match the URL itself.\nconst ANSI_PATTERN = /\\x1b\\[[0-9;]*m/g;\nconst LOCAL_URL_PATTERN = /Local:\\s*(https?:\\/\\/localhost:\\d+)/;\n\nfunction isPortActive(port: number): Promise<boolean> {\n return new Promise((resolve) => {\n const socket = new net.Socket();\n socket.setTimeout(200);\n socket.once(\"connect\", () => {\n socket.destroy();\n resolve(true);\n });\n socket.once(\"timeout\", () => {\n socket.destroy();\n resolve(false);\n });\n socket.once(\"error\", () => {\n socket.destroy();\n resolve(false);\n });\n socket.connect(port, \"127.0.0.1\");\n });\n}\n\nfunction readCachedPort(cacheFile: string): number | undefined {\n try {\n const port = JSON.parse(readFileSync(cacheFile, \"utf8\")).port;\n return typeof port === \"number\" ? port : undefined;\n } catch {\n return undefined;\n }\n}\n\nfunction writeCachedPort(cacheFile: string, port: number): void {\n mkdirSync(dirname(cacheFile), { recursive: true });\n writeFileSync(cacheFile, JSON.stringify({ port }));\n}\n\n/** Spawns `target.command`, streaming its output to the console like before,\n * and resolves once it reports the URL it actually bound to. */\nfunction spawnAndDetect(\n target: LaunchTarget,\n timeoutMs: number,\n): Promise<DiscoveredServer> {\n return new Promise((resolve, reject) => {\n const child = spawn(target.command, {\n cwd: target.cwd,\n stdio: \"pipe\",\n shell: true,\n });\n\n let settled = false;\n const timer = setTimeout(() => {\n if (settled) return;\n settled = true;\n child.kill();\n reject(\n new Error(\n `Timed out after ${timeoutMs}ms waiting for ${target.name}'s Storybook to report its URL (no \"Local: http://localhost:<port>\" line seen in its output).`,\n ),\n );\n }, timeoutMs);\n\n const handleOutput = (data: Buffer, isError: boolean) => {\n const text = data.toString();\n for (const line of text.split(\"\\n\")) {\n if (line.trim()) {\n const label = isError\n ? `${target.name} SB ERROR`\n : `${target.name} SB`;\n (isError ? console.error : console.log)(`[${label}] ${line.trim()}`);\n }\n }\n if (settled) return;\n const match = text.replace(ANSI_PATTERN, \"\").match(LOCAL_URL_PATTERN);\n if (match) {\n settled = true;\n clearTimeout(timer);\n // Non-null: LOCAL_URL_PATTERN has exactly one capture group, and a\n // match only happens when it participated.\n const url = match[1]!;\n const port = Number(new URL(url).port);\n writeCachedPort(target.cacheFile, port);\n resolve({ url, port, process: child });\n }\n };\n child.stdout?.on(\"data\", (data: Buffer) => handleOutput(data, false));\n child.stderr?.on(\"data\", (data: Buffer) => handleOutput(data, true));\n child.on(\"error\", (err) => {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n reject(err);\n });\n child.on(\"exit\", (code) => {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n reject(\n new Error(\n `${target.name}'s Storybook exited (code ${code}) before reporting its URL.`,\n ),\n );\n });\n });\n}\n\n/** Adapts a resolved `HarnessWebServerConfig` into a `LaunchTarget`. */\nexport function toLaunchTarget(\n name: string,\n server: HarnessWebServerConfig,\n): LaunchTarget {\n return {\n name,\n command: server.command,\n cwd: server.cwd,\n reuseExistingServer: server.reuseExistingServer,\n cacheFile: server.cacheFile,\n timeoutMs: server.timeout,\n };\n}\n\n/** Reuses an already-running Storybook if `reuseExistingServer` is set and\n * the last-known-port cache points at something still listening; otherwise\n * spawns `target.command` fresh and detects the real port from its output. */\nexport async function launchAndDetectStorybook(\n target: LaunchTarget,\n): Promise<DiscoveredServer> {\n if (target.reuseExistingServer) {\n const cachedPort = readCachedPort(target.cacheFile);\n if (cachedPort !== undefined && (await isPortActive(cachedPort))) {\n console.log(\n `[Dev Launcher] ${target.name} is already running on port ${cachedPort} (reused).`,\n );\n return {\n url: `http://localhost:${cachedPort}`,\n port: cachedPort,\n process: null,\n };\n }\n }\n console.log(`[Dev Launcher] Launching Storybook for ${target.name}...`);\n return spawnAndDetect(target, target.timeoutMs ?? 120 * 1000);\n}\n","import { spawn, type ChildProcess } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport express from \"express\";\nimport { createProxyMiddleware } from \"http-proxy-middleware\";\nimport type { AdapterTesterConfig } from \"./config.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\nimport { launchAndDetectStorybook, toLaunchTarget } from \"./portDiscovery.js\";\n\n/**\n * Interactive Dev Mode: a synced, side-by-side browser view of this\n * project's own Storybook and the source of truth, with per-story note\n * taking and an AI-report export. Boots both Storybooks (reusing them if\n * already running) behind a proxy so the own/target pane — which drives\n * the sync and carries Storybook's nav sidebar — loads same-origin on the\n * left, with the source of truth following along as a bare preview on the\n * right.\n *\n * Config-driven — takes the same `{ engineConfig, webServers }` shape\n * `resolveConfig()` produces, in the same [sourceOfTruth, target] order.\n */\n\nconst distDir = dirname(fileURLToPath(import.meta.url));\n\nfunction openBrowser(url: string): void {\n const startCmd =\n process.platform === \"darwin\"\n ? \"open\"\n : process.platform === \"win32\"\n ? \"start\"\n : \"xdg-open\";\n console.log(`[Dev Launcher] Auto-launching browser: ${url}`);\n spawn(startCmd, [url], { shell: process.platform === \"win32\" }).on(\n \"error\",\n (err) => {\n console.error(`[Dev Launcher] Failed to auto-launch browser:`, err);\n },\n );\n}\n\nexport interface DevServerOptions {\n /** Port the dev-mode proxy UI itself listens on. Defaults to 6010. */\n port?: number;\n}\n\nexport async function startDevServer(\n engineConfig: AdapterTesterConfig,\n webServers: HarnessWebServerConfig[],\n options: DevServerOptions = {},\n): Promise<void> {\n const [sourceOfTruth, target] = engineConfig.targets;\n const [sourceOfTruthServer, targetServer] = webServers;\n if (\n !sourceOfTruth?.sourceOfTruth ||\n !target ||\n target.sourceOfTruth ||\n !sourceOfTruthServer ||\n !targetServer\n ) {\n throw new Error(\n \"adapter-tester dev mode requires exactly two targets: [sourceOfTruth, target] — check adapter-tester.config.json.\",\n );\n }\n\n const devPort = options.port ?? 6010;\n\n // Neither Storybook is pinned to a specific port — each one silently\n // falls back to an OS-assigned port whenever its default/configured one is\n // taken, so the real port is only known once it reports it (see\n // portDiscovery.ts). Booted concurrently since neither depends on the other.\n console.log(\n `[Dev Launcher] Resolving ${sourceOfTruth.name} and ${target.name} Storybooks...`,\n );\n const [sourceOfTruthRunning, targetRunning] = await Promise.all([\n launchAndDetectStorybook(\n toLaunchTarget(sourceOfTruth.name, sourceOfTruthServer),\n ),\n launchAndDetectStorybook(toLaunchTarget(target.name, targetServer)),\n ]);\n console.log(`[Dev Launcher] Both Storybooks are active and responsive!`);\n\n const spawned = [sourceOfTruthRunning.process, targetRunning.process].filter(\n (child): child is ChildProcess => child !== null,\n );\n\n const app = express();\n const publicDir = join(distDir, \"../public\");\n const headerPath = join(distDir, \"../report-header.txt\");\n\n // Serve the Dev Mode UI at the root path ONLY if there is no query string.\n // This allows the iframe (which loads with ?path=/story/...) to pass\n // through to the proxy, avoiding an infinite loop of nested wrappers.\n app.get(\"/\", (req, res, next) => {\n if (req.query.path) {\n next();\n return;\n }\n const html = readFileSync(join(publicDir, \"index.html\"), \"utf8\").replace(\n \"<head>\",\n `<head>\\n <script>window.__ADAPTER_TESTER__ = ${JSON.stringify({\n ownName: target.name,\n sourceOfTruthName: sourceOfTruth.name,\n sourceOfTruthPort: sourceOfTruthRunning.port,\n })};</script>`,\n );\n res.send(html);\n });\n\n // Serve the AI prompt header dynamically so it can be edited externally.\n // `reportHeader` in adapter-tester.config.json overrides the file entirely.\n app.get(\"/report-header.txt\", (req, res) => {\n if (engineConfig.reportHeader !== undefined) {\n res.type(\"text/plain\").send(engineConfig.reportHeader);\n return;\n }\n try {\n res.type(\"text/plain\").send(readFileSync(headerPath, \"utf8\"));\n } catch {\n res.status(500).send(\"Error loading report-header.txt\");\n }\n });\n\n // Proxy everything else to this project's own Storybook, preserving\n // absolute paths (e.g. /@vite/client) so HMR keeps working same-origin.\n // This is the pane that drives the sync and shows Storybook's nav sidebar.\n app.use(\n \"/\",\n createProxyMiddleware({\n target: targetRunning.url,\n changeOrigin: true,\n ws: true,\n }),\n );\n\n let cleaningUp = false;\n const cleanup = () => {\n if (cleaningUp) return;\n cleaningUp = true;\n console.log(\n \"\\n[Dev Launcher] Shutting down Dev Mode server and spawned Storybooks...\",\n );\n for (const child of spawned) child.kill(\"SIGINT\");\n process.exit(0);\n };\n process.on(\"SIGINT\", cleanup);\n process.on(\"SIGTERM\", cleanup);\n\n app.listen(devPort, () => {\n console.log(`\n====================================================\n🚀 Adapter Dev Mode proxy running at:\n http://localhost:${devPort}\n====================================================\n`);\n openBrowser(`http://localhost:${devPort}`);\n });\n}\n","import { Ajv } from \"ajv\";\nimport * as ajvFormatsModule from \"ajv-formats\";\nimport type { FormatsPlugin } from \"ajv-formats\";\nimport schema from \"./adapter-tester.schema.json\" with { type: \"json\" };\n\n// ajv-formats ships an ESM-style `export default` on a CJS build with no\n// `\"type\"` field, which under `moduleResolution: NodeNext` TS resolves to\n// the raw module namespace instead of unwrapping the default — a known\n// ajv-formats/TS interop gap, not a version mismatch.\nconst addFormats = (ajvFormatsModule as unknown as { default: FormatsPlugin })\n .default;\n\nconst ajv = new Ajv({ allErrors: true, strict: true });\naddFormats(ajv);\nconst validate = ajv.compile(schema);\n\n/**\n * Validates a parsed `adapter-tester.config.json` against\n * `adapter-tester.schema.json`. Throws with every violation listed — callers\n * must not silently coerce or drop invalid fields.\n */\nexport function validateFileConfig(data: unknown, path: string): void {\n if (validate(data)) return;\n\n const errors = (validate.errors ?? [])\n .map((error) => {\n const extra = error.params?.additionalProperty\n ? ` '${error.params.additionalProperty}'`\n : \"\";\n return ` - ${error.instancePath || \"root\"} ${error.message}${extra}`;\n })\n .join(\"\\n\");\n throw new Error(`Invalid ${path}:\\n${errors}`);\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type {\n AdapterTesterConfig,\n SourceOfTruthGoldenLocation,\n StoryOverride,\n} from \"./config.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\nimport { mantineSourceOfTruthWebServer } from \"./harness/mantineSourceOfTruth.js\";\nimport { validateFileConfig } from \"./validateFileConfig.js\";\n\nconst MANTINE_ADAPTER_PACKAGE_NAME = \"@recursica/mantine-adapter\";\n\nexport const CONFIG_FILE_NAME = \"adapter-tester.config.json\";\nconst DEFAULT_STORYBOOK_COMMAND = \"npm run storybook\";\nconst DEFAULT_STORYBOOK_PORT = 6006;\nconst DEFAULT_SOURCE_OF_TRUTH_PORT = 6011;\nconst DEFAULT_SOURCE_OF_TRUTH_NAME = \"Mantine\";\nconst DEFAULT_GOLDEN_THRESHOLD_PIXELS = 10;\nconst DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS = 3500;\n\ninterface StorybookTargetFileConfig {\n /** First-guess port only, not authoritative — the real port is\n * auto-detected from this Storybook's own startup output, since Storybook\n * silently falls back to an OS-assigned port whenever this one is taken.\n * Auto-detected from this project's own `scripts.storybook` (a `-p\n * <port>`/`--port <port>` flag) when omitted, falling back to 6006. */\n port?: number;\n /** Command that boots the target's Storybook. Defaults to `npm run storybook`. */\n command?: string;\n /** Directory the command runs in, relative to the config file. Defaults to \".\" */\n cwd?: string;\n}\n\ninterface MantineHarnessSourceOfTruthFileConfig {\n /** Default mode: boots a throwaway harness that installs the published\n * `@recursica/mantine-adapter` from npm — no monorepo checkout required. */\n type?: \"mantine-harness\";\n /** First-guess port only, not authoritative — see `HarnessWebServerConfig.port`. */\n port?: number;\n mantineAdapterVersion?: string;\n storybookTemplateVersion?: string;\n}\n\ninterface UrlSourceOfTruthFileConfig {\n /** Non-standard mode: points at an already-addressable Storybook — e.g. a\n * sibling workspace package's own Storybook inside this monorepo. */\n type: \"url\";\n name?: string;\n /** First-guess port only, not authoritative — see `HarnessWebServerConfig.port`.\n * Defaults to 6011. */\n port?: number;\n command?: string;\n cwd?: string;\n}\n\ntype SourceOfTruthFileConfig =\n | MantineHarnessSourceOfTruthFileConfig\n | UrlSourceOfTruthFileConfig;\n\nexport interface AdapterTesterFileConfig {\n /** Label for this project's own target. Defaults to the unscoped name in\n * this project's package.json (e.g. \"@recursica/mui-adapter\" -> \"mui-adapter\"). */\n name?: string;\n storybook?: StorybookTargetFileConfig;\n sourceOfTruth?: SourceOfTruthFileConfig;\n goldenThresholdPixels?: number;\n sourceOfTruthThresholdPixels?: number;\n stories?: Record<string, StoryOverride>;\n excludeTitlePrefixes?: string[];\n /** Overrides the AI report header text shown in Dev Mode's \"Full Report\"\n * export. Defaults to the contents of `report-header.txt`. */\n reportHeader?: string;\n /**\n * True only for the source-of-truth adapter's own config (mantine-adapter).\n * Skips `sourceOfTruth` entirely — there's nothing above it to diverge\n * from — and runs the own-drift golden check standalone, against just this\n * project's own Storybook. Defaults to false.\n */\n isSourceOfTruthAdapter?: boolean;\n}\n\nexport interface ResolvedAdapterTesterConfig {\n engineConfig: AdapterTesterConfig;\n webServers: HarnessWebServerConfig[];\n}\n\nexport interface ResolveConfigOverrides {\n /** From `--source-of-truth-version`. Overrides `sourceOfTruth.mantineAdapterVersion`. */\n mantineAdapterVersion?: string;\n}\n\nfunction readOwnPackageJson(cwd: string): any {\n const path = join(cwd, \"package.json\");\n if (!existsSync(path)) {\n throw new Error(\n `No package.json found in ${cwd} — run adapter-tester from the root of the project being tested.`,\n );\n }\n return JSON.parse(readFileSync(path, \"utf8\"));\n}\n\nfunction detectOwnPort(cwd: string): number {\n const pkg = readOwnPackageJson(cwd);\n const storybookScript = pkg.scripts?.storybook as string | undefined;\n const match = storybookScript?.match(/(?:-p|--port)[ =](\\d+)/);\n return match ? Number(match[1]) : DEFAULT_STORYBOOK_PORT;\n}\n\nfunction detectOwnName(cwd: string): string {\n const pkg = readOwnPackageJson(cwd);\n const name = pkg.name as string | undefined;\n return name ? name.split(\"/\").pop()! : \"Adapter\";\n}\n\nfunction loadFileConfig(cwd: string): AdapterTesterFileConfig {\n const path = join(cwd, CONFIG_FILE_NAME);\n if (!existsSync(path)) {\n return {};\n }\n const data = JSON.parse(readFileSync(path, \"utf8\"));\n validateFileConfig(data, path);\n return data;\n}\n\n/**\n * Loads `adapter-tester.config.json` from `cwd` (or falls back to defaults\n * when the file doesn't exist) and resolves it into the engine config\n * `resolveVisualRegressionPlan` consumes plus the Playwright `webServer` entries\n * needed to boot both sides of the comparison.\n *\n * Default mode (no `sourceOfTruth`/`storybook` set): compares this project's\n * own Storybook against a throwaway Mantine harness — no monorepo checkout\n * required. Set `sourceOfTruth.type: \"url\"` for the non-standard mode used\n * to compare sibling workspace packages inside this monorepo.\n *\n * `overrides.mantineAdapterVersion` (from `--source-of-truth-version`) pins\n * the mantine-harness install/golden-fetch version for this run, overriding\n * `sourceOfTruth.mantineAdapterVersion`. Throws if passed together with\n * `isSourceOfTruthAdapter` or `sourceOfTruth.type: \"url\"` — neither has a\n * version to pin.\n */\nexport function resolveConfig(\n cwd: string,\n overrides: ResolveConfigOverrides = {},\n): ResolvedAdapterTesterConfig {\n const file = loadFileConfig(cwd);\n const isSourceOfTruthAdapter = file.isSourceOfTruthAdapter ?? false;\n\n if (overrides.mantineAdapterVersion && isSourceOfTruthAdapter) {\n throw new Error(\n \"--source-of-truth-version has no effect on the source-of-truth adapter's own config (isSourceOfTruthAdapter: true) — there's nothing to pin a version for.\",\n );\n }\n\n const ownName = file.name ?? detectOwnName(cwd);\n const ownPort = file.storybook?.port ?? detectOwnPort(cwd);\n const ownCommand = file.storybook?.command ?? DEFAULT_STORYBOOK_COMMAND;\n const ownCwd = resolve(cwd, file.storybook?.cwd ?? \".\");\n const ownWebServer: HarnessWebServerConfig = {\n command: ownCommand,\n port: ownPort,\n cwd: ownCwd,\n reuseExistingServer: !process.env.CI,\n cacheFile: join(cwd, \".adapter-tester\", \"last-port-own.json\"),\n timeout: 120 * 1000,\n };\n\n const sharedEngineConfig = {\n goldenThresholdPixels:\n file.goldenThresholdPixels ?? DEFAULT_GOLDEN_THRESHOLD_PIXELS,\n sourceOfTruthThresholdPixels:\n file.sourceOfTruthThresholdPixels ??\n DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS,\n stories: file.stories,\n excludeTitlePrefixes: file.excludeTitlePrefixes,\n reportHeader: file.reportHeader,\n // Keyed off `ownCwd`, not `cwd` — the project actually being tested, not\n // wherever the config file happens to live. Matters whenever\n // `storybook.cwd` points at a sibling package: its goldens must resolve\n // to that package's own `test/golden/` (the same directory used when\n // that package runs adapter-tester directly), not a directory under\n // wherever this config file lives.\n goldenDir: join(ownCwd, \"test\", \"golden\"),\n isSourceOfTruthAdapter,\n // Overwritten by the CLI from --update-golden/--approve-divergence.\n goldenMode: \"check\" as const,\n // Overwritten by the CLI from --divergence-only.\n checkMode: \"own\" as const,\n };\n\n // The source-of-truth adapter's own config has nothing above it to\n // diverge from — no second target, no harness/webServer for it at all.\n if (isSourceOfTruthAdapter) {\n return {\n engineConfig: {\n ...sharedEngineConfig,\n targets: [{ name: ownName, url: `http://localhost:${ownPort}` }],\n },\n webServers: [ownWebServer],\n };\n }\n\n const sourceOfTruth = file.sourceOfTruth ?? {\n type: \"mantine-harness\" as const,\n };\n\n let sourceOfTruthName: string;\n let sourceOfTruthPort: number;\n let sourceOfTruthWebServer: HarnessWebServerConfig;\n let sourceOfTruthGolden: SourceOfTruthGoldenLocation;\n\n if (sourceOfTruth.type === \"url\") {\n if (overrides.mantineAdapterVersion) {\n throw new Error(\n '--source-of-truth-version has no effect with sourceOfTruth.type: \"url\" — that mode reads a sibling package\\'s local checkout directly, not a published version.',\n );\n }\n sourceOfTruthName = sourceOfTruth.name ?? DEFAULT_SOURCE_OF_TRUTH_NAME;\n sourceOfTruthPort = sourceOfTruth.port ?? DEFAULT_SOURCE_OF_TRUTH_PORT;\n const sourceOfTruthCwd = resolve(cwd, sourceOfTruth.cwd ?? \".\");\n sourceOfTruthWebServer = {\n command: sourceOfTruth.command ?? DEFAULT_STORYBOOK_COMMAND,\n port: sourceOfTruthPort,\n cwd: sourceOfTruthCwd,\n reuseExistingServer: !process.env.CI,\n cacheFile: join(cwd, \".adapter-tester\", \"last-port-source-of-truth.json\"),\n timeout: 120 * 1000,\n };\n // Sibling package already checked out locally — read its golden files\n // directly, including any uncommitted local changes. No install, no\n // network call.\n sourceOfTruthGolden = {\n type: \"local\",\n dir: join(sourceOfTruthCwd, \"test\", \"golden\"),\n };\n } else {\n sourceOfTruthName = DEFAULT_SOURCE_OF_TRUTH_NAME;\n sourceOfTruthPort = sourceOfTruth.port ?? DEFAULT_SOURCE_OF_TRUTH_PORT;\n const mantineAdapterVersion =\n overrides.mantineAdapterVersion ?? sourceOfTruth.mantineAdapterVersion;\n sourceOfTruthWebServer = mantineSourceOfTruthWebServer({\n dir: join(cwd, \".adapter-tester/mantine-harness\"),\n port: sourceOfTruthPort,\n mantineAdapterVersion,\n storybookTemplateVersion: sourceOfTruth.storybookTemplateVersion,\n });\n // No local checkout — resolve the installed version against the npm\n // registry and fetch that version's golden files from the public repo.\n // Never needs `sourceOfTruthWebServer` above; the golden check on its\n // own doesn't boot a second Storybook at all (see cli.ts).\n sourceOfTruthGolden = {\n type: \"npm\",\n packageName: MANTINE_ADAPTER_PACKAGE_NAME,\n versionSpec: mantineAdapterVersion ?? \"latest\",\n cacheDir: join(cwd, \".adapter-tester/mantine-golden-cache\"),\n };\n }\n\n return {\n engineConfig: {\n ...sharedEngineConfig,\n targets: [\n {\n name: sourceOfTruthName,\n url: `http://localhost:${sourceOfTruthPort}`,\n sourceOfTruth: true,\n },\n { name: ownName, url: `http://localhost:${ownPort}` },\n ],\n sourceOfTruthGolden,\n },\n // [sourceOfTruth, own] — Dev Mode needs both; the automated golden run\n // (cli.ts) only ever boots the last entry, since its divergence check\n // reads stored golden files, not a live source-of-truth page.\n webServers: [sourceOfTruthWebServer, ownWebServer],\n };\n}\n","import { spawnSync } from \"node:child_process\";\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport type { AdapterTesterConfig } from \"./config.js\";\nimport { startDevServer } from \"./devServer.js\";\nimport { resolveConfig } from \"./fileConfig.js\";\nimport type { HarnessWebServerConfig } from \"./harness/mantineSourceOfTruth.js\";\nimport { launchAndDetectStorybook, toLaunchTarget } from \"./portDiscovery.js\";\n\n// `dist/testing.js` is always a sibling of this file — both inside a\n// consumer's node_modules/@recursica/adapter-tester/dist and inside this\n// monorepo's own packages/adapter-tester/dist when self-hosting — so the\n// generated spec below can reach it without depending on how the package\n// itself resolves at import time.\nconst distDir = dirname(fileURLToPath(import.meta.url));\nconst testingEntry = pathToFileURL(join(distDir, \"testing.js\")).href;\n\n// `--source-of-truth-version <value>` takes a value, unlike every other own\n// flag below — pulled out of argv first so the boolean flags/passthrough\n// logic never has to know it exists.\nconst args = process.argv.slice(2);\nlet sourceOfTruthVersion: string | undefined;\nconst sourceOfTruthVersionFlagIndex = args.indexOf(\"--source-of-truth-version\");\nif (sourceOfTruthVersionFlagIndex !== -1) {\n const value = args[sourceOfTruthVersionFlagIndex + 1];\n if (value === undefined || value.startsWith(\"--\")) {\n throw new Error(\n \"--source-of-truth-version requires a value, e.g. --source-of-truth-version 0.53.0\",\n );\n }\n sourceOfTruthVersion = value;\n args.splice(sourceOfTruthVersionFlagIndex, 2);\n}\n\nconst cwd = process.cwd();\nconst { engineConfig, webServers } = resolveConfig(cwd, {\n mantineAdapterVersion: sourceOfTruthVersion,\n});\n\nif (args.includes(\"--update-golden\")) {\n engineConfig.goldenMode = \"update-golden\";\n} else if (args.includes(\"--approve-divergence\")) {\n engineConfig.goldenMode = \"approve-divergence\";\n}\n\nif (args.includes(\"--divergence-only\")) {\n if (engineConfig.isSourceOfTruthAdapter) {\n throw new Error(\n \"--divergence-only has nothing to diverge from — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json.\",\n );\n }\n engineConfig.checkMode = \"divergence\";\n} else if (engineConfig.goldenMode === \"approve-divergence\") {\n throw new Error(\n \"--approve-divergence only makes sense with --divergence-only — there's nothing to approve without the divergence check running.\",\n );\n}\n\nif (args.includes(\"--dry-run\")) {\n console.log(JSON.stringify({ engineConfig, webServers }, null, 2));\n process.exit(0);\n}\n\n// Any arg besides our own flags is passed straight through to `playwright\n// test` — e.g. `npm run adapter-tester:automated -- --grep \"Toast\"` to scope\n// a run to matching stories, instead of every invocation running the full\n// suite. Our own flags are consumed above, not forwarded — Playwright itself\n// doesn't know about them.\nconst OWN_FLAGS = new Set([\n \"--dry-run\",\n \"--serve\",\n \"--update-golden\",\n \"--approve-divergence\",\n \"--divergence-only\",\n]);\nconst passthroughArgs = args.filter((arg) => !OWN_FLAGS.has(arg));\n\n// The bundled build target doesn't support top-level await, so the async\n// work (launching Storybook and detecting its real port) lives in main().\nmain().catch((err) => {\n console.error(err);\n process.exitCode = 1;\n});\n\nasync function main(): Promise<void> {\n if (args.includes(\"--serve\")) {\n if (engineConfig.isSourceOfTruthAdapter) {\n throw new Error(\n \"Dev Mode (--serve) has nothing to sync this project's Storybook against — isSourceOfTruthAdapter is true in this project's adapter-tester.config.json.\",\n );\n }\n // Dual-Storybook interactive Dev Mode — no Playwright, no screenshots.\n // Used by the `adapter-tester` npm script.\n await startDevServer(engineConfig, webServers);\n } else {\n // The golden-image checks never need the source-of-truth adapter's own\n // Storybook running — the divergence check reads its stored golden files,\n // not a live page — so only the last (own) webServer is booted here. Dev\n // Mode above is the one thing that still needs both.\n const ownWebServer = webServers.at(-1);\n if (!ownWebServer) {\n throw new Error(\"resolveConfig() returned no webServers to boot.\");\n }\n await runAutomated(ownWebServer, engineConfig);\n }\n}\n\n/**\n * Boots this project's own Storybook (auto-detecting the port it actually\n * lands on — see portDiscovery.ts), generates a throwaway Playwright config\n * + spec under `.adapter-tester/run/`, and runs the automated pixel-diff\n * suite against it. Used by the `adapter-tester:automated` npm script.\n *\n * Playwright's own `webServer` option can't be used here — it only knows how\n * to poll a port/URL decided *before* the command it spawns runs, but\n * Storybook silently falls back to a different, OS-assigned port whenever\n * its configured one is taken. So this boots and waits for Storybook itself,\n * then points the generated config straight at whatever URL it actually\n * reports.\n */\nasync function runAutomated(\n server: HarnessWebServerConfig,\n config: AdapterTesterConfig,\n): Promise<void> {\n const runDir = join(cwd, \".adapter-tester/run\");\n mkdirSync(runDir, { recursive: true });\n\n const ownTarget = config.targets.at(-1);\n if (!ownTarget) {\n throw new Error(\"resolveConfig() returned no targets to check.\");\n }\n const { url, process: spawned } = await launchAndDetectStorybook(\n toLaunchTarget(ownTarget.name, server),\n );\n ownTarget.url = url;\n\n writeFileSync(\n join(runDir, \"playwright.config.js\"),\n `// Generated by \\`adapter-tester\\` — do not edit, regenerated on every run.\nimport { defineConfig, devices } from \"@playwright/test\";\n\nexport default defineConfig({\n testDir: ${JSON.stringify(runDir)},\n // Each golden check only reads/writes its own story's manifest.json entry,\n // under a lock, so concurrent workers never race each other (see\n // \\`updateManifestEntry\\`). Defaults to 1 worker (1 Chromium instance) to\n // avoid exhausting memory running the full suite; override with\n // \\`--workers <n>\\` (forwarded straight through to Playwright) to parallelize.\n workers: 1,\n fullyParallel: true,\n forbidOnly: !!process.env.CI,\n retries: process.env.CI ? 2 : 0,\n reporter: [[\"html\", { open: \"never\" }], [\"list\"]],\n use: { trace: \"on-first-retry\" },\n projects: [{ name: \"chromium\", use: { ...devices[\"Desktop Chrome\"] } }],\n // No webServer entry — this project's own Storybook is already running by\n // the time this config is used (see runAutomated() in cli.ts).\n});\n`,\n );\n\n writeFileSync(\n join(runDir, \"visual-regression.spec.js\"),\n `// Generated by \\`adapter-tester\\` — do not edit, regenerated on every run.\nimport { test, expect } from \"@playwright/test\";\nimport { resolveVisualRegressionPlan } from ${JSON.stringify(testingEntry)};\n\n// \\`test.describe\\`/\\`test\\` are called here, not inside resolveVisualRegressionPlan,\n// so Playwright's HTML report groups the suite under this file instead of a\n// sourcemapped path into adapter-tester's own library code.\nconst { ownTargetName, suiteLabel, stories, missingFromSourceOfTruth, checkStory } =\n await resolveVisualRegressionPlan(${JSON.stringify(config, null, 2)});\n\ntest.describe(\\`\\${ownTargetName} — \\${suiteLabel}\\`, () => {\n if (missingFromSourceOfTruth.length > 0) {\n test(\"story parity with source of truth\", () => {\n expect(\n missingFromSourceOfTruth,\n \\`\\${missingFromSourceOfTruth.length} stor(y/ies) exist in the source of truth but are missing here. Add the missing story, or mark it \\\\\\`exclude: true\\\\\\` under \\\\\\`stories\\\\\\` in adapter-tester.config.json if intentional.\\`,\n ).toEqual([]);\n });\n }\n for (const story of stories) {\n test(story.id, async ({ browser }, testInfo) => {\n await checkStory(story, browser, testInfo);\n });\n }\n});\n`,\n );\n\n try {\n const result = spawnSync(\n \"npx\",\n [\n \"playwright\",\n \"test\",\n \"--config\",\n join(runDir, \"playwright.config.js\"),\n ...passthroughArgs,\n ],\n { stdio: \"inherit\", cwd, shell: process.platform === \"win32\" },\n );\n process.exitCode = result.status ?? 1;\n } finally {\n // Only tear down the Storybook we spawned — an instance we reused via\n // the last-known-port cache was already running before we got here, and\n // should stay running after.\n spawned?.kill(\"SIGTERM\");\n }\n}\n"],"names":["ANSI_PATTERN","LOCAL_URL_PATTERN","isPortActive","port","resolve","socket","net","readCachedPort","cacheFile","readFileSync","writeCachedPort","mkdirSync","dirname","writeFileSync","spawnAndDetect","target","timeoutMs","reject","child","spawn","settled","timer","handleOutput","data","isError","text","line","label","match","url","_a","_b","err","code","toLaunchTarget","name","server","launchAndDetectStorybook","cachedPort","distDir","fileURLToPath","openBrowser","startCmd","startDevServer","engineConfig","webServers","options","sourceOfTruth","sourceOfTruthServer","targetServer","devPort","sourceOfTruthRunning","targetRunning","spawned","app","express","publicDir","join","headerPath","req","res","next","html","createProxyMiddleware","cleaningUp","cleanup","addFormats","ajvFormatsModule.default","ajv","Ajv","validate","schema","validateFileConfig","path","errors","error","extra","MANTINE_ADAPTER_PACKAGE_NAME","CONFIG_FILE_NAME","DEFAULT_STORYBOOK_COMMAND","DEFAULT_STORYBOOK_PORT","DEFAULT_SOURCE_OF_TRUTH_PORT","DEFAULT_SOURCE_OF_TRUTH_NAME","DEFAULT_GOLDEN_THRESHOLD_PIXELS","DEFAULT_SOURCE_OF_TRUTH_THRESHOLD_PIXELS","readOwnPackageJson","cwd","existsSync","detectOwnPort","storybookScript","detectOwnName","loadFileConfig","resolveConfig","overrides","file","isSourceOfTruthAdapter","ownName","ownPort","ownCommand","ownCwd","_c","ownWebServer","sharedEngineConfig","sourceOfTruthName","sourceOfTruthPort","sourceOfTruthWebServer","sourceOfTruthGolden","sourceOfTruthCwd","mantineAdapterVersion","mantineSourceOfTruthWebServer","testingEntry","pathToFileURL","args","sourceOfTruthVersion","sourceOfTruthVersionFlagIndex","value","OWN_FLAGS","passthroughArgs","arg","main","runAutomated","config","runDir","ownTarget","result","spawnSync"],"mappings":"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"}
|
package/dist/config.d.ts
CHANGED
|
@@ -95,6 +95,9 @@ export interface AdapterTesterConfig {
|
|
|
95
95
|
goldenMode: GoldenMode;
|
|
96
96
|
/** Set by the CLI from `--divergence-only`. Defaults to `"own"`. */
|
|
97
97
|
checkMode: CheckMode;
|
|
98
|
+
/** Overrides the AI report header text (normally read from
|
|
99
|
+
* `report-header.txt`) shown in Dev Mode's "Full Report" export. */
|
|
100
|
+
reportHeader?: string;
|
|
98
101
|
}
|
|
99
102
|
export declare function defineAdapterTesterConfig(config: AdapterTesterConfig): AdapterTesterConfig;
|
|
100
103
|
export declare function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget;
|
package/dist/config.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;mEAEmE;AACnE,MAAM,MAAM,2BAA2B,GACnC;IACE;+EAC2E;IAC3E,IAAI,EAAE,OAAO,CAAC;IACd,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE;;gFAE4E;IAC5E,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B;kCAC8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;mBAGe;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;oFACgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB;;4BAEwB;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;;kDAK8C;IAC9C,4BAA4B,EAAE,MAAM,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;2CACuC;IACvC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,2FAA2F;IAC3F,UAAU,EAAE,UAAU,CAAC;IACvB,oEAAoE;IACpE,SAAS,EAAE,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;mEAEmE;AACnE,MAAM,MAAM,2BAA2B,GACnC;IACE;+EAC2E;IAC3E,IAAI,EAAE,OAAO,CAAC;IACd,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE;;gFAE4E;IAC5E,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B;kCAC8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;mBAGe;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;oFACgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB;;4BAEwB;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;;kDAK8C;IAC9C,4BAA4B,EAAE,MAAM,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;2CACuC;IACvC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,2FAA2F;IAC3F,UAAU,EAAE,UAAU,CAAC;IACvB,oEAAoE;IACpE,SAAS,EAAE,SAAS,CAAC;IACrB;wEACoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAUrB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAM3E"}
|
package/dist/devServer.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../src/devServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAkChF,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,sBAAsB,EAAE,EACpC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../src/devServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAkChF,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,sBAAsB,EAAE,EACpC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA2Gf"}
|
package/dist/fileConfig.d.ts
CHANGED
|
@@ -44,6 +44,9 @@ export interface AdapterTesterFileConfig {
|
|
|
44
44
|
sourceOfTruthThresholdPixels?: number;
|
|
45
45
|
stories?: Record<string, StoryOverride>;
|
|
46
46
|
excludeTitlePrefixes?: string[];
|
|
47
|
+
/** Overrides the AI report header text shown in Dev Mode's "Full Report"
|
|
48
|
+
* export. Defaults to the contents of `report-header.txt`. */
|
|
49
|
+
reportHeader?: string;
|
|
47
50
|
/**
|
|
48
51
|
* True only for the source-of-truth adapter's own config (mantine-adapter).
|
|
49
52
|
* Skips `sourceOfTruth` entirely — there's nothing above it to diverge
|
package/dist/fileConfig.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fileConfig.d.ts","sourceRoot":"","sources":["../src/fileConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EAEnB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAMhF,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAQ7D,UAAU,yBAAyB;IACjC;;;;2EAIuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,qCAAqC;IAC7C;gFAC4E;IAC5E,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,0BAA0B;IAClC;yEACqE;IACrE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;2BACuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,KAAK,uBAAuB,GACxB,qCAAqC,GACrC,0BAA0B,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC;uFACmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,sBAA2B,GACrC,2BAA2B,
|
|
1
|
+
{"version":3,"file":"fileConfig.d.ts","sourceRoot":"","sources":["../src/fileConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EAEnB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAMhF,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAQ7D,UAAU,yBAAyB;IACjC;;;;2EAIuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,qCAAqC;IAC7C;gFAC4E;IAC5E,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,0BAA0B;IAClC;yEACqE;IACrE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;2BACuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,KAAK,uBAAuB,GACxB,qCAAqC,GACrC,0BAA0B,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC;uFACmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;kEAC8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,sBAA2B,GACrC,2BAA2B,CAoI7B"}
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n /** Human-readable name used in test titles, report labels, and artifact filenames. */\n name: string;\n /** Base URL the target's Storybook instance is served from. */\n url: string;\n /**\n * Marks this target as the visual/token source of truth every other target\n * is compared against. Exactly one target in a config must set this true.\n */\n sourceOfTruth?: boolean;\n}\n\n/** How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)\n * own golden images, for the divergence check. Never involves booting a\n * Storybook — both `readImage` targets are plain files on disk. */\nexport type SourceOfTruthGoldenLocation =\n | {\n /** Sibling package already checked out locally (this monorepo's own\n * `sourceOfTruth.type: \"url\"` mode) — read its `test/golden/` directly. */\n type: \"local\";\n /** Absolute path to the source-of-truth adapter's `test/golden/` directory. */\n dir: string;\n }\n | {\n /** No local checkout (the default, standalone-repo mode) — resolve the\n * installed version against the npm registry, then fetch that git tag's\n * `test/golden/` from the public GitHub repo, caching what's downloaded. */\n type: \"npm\";\n packageName: string;\n /** npm version/dist-tag to resolve, e.g. \"latest\" or a pinned version. */\n versionSpec: string;\n /** Directory downloaded manifest/images are cached in between runs. */\n cacheDir: string;\n };\n\nexport type GoldenMode = \"check\" | \"update-golden\" | \"approve-divergence\";\n\n/**\n * Which check(s) a run performs. `\"own\"` (the default) is what a normal,\n * fast, no-network run does: this project's own live render vs. its own\n * committed golden images. `\"divergence\"` is the separate, opt-in check\n * against the source-of-truth adapter's published golden images.\n */\nexport type CheckMode = \"own\" | \"divergence\";\n\nexport interface StoryOverride {\n /** Diff threshold override for this story's own-drift check. Overrides\n * `goldenThresholdPixels`. */\n goldenThreshold?: number;\n /** Diff threshold override for this story's source-of-truth divergence\n * check. Overrides `sourceOfTruthThresholdPixels` for components with\n * acceptable cross-library structural variation (e.g. native control\n * widgets). */\n sourceOfTruthThreshold?: number;\n /** Skip this story entirely — no own-drift check, no divergence check, no\n * golden captured. For stories with no meaningful cross-adapter counterpart. */\n exclude?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /** Global pixel-diff threshold for the own-drift check (this project's live\n * render vs. its own committed golden). Same library on both sides, so this\n * should stay tight. */\n goldenThresholdPixels: number;\n /** Global pixel-diff threshold for the source-of-truth divergence check\n * (this project's golden vs. the source-of-truth adapter's golden).\n * Comparing across two different component libraries has legitimate\n * structural variation, so this is expected to be much higher than\n * `goldenThresholdPixels`. Unused on the source-of-truth adapter's own\n * config (`isSourceOfTruthAdapter: true`). */\n sourceOfTruthThresholdPixels: number;\n /**\n * Per-story overrides, keyed by story id prefix (a story matches if its id\n * equals the key or starts with it). When more than one key matches, the\n * longest (most specific) key wins.\n */\n stories?: Record<string, StoryOverride>;\n /**\n * Storybook entry title categories excluded from the comparison — an\n * entry is excluded if its title equals one of these or starts with\n * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n * `@recursica/storybook-template`'s own default token/theme demo stories\n * (which every adapter's Storybook inherits automatically) plus each\n * adapter's own onboarding \"Introduction\" stories — neither has a\n * cross-adapter counterpart to diff against.\n */\n excludeTitlePrefixes?: string[];\n /** Absolute path to this project's own `test/golden/` directory — where\n * golden PNGs and `manifest.json` are stored, committed to git. */\n goldenDir: string;\n /**\n * True only for the source-of-truth adapter's own config (mantine). It has\n * nothing above it to diverge from, so the divergence check is skipped\n * entirely and `sourceOfTruthGolden` is ignored.\n */\n isSourceOfTruthAdapter: boolean;\n /** How to reach the source-of-truth's golden images. Required unless\n * `isSourceOfTruthAdapter` is true. */\n sourceOfTruthGolden?: SourceOfTruthGoldenLocation;\n /** Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `\"check\"`. */\n goldenMode: GoldenMode;\n /** Set by the CLI from `--divergence-only`. Defaults to `\"own\"`. */\n checkMode: CheckMode;\n}\n\nexport function defineAdapterTesterConfig(\n config: AdapterTesterConfig,\n): AdapterTesterConfig {\n const sourceOfTruthCount = config.targets.filter(\n (target) => target.sourceOfTruth,\n ).length;\n if (sourceOfTruthCount !== 1) {\n throw new Error(\n `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n );\n }\n return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n if (!sourceOfTruth) {\n throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n }\n return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.cjs","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n /** Human-readable name used in test titles, report labels, and artifact filenames. */\n name: string;\n /** Base URL the target's Storybook instance is served from. */\n url: string;\n /**\n * Marks this target as the visual/token source of truth every other target\n * is compared against. Exactly one target in a config must set this true.\n */\n sourceOfTruth?: boolean;\n}\n\n/** How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)\n * own golden images, for the divergence check. Never involves booting a\n * Storybook — both `readImage` targets are plain files on disk. */\nexport type SourceOfTruthGoldenLocation =\n | {\n /** Sibling package already checked out locally (this monorepo's own\n * `sourceOfTruth.type: \"url\"` mode) — read its `test/golden/` directly. */\n type: \"local\";\n /** Absolute path to the source-of-truth adapter's `test/golden/` directory. */\n dir: string;\n }\n | {\n /** No local checkout (the default, standalone-repo mode) — resolve the\n * installed version against the npm registry, then fetch that git tag's\n * `test/golden/` from the public GitHub repo, caching what's downloaded. */\n type: \"npm\";\n packageName: string;\n /** npm version/dist-tag to resolve, e.g. \"latest\" or a pinned version. */\n versionSpec: string;\n /** Directory downloaded manifest/images are cached in between runs. */\n cacheDir: string;\n };\n\nexport type GoldenMode = \"check\" | \"update-golden\" | \"approve-divergence\";\n\n/**\n * Which check(s) a run performs. `\"own\"` (the default) is what a normal,\n * fast, no-network run does: this project's own live render vs. its own\n * committed golden images. `\"divergence\"` is the separate, opt-in check\n * against the source-of-truth adapter's published golden images.\n */\nexport type CheckMode = \"own\" | \"divergence\";\n\nexport interface StoryOverride {\n /** Diff threshold override for this story's own-drift check. Overrides\n * `goldenThresholdPixels`. */\n goldenThreshold?: number;\n /** Diff threshold override for this story's source-of-truth divergence\n * check. Overrides `sourceOfTruthThresholdPixels` for components with\n * acceptable cross-library structural variation (e.g. native control\n * widgets). */\n sourceOfTruthThreshold?: number;\n /** Skip this story entirely — no own-drift check, no divergence check, no\n * golden captured. For stories with no meaningful cross-adapter counterpart. */\n exclude?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /** Global pixel-diff threshold for the own-drift check (this project's live\n * render vs. its own committed golden). Same library on both sides, so this\n * should stay tight. */\n goldenThresholdPixels: number;\n /** Global pixel-diff threshold for the source-of-truth divergence check\n * (this project's golden vs. the source-of-truth adapter's golden).\n * Comparing across two different component libraries has legitimate\n * structural variation, so this is expected to be much higher than\n * `goldenThresholdPixels`. Unused on the source-of-truth adapter's own\n * config (`isSourceOfTruthAdapter: true`). */\n sourceOfTruthThresholdPixels: number;\n /**\n * Per-story overrides, keyed by story id prefix (a story matches if its id\n * equals the key or starts with it). When more than one key matches, the\n * longest (most specific) key wins.\n */\n stories?: Record<string, StoryOverride>;\n /**\n * Storybook entry title categories excluded from the comparison — an\n * entry is excluded if its title equals one of these or starts with\n * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n * `@recursica/storybook-template`'s own default token/theme demo stories\n * (which every adapter's Storybook inherits automatically) plus each\n * adapter's own onboarding \"Introduction\" stories — neither has a\n * cross-adapter counterpart to diff against.\n */\n excludeTitlePrefixes?: string[];\n /** Absolute path to this project's own `test/golden/` directory — where\n * golden PNGs and `manifest.json` are stored, committed to git. */\n goldenDir: string;\n /**\n * True only for the source-of-truth adapter's own config (mantine). It has\n * nothing above it to diverge from, so the divergence check is skipped\n * entirely and `sourceOfTruthGolden` is ignored.\n */\n isSourceOfTruthAdapter: boolean;\n /** How to reach the source-of-truth's golden images. Required unless\n * `isSourceOfTruthAdapter` is true. */\n sourceOfTruthGolden?: SourceOfTruthGoldenLocation;\n /** Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `\"check\"`. */\n goldenMode: GoldenMode;\n /** Set by the CLI from `--divergence-only`. Defaults to `\"own\"`. */\n checkMode: CheckMode;\n /** Overrides the AI report header text (normally read from\n * `report-header.txt`) shown in Dev Mode's \"Full Report\" export. */\n reportHeader?: string;\n}\n\nexport function defineAdapterTesterConfig(\n config: AdapterTesterConfig,\n): AdapterTesterConfig {\n const sourceOfTruthCount = config.targets.filter(\n (target) => target.sourceOfTruth,\n ).length;\n if (sourceOfTruthCount !== 1) {\n throw new Error(\n `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n );\n }\n return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n if (!sourceOfTruth) {\n throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n }\n return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":"uIA6GO,SAASA,EACdC,EACqB,CACrB,MAAMC,EAAqBD,EAAO,QAAQ,OACvCE,GAAWA,EAAO,aAAA,EACnB,OACF,GAAID,IAAuB,EACzB,MAAM,IAAI,MACR,8EAA8EA,CAAkB,GAAA,EAGpG,OAAOD,CACT,CAEO,SAASG,EAAiBH,EAA4C,CAC3E,MAAMI,EAAgBJ,EAAO,QAAQ,KAAME,GAAWA,EAAO,aAAa,EAC1E,GAAI,CAACE,EACH,MAAM,IAAI,MAAM,0DAA0D,EAE5E,OAAOA,CACT"}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n /** Human-readable name used in test titles, report labels, and artifact filenames. */\n name: string;\n /** Base URL the target's Storybook instance is served from. */\n url: string;\n /**\n * Marks this target as the visual/token source of truth every other target\n * is compared against. Exactly one target in a config must set this true.\n */\n sourceOfTruth?: boolean;\n}\n\n/** How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)\n * own golden images, for the divergence check. Never involves booting a\n * Storybook — both `readImage` targets are plain files on disk. */\nexport type SourceOfTruthGoldenLocation =\n | {\n /** Sibling package already checked out locally (this monorepo's own\n * `sourceOfTruth.type: \"url\"` mode) — read its `test/golden/` directly. */\n type: \"local\";\n /** Absolute path to the source-of-truth adapter's `test/golden/` directory. */\n dir: string;\n }\n | {\n /** No local checkout (the default, standalone-repo mode) — resolve the\n * installed version against the npm registry, then fetch that git tag's\n * `test/golden/` from the public GitHub repo, caching what's downloaded. */\n type: \"npm\";\n packageName: string;\n /** npm version/dist-tag to resolve, e.g. \"latest\" or a pinned version. */\n versionSpec: string;\n /** Directory downloaded manifest/images are cached in between runs. */\n cacheDir: string;\n };\n\nexport type GoldenMode = \"check\" | \"update-golden\" | \"approve-divergence\";\n\n/**\n * Which check(s) a run performs. `\"own\"` (the default) is what a normal,\n * fast, no-network run does: this project's own live render vs. its own\n * committed golden images. `\"divergence\"` is the separate, opt-in check\n * against the source-of-truth adapter's published golden images.\n */\nexport type CheckMode = \"own\" | \"divergence\";\n\nexport interface StoryOverride {\n /** Diff threshold override for this story's own-drift check. Overrides\n * `goldenThresholdPixels`. */\n goldenThreshold?: number;\n /** Diff threshold override for this story's source-of-truth divergence\n * check. Overrides `sourceOfTruthThresholdPixels` for components with\n * acceptable cross-library structural variation (e.g. native control\n * widgets). */\n sourceOfTruthThreshold?: number;\n /** Skip this story entirely — no own-drift check, no divergence check, no\n * golden captured. For stories with no meaningful cross-adapter counterpart. */\n exclude?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /** Global pixel-diff threshold for the own-drift check (this project's live\n * render vs. its own committed golden). Same library on both sides, so this\n * should stay tight. */\n goldenThresholdPixels: number;\n /** Global pixel-diff threshold for the source-of-truth divergence check\n * (this project's golden vs. the source-of-truth adapter's golden).\n * Comparing across two different component libraries has legitimate\n * structural variation, so this is expected to be much higher than\n * `goldenThresholdPixels`. Unused on the source-of-truth adapter's own\n * config (`isSourceOfTruthAdapter: true`). */\n sourceOfTruthThresholdPixels: number;\n /**\n * Per-story overrides, keyed by story id prefix (a story matches if its id\n * equals the key or starts with it). When more than one key matches, the\n * longest (most specific) key wins.\n */\n stories?: Record<string, StoryOverride>;\n /**\n * Storybook entry title categories excluded from the comparison — an\n * entry is excluded if its title equals one of these or starts with\n * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n * `@recursica/storybook-template`'s own default token/theme demo stories\n * (which every adapter's Storybook inherits automatically) plus each\n * adapter's own onboarding \"Introduction\" stories — neither has a\n * cross-adapter counterpart to diff against.\n */\n excludeTitlePrefixes?: string[];\n /** Absolute path to this project's own `test/golden/` directory — where\n * golden PNGs and `manifest.json` are stored, committed to git. */\n goldenDir: string;\n /**\n * True only for the source-of-truth adapter's own config (mantine). It has\n * nothing above it to diverge from, so the divergence check is skipped\n * entirely and `sourceOfTruthGolden` is ignored.\n */\n isSourceOfTruthAdapter: boolean;\n /** How to reach the source-of-truth's golden images. Required unless\n * `isSourceOfTruthAdapter` is true. */\n sourceOfTruthGolden?: SourceOfTruthGoldenLocation;\n /** Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `\"check\"`. */\n goldenMode: GoldenMode;\n /** Set by the CLI from `--divergence-only`. Defaults to `\"own\"`. */\n checkMode: CheckMode;\n}\n\nexport function defineAdapterTesterConfig(\n config: AdapterTesterConfig,\n): AdapterTesterConfig {\n const sourceOfTruthCount = config.targets.filter(\n (target) => target.sourceOfTruth,\n ).length;\n if (sourceOfTruthCount !== 1) {\n throw new Error(\n `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n );\n }\n return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n if (!sourceOfTruth) {\n throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n }\n return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":";
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../src/config.ts"],"sourcesContent":["export interface AdapterTarget {\n /** Human-readable name used in test titles, report labels, and artifact filenames. */\n name: string;\n /** Base URL the target's Storybook instance is served from. */\n url: string;\n /**\n * Marks this target as the visual/token source of truth every other target\n * is compared against. Exactly one target in a config must set this true.\n */\n sourceOfTruth?: boolean;\n}\n\n/** How `resolveVisualRegressionPlan` reaches the source-of-truth adapter's (mantine)\n * own golden images, for the divergence check. Never involves booting a\n * Storybook — both `readImage` targets are plain files on disk. */\nexport type SourceOfTruthGoldenLocation =\n | {\n /** Sibling package already checked out locally (this monorepo's own\n * `sourceOfTruth.type: \"url\"` mode) — read its `test/golden/` directly. */\n type: \"local\";\n /** Absolute path to the source-of-truth adapter's `test/golden/` directory. */\n dir: string;\n }\n | {\n /** No local checkout (the default, standalone-repo mode) — resolve the\n * installed version against the npm registry, then fetch that git tag's\n * `test/golden/` from the public GitHub repo, caching what's downloaded. */\n type: \"npm\";\n packageName: string;\n /** npm version/dist-tag to resolve, e.g. \"latest\" or a pinned version. */\n versionSpec: string;\n /** Directory downloaded manifest/images are cached in between runs. */\n cacheDir: string;\n };\n\nexport type GoldenMode = \"check\" | \"update-golden\" | \"approve-divergence\";\n\n/**\n * Which check(s) a run performs. `\"own\"` (the default) is what a normal,\n * fast, no-network run does: this project's own live render vs. its own\n * committed golden images. `\"divergence\"` is the separate, opt-in check\n * against the source-of-truth adapter's published golden images.\n */\nexport type CheckMode = \"own\" | \"divergence\";\n\nexport interface StoryOverride {\n /** Diff threshold override for this story's own-drift check. Overrides\n * `goldenThresholdPixels`. */\n goldenThreshold?: number;\n /** Diff threshold override for this story's source-of-truth divergence\n * check. Overrides `sourceOfTruthThresholdPixels` for components with\n * acceptable cross-library structural variation (e.g. native control\n * widgets). */\n sourceOfTruthThreshold?: number;\n /** Skip this story entirely — no own-drift check, no divergence check, no\n * golden captured. For stories with no meaningful cross-adapter counterpart. */\n exclude?: boolean;\n}\n\nexport interface AdapterTesterConfig {\n targets: AdapterTarget[];\n /** Global pixel-diff threshold for the own-drift check (this project's live\n * render vs. its own committed golden). Same library on both sides, so this\n * should stay tight. */\n goldenThresholdPixels: number;\n /** Global pixel-diff threshold for the source-of-truth divergence check\n * (this project's golden vs. the source-of-truth adapter's golden).\n * Comparing across two different component libraries has legitimate\n * structural variation, so this is expected to be much higher than\n * `goldenThresholdPixels`. Unused on the source-of-truth adapter's own\n * config (`isSourceOfTruthAdapter: true`). */\n sourceOfTruthThresholdPixels: number;\n /**\n * Per-story overrides, keyed by story id prefix (a story matches if its id\n * equals the key or starts with it). When more than one key matches, the\n * longest (most specific) key wins.\n */\n stories?: Record<string, StoryOverride>;\n /**\n * Storybook entry title categories excluded from the comparison — an\n * entry is excluded if its title equals one of these or starts with\n * `\"<value>/\"`. Defaults to [\"Theme\", \"Tokens\", \"Introduction\"]:\n * `@recursica/storybook-template`'s own default token/theme demo stories\n * (which every adapter's Storybook inherits automatically) plus each\n * adapter's own onboarding \"Introduction\" stories — neither has a\n * cross-adapter counterpart to diff against.\n */\n excludeTitlePrefixes?: string[];\n /** Absolute path to this project's own `test/golden/` directory — where\n * golden PNGs and `manifest.json` are stored, committed to git. */\n goldenDir: string;\n /**\n * True only for the source-of-truth adapter's own config (mantine). It has\n * nothing above it to diverge from, so the divergence check is skipped\n * entirely and `sourceOfTruthGolden` is ignored.\n */\n isSourceOfTruthAdapter: boolean;\n /** How to reach the source-of-truth's golden images. Required unless\n * `isSourceOfTruthAdapter` is true. */\n sourceOfTruthGolden?: SourceOfTruthGoldenLocation;\n /** Set by the CLI from `--update-golden`/`--approve-divergence`. Defaults to `\"check\"`. */\n goldenMode: GoldenMode;\n /** Set by the CLI from `--divergence-only`. Defaults to `\"own\"`. */\n checkMode: CheckMode;\n /** Overrides the AI report header text (normally read from\n * `report-header.txt`) shown in Dev Mode's \"Full Report\" export. */\n reportHeader?: string;\n}\n\nexport function defineAdapterTesterConfig(\n config: AdapterTesterConfig,\n): AdapterTesterConfig {\n const sourceOfTruthCount = config.targets.filter(\n (target) => target.sourceOfTruth,\n ).length;\n if (sourceOfTruthCount !== 1) {\n throw new Error(\n `adapter-tester config must mark exactly one target as sourceOfTruth (found ${sourceOfTruthCount})`,\n );\n }\n return config;\n}\n\nexport function getSourceOfTruth(config: AdapterTesterConfig): AdapterTarget {\n const sourceOfTruth = config.targets.find((target) => target.sourceOfTruth);\n if (!sourceOfTruth) {\n throw new Error(\"adapter-tester config has no target marked sourceOfTruth\");\n }\n return sourceOfTruth;\n}\n"],"names":["defineAdapterTesterConfig","config","sourceOfTruthCount","target","getSourceOfTruth","sourceOfTruth"],"mappings":";AA6GO,SAASA,EACdC,GACqB;AACrB,QAAMC,IAAqBD,EAAO,QAAQ;AAAA,IACxC,CAACE,MAAWA,EAAO;AAAA,EAAA,EACnB;AACF,MAAID,MAAuB;AACzB,UAAM,IAAI;AAAA,MACR,8EAA8EA,CAAkB;AAAA,IAAA;AAGpG,SAAOD;AACT;AAEO,SAASG,EAAiBH,GAA4C;AAC3E,QAAMI,IAAgBJ,EAAO,QAAQ,KAAK,CAACE,MAAWA,EAAO,aAAa;AAC1E,MAAI,CAACE;AACH,UAAM,IAAI,MAAM,0DAA0D;AAE5E,SAAOA;AACT;"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runVisualRegression.d.ts","sourceRoot":"","sources":["../../src/testing/runVisualRegression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAcxD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAmED;;;;wEAIwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;+EAG2E;IAC3E,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC;;;;uDAImD;IACnD,UAAU,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;wEAIwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;;uDAImD;IACnD,UAAU,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,
|
|
1
|
+
{"version":3,"file":"runVisualRegression.d.ts","sourceRoot":"","sources":["../../src/testing/runVisualRegression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAcxD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAmED;;;;wEAIwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;+EAG2E;IAC3E,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC;;;;uDAImD;IACnD,UAAU,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;wEAIwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;;uDAImD;IACnD,UAAU,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CA8P/B"}
|
package/dist/testing.cjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const L=require("@playwright/test"),i=require("node:fs"),
|
|
1
|
+
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const L=require("@playwright/test"),i=require("node:fs"),z=require("pixelmatch"),b=require("pngjs"),P=require("node:path"),R=require("./index-C6uYPRmx.cjs");function _(e,t){const n=b.PNG.sync.read(e),r=b.PNG.sync.read(t);if(n.width!==r.width||n.height!==r.height)return{diffPixels:1/0,diffImage:null};const s=new b.PNG({width:n.width,height:n.height});return{diffPixels:z(n.data,r.data,s.data,n.width,n.height,{threshold:.1}),diffImage:b.PNG.sync.write(s)}}const H="http://json-schema.org/draft-07/schema#",Y="https://github.com/borderux/recursica/tree/main/packages/adapter-tester/src/golden/manifest.schema.json",Q="test/golden/manifest.json",Z="Tracks golden (baseline) image metadata for @recursica/adapter-tester's golden-image visual regression checks. One manifest lives alongside its adapter's test/golden/<story-id>.png files, keyed by story id.",ee="object",te={type:"object",additionalProperties:!1,required:["createdAt"],properties:{createdAt:{type:"string",format:"date-time",description:"When this story's own golden PNG was last captured, via --update-golden, --approve-divergence, or first-run auto-create."},sourceOfTruthCreatedAt:{type:"string",format:"date-time",description:"The source-of-truth adapter's (mantine) manifest `createdAt` for this story at the time this adapter's divergence from it was last reviewed via --approve-divergence. Omitted on the source-of-truth adapter's own manifest, and omitted here until the first approval. If mantine's current `createdAt` for this story is newer than this value, the divergence is flagged again for re-review."}}},re={$schema:H,$id:Y,title:Q,description:Z,type:ee,additionalProperties:te},ne=R.index,J=new R.ajvExports.Ajv({allErrors:!0,strict:!0});ne(J);const q=J.compile(re);function N(e,t){if(q(e))return;const n=(q.errors??[]).map(r=>{var a;const s=(a=r.params)!=null&&a.additionalProperty?` '${r.params.additionalProperty}'`:"";return` - ${r.instancePath||"root"} ${r.message}${s}`}).join(`
|
|
2
2
|
`);throw new Error(`Invalid ${t}:
|
|
3
|
-
${n}`)}function j(e){return P.join(e,"manifest.json")}function U(e){return P.join(e,"manifest.json.lock")}function
|
|
4
|
-
`),i.renameSync(
|
|
5
|
-
`));const W=d==="divergence"?"Source-of-Truth Divergence Check":"Own-Drift Golden Image Check";return{ownTargetName:t.name,suiteLabel:W,stories:E,missingFromSourceOfTruth:T,checkStory:async(
|
|
3
|
+
${n}`)}function j(e){return P.join(e,"manifest.json")}function U(e){return P.join(e,"manifest.json.lock")}function O(e,t){return P.join(e,`${t}.png`)}function x(e){const t=j(e);if(!i.existsSync(t))return{};const n=JSON.parse(i.readFileSync(t,"utf8"));return N(n,t),n}function oe(e,t){const n=j(e);N(t,n);const r={};for(const a of Object.keys(t).sort())r[a]=t[a];i.mkdirSync(e,{recursive:!0});const s=`${n}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;i.writeFileSync(s,JSON.stringify(r,null,2)+`
|
|
4
|
+
`),i.renameSync(s,n)}const se=25,ie=15e3;function ae(e){return new Promise(t=>setTimeout(t,e))}async function ce(e){i.mkdirSync(e,{recursive:!0});const t=U(e),n=Date.now()+ie;for(;;)try{i.closeSync(i.openSync(t,"wx"));return}catch(r){if(r.code!=="EEXIST")throw r;if(Date.now()>=n)throw new Error(`Timed out waiting for the manifest lock at "${t}" — delete it if a previous run crashed while holding it.`);await ae(se)}}function de(e){i.rmSync(U(e),{force:!0})}async function K(e,t,n){await ce(e);try{const r=x(e),s=n(r[t]);return s===void 0?delete r[t]:r[t]=s,oe(e,r),s}finally{de(e)}}function ue(e,t,n){i.mkdirSync(e,{recursive:!0}),i.writeFileSync(O(e,t),n)}async function he(e,t){const n=x(e),r=Object.keys(n).filter(s=>!t.has(s));for(const s of r){const a=O(e,s);i.existsSync(a)&&i.unlinkSync(a),await K(e,s,()=>{})}return r}const le="borderux/recursica";async function fe(e,t){var a,u;const n=await fetch(`https://registry.npmjs.org/${e}`);if(!n.ok)throw new Error(`Could not reach npm registry for ${e}: ${n.statusText}`);const r=await n.json(),s=((a=r["dist-tags"])==null?void 0:a[t])??((u=r.versions)!=null&&u[t]?t:void 0);if(!s)throw new Error(`${e} has no version or dist-tag "${t}" on the npm registry.`);return s}function pe(e){return`packages/${e.split("/").pop()}`}async function ge(e){if(e.type==="local")return i.existsSync(j(e.dir))?{manifest:x(e.dir),async readImage(h){const d=O(e.dir,h);return i.existsSync(d)?i.readFileSync(d):null}}:(console.warn(`No golden baseline found yet at ${e.dir} — source-of-truth divergence check skipped for this run.`),null);let t;try{t=await fe(e.packageName,e.versionSpec)}catch(c){return console.warn(`Could not resolve ${e.packageName}@${e.versionSpec} — source-of-truth divergence check skipped for this run.`,c),null}const n=P.join(e.cacheDir,t),r=`${e.packageName}@${t}`,s=`https://raw.githubusercontent.com/${le}/${r}/${pe(e.packageName)}/test/golden`;let a;const u=j(n);if(i.existsSync(u))a=x(n);else{let c;try{c=await fetch(`${s}/manifest.json`)}catch(p){return console.warn(`Could not reach GitHub to fetch ${r}'s golden baseline — source-of-truth divergence check skipped for this run.`,p),null}if(!c.ok)return console.warn(`No golden baseline published for ${r} — source-of-truth divergence check skipped for this run.`),null;const h=await c.text(),d=JSON.parse(h);N(d,`${s}/manifest.json`),i.mkdirSync(n,{recursive:!0}),i.writeFileSync(u,h),a=d}return{manifest:a,async readImage(c){const h=O(n,c);if(i.existsSync(h))return i.readFileSync(h);const d=await fetch(`${s}/${c}.png`);if(!d.ok)return null;const p=Buffer.from(await d.arrayBuffer());return i.mkdirSync(n,{recursive:!0}),i.writeFileSync(h,p),p}}}const me=["Theme","Tokens","Introduction"];function I(e,t){return e===t||e.startsWith(t)}async function we(e,t){let n;try{const r=await fetch(`${e.url}/index.json`);if(!r.ok)throw new Error(`Failed to fetch Storybook index: ${r.statusText}`);const a=(await r.json()).entries||{};n=Object.values(a).filter(u=>u.type==="story"&&!t.some(c=>u.title===c||u.title.startsWith(`${c}/`))),n.sort((u,c)=>u.id.localeCompare(c.id))}catch(r){throw console.error("Failed to load Storybook index from",`${e.url}/index.json`,r),new Error(`Storybook target "${e.name}" is not responsive or index.json is missing. Please ensure its Storybook is running.`)}return n}function D(e,t,n){let r;for(const s of Object.keys(t))I(e,s)&&(!r||s.length>r.length)&&(r=s);return r!==void 0?t[r]:n}async function ye(e){const t=e.isSourceOfTruthAdapter?e.targets[0]:e.targets.find(o=>!o.sourceOfTruth);if(!t)throw new Error("adapter-tester config has no non-sourceOfTruth target to run the golden check against.");const n=e.excludeTitlePrefixes??me,r=e.stories??{},s=Object.keys(r).filter(o=>r[o].exclude),a=Object.fromEntries(Object.entries(r).filter(([,o])=>o.goldenThreshold!==void 0).map(([o,l])=>[o,l.goldenThreshold])),u=Object.fromEntries(Object.entries(r).filter(([,o])=>o.sourceOfTruthThreshold!==void 0).map(([o,l])=>[o,l.sourceOfTruthThreshold])),c=e.goldenDir,h=e.goldenMode,d=e.checkMode,p=await we(t,n),E=p.filter(o=>!s.some(l=>I(o.id,l)));if(h==="update-golden"){const o=await he(c,new Set(E.map(l=>l.id)));o.length>0&&console.warn(`Pruned ${o.length} orphaned golden(s) no longer in Storybook: ${o.join(", ")}`)}const g=d!=="divergence"||e.isSourceOfTruthAdapter||!e.sourceOfTruthGolden?null:await ge(e.sourceOfTruthGolden),V=new Set(p.map(o=>o.id)),T=g?Object.keys(g.manifest).filter(o=>!V.has(o)&&!s.some(l=>I(o,l))).sort():[];T.length>0&&console.error(`[adapter-tester] ${T.length} stor(y/ies) exist in the source of truth but are missing here: ${T.join(", ")}. Add the missing story, or mark it \`exclude: true\` under \`stories\` in adapter-tester.config.json if intentional.`),console.log([`[adapter-tester] target: "${t.name}" (${t.url})`,`[adapter-tester] checkMode: "${d}" (${d==="divergence"?"this project's golden vs source-of-truth's golden":"live render vs this project's own golden"})`,`[adapter-tester] goldenMode: "${h}"`,`[adapter-tester] goldenThresholdPixels: ${e.goldenThresholdPixels}`,`[adapter-tester] sourceOfTruthThresholdPixels: ${e.sourceOfTruthThresholdPixels}`,d==="divergence"?e.isSourceOfTruthAdapter?"[adapter-tester] sourceOfTruthGolden: skipped — this is the source-of-truth adapter, nothing to diverge from":e.sourceOfTruthGolden?g?`[adapter-tester] sourceOfTruthGolden: resolved, ${Object.keys(g.manifest).length} golden(s) available (config: ${JSON.stringify(e.sourceOfTruthGolden)})`:`[adapter-tester] sourceOfTruthGolden: unavailable — no baseline found or unreachable (config: ${JSON.stringify(e.sourceOfTruthGolden)}); divergence check will skip every story`:"[adapter-tester] sourceOfTruthGolden: skipped — no sourceOfTruthGolden configured":'[adapter-tester] sourceOfTruthGolden: not used in "own" checkMode',`[adapter-tester] stories: ${E.length} to check (excluded: ${s.length}, title prefixes excluded: ${n.join(", ")||"none"})`,`[adapter-tester] story parity with source of truth: ${T.length===0?"OK":`${T.length} missing (see error above)`}`].join(`
|
|
5
|
+
`));const W=d==="divergence"?"Source-of-Truth Divergence Check":"Own-Drift Golden Image Check";return{ownTargetName:t.name,suiteLabel:W,stories:E,missingFromSourceOfTruth:T,checkStory:async(o,l,f)=>{const $=await l.newPage();await $.setViewportSize({width:800,height:600}),await $.goto(`${t.url}/iframe.html?id=${o.id}&viewMode=story`,{waitUntil:"networkidle"}),await $.waitForSelector("#storybook-root"),await $.addStyleTag({content:"* { -webkit-font-smoothing: antialiased !important; -moz-osx-font-smoothing: grayscale !important; }"}),await $.waitForTimeout(300);const G=await $.screenshot(),A=O(c,o.id),m=x(c)[o.id],X=h!=="check"||!m||!i.existsSync(A);let S;if(X)ue(c,o.id,G),S=m!=null&&m.sourceOfTruthCreatedAt?{createdAt:new Date().toISOString(),sourceOfTruthCreatedAt:m.sourceOfTruthCreatedAt}:{createdAt:new Date().toISOString()},m||f.annotations.push({type:"golden-created",description:`No golden existed yet for "${o.id}" — captured one from this run.`});else if(S=m,d==="own"){const w=i.readFileSync(A),{diffPixels:y,diffImage:k}=_(G,w),v=D(o.id,a,e.goldenThresholdPixels);y>=v&&(await f.attach("expected",{body:w,contentType:"image/png"}),await f.attach("actual",{body:G,contentType:"image/png"}),k&&await f.attach("diff",{body:k,contentType:"image/png"})),L.expect.soft(y,`"${o.id}" has drifted from its own golden image (${y} mismatched pixels, threshold ${v})`).toBeLessThan(v)}if(g){const w=g.manifest[o.id],y=w?await g.readImage(o.id):null;if(w&&y)if(h==="approve-divergence")S={...S,sourceOfTruthCreatedAt:w.createdAt};else{const k=i.readFileSync(A),{diffPixels:v,diffImage:F}=_(k,y),M=D(o.id,u,e.sourceOfTruthThresholdPixels),C=S.sourceOfTruthCreatedAt,B=v<M||C!==void 0&&C>=w.createdAt;B||(await f.attach("expected",{body:y,contentType:"image/png"}),await f.attach("actual",{body:k,contentType:"image/png"}),F&&await f.attach("diff",{body:F,contentType:"image/png"}),f.annotations.push({type:"source-of-truth-divergence",description:`"${o.id}" differs from the source of truth's golden by ${v} mismatched pixels (threshold ${M}) and hasn't been reviewed — run with --approve-divergence if this is intentional, or fix the adapter styling.`})),L.expect.soft(B,`"${o.id}" differs from the source of truth's golden by ${v} mismatched pixels (threshold ${M}) and hasn't been reviewed — run with --approve-divergence if this is intentional, or fix the adapter styling.`).toBe(!0)}}await K(c,o.id,()=>S)}}}exports.resolveVisualRegressionPlan=ye;
|
|
6
6
|
//# sourceMappingURL=testing.cjs.map
|