@cappa/core 0.11.0 → 0.12.1

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.
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["annotateDiffImage","fsp","path","os","fs","path","fsp","fs","path"],"sources":["../src/features/png/util.ts","../src/features/png/png.ts","../src/compare/gmsd.ts","../src/compare/pixel.ts","../src/config.ts","../src/mapWithConcurrency.ts","../src/filesystem.ts","../src/screenshot.ts"],"sourcesContent":["import type { MetadataEntries } from \"./types\";\n\ntype ParsedChunk = {\n type: string;\n data: Buffer;\n length: number;\n offset: number;\n};\n\n// Magic Bytes:\n// The first 8 bytes of every valid PNG file.\n// Used to verify that the file is actually a PNG before processing.\nconst pngSignature = Buffer.from([\n 0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,\n]);\n\n// A pre-calculated lookup table for the CRC32 algorithm.\n// We use this to quickly calculate the checksum for each chunk we write.\n// Without this table, calculating CRC bit-by-bit would be significantly slower.\nconst crcTable = new Uint32Array(256).map((_, index) => {\n let c = index;\n for (let k = 0; k < 8; k++) {\n c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;\n }\n\n return c >>> 0;\n});\n\n/**\n * Chunk Parser Generator\n *\n * A PNG file is essentially a list of chunks.\n * Structure of a chunk:\n * 1. Length (4 bytes): The size of the data field.\n * 2. Type (4 bytes): ASCII name (e.g., 'IHDR', 'tEXt', 'IEND').\n * 3. Data (Length bytes): The actual payload.\n * 4. CRC (4 bytes): Checksum.\n */\nfunction* readChunks(buffer: Buffer): Generator<ParsedChunk> {\n let offset = pngSignature.length;\n\n while (offset + 8 <= buffer.length) {\n const length = buffer.readUInt32BE(offset);\n const type = buffer.toString(\"ascii\", offset + 4, offset + 8);\n const dataStart = offset + 8;\n const dataEnd = dataStart + length;\n\n if (dataEnd > buffer.length) {\n return;\n }\n\n const data = buffer.subarray(dataStart, dataEnd);\n\n yield { type, data, length, offset };\n\n offset = dataEnd + 4; // Skip CRC\n\n if (type === \"IEND\") {\n return;\n }\n }\n}\n\n/**\n * Constructs a raw binary `tEXt` chunk.\n */\nexport function createTextChunk(key: string, value: string) {\n const keyBuffer = Buffer.from(key, \"latin1\");\n const valueBuffer = Buffer.from(value, \"latin1\");\n const data = Buffer.concat([keyBuffer, Buffer.from([0]), valueBuffer]);\n const lengthBuffer = Buffer.alloc(4);\n const typeBuffer = Buffer.from(\"tEXt\");\n\n lengthBuffer.writeUInt32BE(data.length, 0);\n\n const crcBuffer = Buffer.alloc(4);\n crcBuffer.writeUInt32BE(crc32(Buffer.concat([typeBuffer, data])), 0);\n\n return Buffer.concat([lengthBuffer, typeBuffer, data, crcBuffer]);\n}\n\n/**\n * Calculates the CRC32 checksum for a buffer.\n * Used to ensure data integrity.\n */\nexport function crc32(buffer: Buffer) {\n let crc = 0 ^ -1;\n\n for (let i = 0; i < buffer.length; i++) {\n // biome-ignore lint/style/noNonNullAssertion: we know the index is valid\n crc = (crc >>> 8) ^ crcTable[(crc ^ buffer[i]!) & 0xff]!;\n }\n\n return (crc ^ -1) >>> 0;\n}\n\n/**\n * Helper to locate the IEND chunk, which marks the end of a PNG stream.\n */\nfunction findIendChunk(buffer: Buffer): ParsedChunk | undefined {\n for (const chunk of readChunks(buffer)) {\n if (chunk.type === \"IEND\") {\n return chunk;\n }\n }\n\n return undefined;\n}\n\n/**\n * Inserts metadata chunks into a PNG buffer.\n * It places them right before the final `IEND` chunk.\n */\nexport function injectTextMetadata(buffer: Buffer, metadata: MetadataEntries) {\n if (!buffer.subarray(0, pngSignature.length).equals(pngSignature)) {\n return buffer;\n }\n\n const iendChunk = findIendChunk(buffer);\n if (!iendChunk) {\n return buffer;\n }\n\n const textChunks = Object.entries(metadata).map(([key, value]) =>\n createTextChunk(key, value),\n );\n\n return Buffer.concat([\n buffer.subarray(0, iendChunk.offset),\n ...textChunks,\n buffer.subarray(iendChunk.offset),\n ]);\n}\n\n/**\n * Scans a raw PNG buffer and extracts key-value pairs from `tEXt` chunks.\n */\nexport function extractTextMetadata(buffer: Buffer): MetadataEntries {\n if (!buffer.subarray(0, pngSignature.length).equals(pngSignature)) {\n return {};\n }\n\n const metadata: MetadataEntries = {};\n\n for (const chunk of readChunks(buffer)) {\n if (chunk.type !== \"tEXt\") {\n continue;\n }\n\n const separatorIndex = chunk.data.indexOf(0);\n if (separatorIndex < 0) {\n continue;\n }\n\n const key = chunk.data.toString(\"latin1\", 0, separatorIndex);\n const value = chunk.data.toString(\"latin1\", separatorIndex + 1);\n\n metadata[key] = value;\n }\n\n return metadata;\n}\n","import { readFile, writeFile } from \"node:fs/promises\";\nimport sharp from \"sharp\";\nimport type { MetadataEntries } from \"./types\";\nimport { extractTextMetadata, injectTextMetadata } from \"./util\";\n\n/**\n * A wrapper around `sharp` that adds support for reading and writing\n * textual metadata (tEXt chunks). Used for fast PNG decode/encode.\n */\nexport class PNG {\n private width_: number;\n private height_: number;\n private data_: Buffer;\n private sourcePath?: string;\n private metadataEntries: MetadataEntries;\n\n private constructor(\n width: number,\n height: number,\n data: Buffer,\n sourcePath?: string,\n metadata?: MetadataEntries,\n ) {\n this.width_ = width;\n this.height_ = height;\n this.data_ = data;\n this.sourcePath = sourcePath;\n this.metadataEntries = { ...(metadata ?? {}) };\n }\n\n static create(width: number, height: number): PNG {\n const data = Buffer.alloc(width * height * 4, 0);\n return new PNG(width, height, data);\n }\n\n static async load(source: string | Buffer): Promise<PNG> {\n const buffer = typeof source === \"string\" ? await readFile(source) : source;\n const metadata = extractTextMetadata(buffer);\n\n const pipeline = sharp(buffer).ensureAlpha();\n const { data: raw, info } = await pipeline\n .raw()\n .toBuffer({ resolveWithObject: true });\n\n const data = Buffer.from(raw);\n const sourcePath = typeof source === \"string\" ? source : undefined;\n\n return new PNG(info.width, info.height, data, sourcePath, metadata);\n }\n\n get width(): number {\n return this.width_;\n }\n\n get height(): number {\n return this.height_;\n }\n\n get data(): Buffer {\n return this.data_;\n }\n\n get metadata(): MetadataEntries {\n return { ...this.metadataEntries };\n }\n\n setMetadata(key: string, value: string): void {\n this.metadataEntries = { ...this.metadataEntries, [key]: value };\n }\n\n replaceMetadata(metadata: MetadataEntries): void {\n this.metadataEntries = { ...metadata };\n }\n\n removeMetadata(key: string): void {\n const { [key]: _, ...remaining } = this.metadataEntries;\n this.metadataEntries = remaining;\n }\n\n clearMetadata(): void {\n this.metadataEntries = {};\n }\n\n async toBuffer(): Promise<Buffer> {\n const baseBuffer = await sharp(this.data_, {\n raw: { width: this.width_, height: this.height_, channels: 4 },\n })\n .png()\n .toBuffer();\n\n if (Object.keys(this.metadataEntries).length === 0) {\n return baseBuffer;\n }\n\n return injectTextMetadata(baseBuffer, this.metadataEntries);\n }\n\n async save(filepath?: string): Promise<void> {\n const targetPath = filepath ?? this.sourcePath;\n\n if (!targetPath) {\n throw new Error(\"No filepath provided for saving PNG\");\n }\n\n await writeFile(targetPath, await this.toBuffer());\n }\n}\n","import fs from \"node:fs\";\nimport gmsd, { type GmsdOptions } from \"@blazediff/gmsd\";\nimport { getLogger } from \"@cappa/logger\";\nimport { PNG } from \"../features/png/png\";\nimport type { DiffConfigGMSD } from \"../types\";\n\nexport type CompareOptions = GmsdOptions;\n\nexport interface CompareResult {\n gmsd: number;\n diffBuffer?: Buffer; // PNG buffer of the diff image\n passed: boolean; // Whether the comparison passed based on threshold\n error?: string; // Error message if the comparison failed\n}\n\nconst compare = (\n image1: Uint8Array | Uint8ClampedArray,\n image2: Uint8Array | Uint8ClampedArray,\n diff: Uint8Array | Uint8ClampedArray | undefined,\n width: number,\n height: number,\n options?: GmsdOptions,\n) => {\n return gmsd(image1, image2, diff, width, height, options);\n};\n\n/**\n * Compare two PNG images and return the difference\n * @param image1 - First image (file path or Buffer)\n * @param image2 - Second image (file path or Buffer)\n * @param withDiff - Whether to create a diff image\n * @param options - Comparison options\n * @returns Comparison result\n */\nexport async function compareImagesGMSD(\n image1: string | Buffer,\n image2: string | Buffer,\n withDiff: boolean = false,\n options: DiffConfigGMSD = {},\n): Promise<CompareResult> {\n // Load both PNGs in parallel with sharp for better performance\n const [png1, png2] = await Promise.all([loadPNG(image1), loadPNG(image2)]);\n\n const { width, height } = png1;\n\n if (width !== png2.width || height !== png2.height) {\n return { gmsd: Infinity, passed: false };\n }\n\n const diff = withDiff ? PNG.create(width, height) : undefined;\n\n try {\n const gmsd = compare(png1.data, png2.data, diff?.data, width, height, {\n downsample: options.downsample ?? 0,\n c: options.c ?? 170,\n });\n\n // Convert diff image to buffer\n const diffBuffer = diff\n ? await annotateDiffImage(diff, options).toBuffer()\n : undefined;\n\n return {\n gmsd,\n diffBuffer,\n passed: gmsd <= (options.threshold ?? 0.1),\n };\n } catch (error) {\n getLogger().error((error as Error).message || \"Unknown error\");\n\n return {\n gmsd: Infinity,\n passed: false,\n error: (error as Error).message || \"Unknown error\",\n };\n }\n}\n\n/**\n * Load a PNG image from file path or Buffer\n */\nasync function loadPNG(source: string | Buffer): Promise<PNG> {\n return PNG.load(source);\n}\n\nfunction annotateDiffImage(image: PNG, options: DiffConfigGMSD) {\n image.setMetadata(\"cappa.diff.algorithm\", \"gmsd\");\n\n for (const [key, value] of Object.entries(options)) {\n if (value === undefined) {\n continue;\n }\n\n image.setMetadata(`cappa.diff.${key}`, String(value));\n }\n\n return image;\n}\n\n/**\n * Save a comparison result diff image to file\n * @param result - Comparison result containing diffBuffer\n * @param outputPath - Path to save the diff image\n */\nexport function saveDiffImage(result: CompareResult, outputPath: string): void {\n if (!result.diffBuffer) {\n throw new Error(\"No diff buffer available in comparison result\");\n }\n\n fs.writeFileSync(outputPath, result.diffBuffer);\n}\n\n/**\n * Quick comparison function that returns only pass/fail\n * @param image1 - First image (file path or Buffer)\n * @param image2 - Second image (file path or Buffer)\n * @param options - Comparison options\n * @returns Whether the images match\n */\nexport async function imagesMatchGMSD(\n image1: string | Buffer,\n image2: string | Buffer,\n options: DiffConfigGMSD = {},\n): Promise<boolean> {\n const result = await compareImagesGMSD(image1, image2, false, options);\n\n return result.passed;\n}\n","import fs from \"node:fs\";\nimport fsp from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport {\n type BlazeDiffOptions,\n type BlazeDiffResult,\n compare as blazediffCompare,\n} from \"@blazediff/core-native\";\nimport { getLogger } from \"@cappa/logger\";\nimport { PNG } from \"../features/png/png\";\nimport type { DiffConfig } from \"../types\";\n\n/** Pixel diff options: Cappa `DiffConfig` plus optional native-only output tuning. */\nexport type CompareOptions = DiffConfig &\n Partial<Pick<BlazeDiffOptions, \"diffMask\" | \"compression\" | \"quality\">>;\n\nexport interface CompareResult {\n numDiffPixels: number;\n totalPixels: number;\n percentDifference: number;\n diffBuffer?: Buffer; // PNG buffer of the diff image\n passed: boolean; // Whether the comparison passed based on threshold\n error?: string; // Error message if the comparison failed\n differentSizes: boolean; // Whether the images have different sizes\n}\n\ntype TempState = { tempRoot?: string };\n\nasync function ensureTempRoot(state: TempState): Promise<string> {\n if (!state.tempRoot) {\n state.tempRoot = await fsp.mkdtemp(path.join(os.tmpdir(), \"cappa-pxl-\"));\n }\n return state.tempRoot;\n}\n\nasync function resolveInputPath(\n source: string | Buffer,\n fileName: string,\n state: TempState,\n): Promise<string> {\n if (typeof source === \"string\") {\n await fsp.access(source, fs.constants.R_OK);\n return path.resolve(source);\n }\n\n await PNG.load(source);\n const root = await ensureTempRoot(state);\n const dest = path.join(root, fileName);\n await fsp.writeFile(dest, source);\n return dest;\n}\n\nfunction toNativeOptions(config: DiffConfig): BlazeDiffOptions {\n const extra = config as CompareOptions;\n const out: BlazeDiffOptions = {\n threshold: extra.threshold,\n antialiasing: extra.includeAA ?? false,\n };\n\n if (extra.diffMask !== undefined) {\n out.diffMask = extra.diffMask;\n }\n if (extra.compression !== undefined) {\n out.compression = extra.compression;\n }\n if (extra.quality !== undefined) {\n out.quality = extra.quality;\n }\n\n return out;\n}\n\n/**\n * Compare two PNG images and return the difference\n * @param image1 - First image (file path or Buffer)\n * @param image2 - Second image (file path or Buffer)\n * @param withDiff - Whether to create a diff image\n * @param options - Comparison options\n * @returns Comparison result\n */\nexport async function compareImages(\n image1: string | Buffer,\n image2: string | Buffer,\n withDiff: boolean = false,\n options: DiffConfig = {},\n): Promise<CompareResult> {\n const state: TempState = {};\n let diffPath: string | undefined;\n\n try {\n const p1 = await resolveInputPath(image1, \"expected.png\", state);\n const p2 = await resolveInputPath(image2, \"actual.png\", state);\n\n if (withDiff) {\n const root = await ensureTempRoot(state);\n diffPath = path.join(root, \"diff.png\");\n }\n\n let nativeResult: BlazeDiffResult;\n\n try {\n nativeResult = await blazediffCompare(\n p1,\n p2,\n withDiff ? diffPath : undefined,\n toNativeOptions(options),\n );\n } catch (error) {\n getLogger().error((error as Error).message || \"Unknown error\");\n\n return {\n numDiffPixels: 0,\n totalPixels: 0,\n percentDifference: 0,\n passed: false,\n differentSizes: false,\n error: (error as Error).message || \"Unknown error\",\n };\n }\n\n if (nativeResult.match === false) {\n if (nativeResult.reason === \"file-not-exists\") {\n throw new Error(`File not found: ${nativeResult.file}`);\n }\n\n if (nativeResult.reason === \"layout-diff\") {\n return {\n numDiffPixels: 0,\n totalPixels: 0,\n percentDifference: 0,\n passed: false,\n differentSizes: true,\n };\n }\n }\n\n const { width, height } = await PNG.load(p1);\n const totalPixels = width * height;\n\n if (nativeResult.match) {\n return {\n numDiffPixels: 0,\n totalPixels,\n percentDifference: 0,\n diffBuffer: undefined,\n passed: isPassed(0, 0, options),\n differentSizes: false,\n };\n }\n\n let diffBuffer: Buffer | undefined;\n if (withDiff && diffPath) {\n const raw = await fsp.readFile(diffPath);\n const diffPng = await PNG.load(raw);\n diffBuffer = await annotateDiffImage(diffPng, options).toBuffer();\n }\n\n const numDiffPixels = nativeResult.diffCount;\n const percentDifference = nativeResult.diffPercentage;\n\n return {\n numDiffPixels,\n totalPixels,\n percentDifference,\n diffBuffer,\n passed: isPassed(percentDifference, numDiffPixels, options),\n differentSizes: false,\n };\n } finally {\n if (state.tempRoot) {\n await fsp\n .rm(state.tempRoot, { recursive: true, force: true })\n .catch(() => {\n // ignore cleanup errors\n });\n }\n }\n}\n\nfunction annotateDiffImage(image: PNG, options: DiffConfig) {\n image.setMetadata(\"cappa.diff.algorithm\", \"pixel\");\n\n for (const [key, value] of Object.entries(options)) {\n if (value === undefined) {\n continue;\n }\n\n image.setMetadata(`cappa.diff.${key}`, String(value));\n }\n\n return image;\n}\n\n/**\n * Save a comparison result diff image to file\n * @param result - Comparison result containing diffBuffer\n * @param outputPath - Path to save the diff image\n */\nexport function saveDiffImage(result: CompareResult, outputPath: string): void {\n if (!result.diffBuffer) {\n throw new Error(\"No diff buffer available in comparison result\");\n }\n\n fs.writeFileSync(outputPath, result.diffBuffer);\n}\n\n/**\n * Quick comparison function that returns only pass/fail\n * @param image1 - First image (file path or Buffer)\n * @param image2 - Second image (file path or Buffer)\n * @param options - Comparison options\n * @returns Whether the images match\n */\nexport async function imagesMatch(\n image1: string | Buffer,\n image2: string | Buffer,\n options: DiffConfig = {},\n): Promise<boolean> {\n const result = await compareImages(image1, image2, false, options);\n\n return result.passed;\n}\n\n/**\n * Check if the comparison passed based on the options\n * @param percentDifference - Percentage difference between the images\n * @param numDiffPixels - Number of different pixels\n * @param options - Comparison options\n * @returns Whether the comparison passed\n */\nconst isPassed = (\n percentDifference: number,\n numDiffPixels: number,\n options: DiffConfig,\n) => {\n if (options.maxDiffPercentage && options.maxDiffPixels) {\n return (\n percentDifference <= options.maxDiffPercentage &&\n numDiffPixels <= options.maxDiffPixels\n );\n }\n\n if (options.maxDiffPercentage) {\n return percentDifference <= options.maxDiffPercentage;\n }\n\n if (options.maxDiffPixels) {\n return numDiffPixels <= options.maxDiffPixels;\n }\n\n // fallback to 0 pixels\n return numDiffPixels === 0;\n};\n\n/**\n * Create different size png image with all pixels red\n * @returns\n */\nexport async function createDiffSizePngImage(\n width: number,\n height: number,\n): Promise<Buffer> {\n const png = PNG.create(width, height);\n\n for (let y = 0; y < height; y++) {\n for (let x = 0; x < width; x++) {\n const idx = (width * y + x) << 2;\n png.data[idx] = 255; // red\n png.data[idx + 1] = 0; // green\n png.data[idx + 2] = 0; // blue\n png.data[idx + 3] = 255; // alpha\n }\n }\n\n return png.toBuffer();\n}\n","import type { ConfigEnv, PossiblePromise, UserConfig } from \"./types\";\n\n/**\n * Type helper to make it easier to use cappa.config.ts, or a function that returns it. The function receives a ConfigEnv object.\n */\nexport function defineConfig(\n options:\n | PossiblePromise<UserConfig>\n | ((env: ConfigEnv) => PossiblePromise<UserConfig>),\n): typeof options {\n return options;\n}\n","/**\n * Run async work over `items` with at most `concurrency` tasks in flight.\n * Preserves failure behavior: the first rejection rejects the returned promise.\n */\nexport async function mapWithConcurrency<T>(\n concurrency: number,\n items: readonly T[],\n fn: (item: T) => Promise<void>,\n): Promise<void> {\n if (items.length === 0) {\n return;\n }\n\n const limit = Math.max(1, concurrency);\n const workerCount = Math.min(limit, items.length);\n let next = 0;\n\n const worker = async (): Promise<void> => {\n while (true) {\n const i = next++;\n if (i >= items.length) {\n return;\n }\n const item = items[i];\n if (item === undefined) {\n return;\n }\n await fn(item);\n }\n };\n\n await Promise.all(Array.from({ length: workerCount }, () => worker()));\n}\n","import fs from \"node:fs\";\nimport fsp, { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { imagesMatch } from \"./compare/pixel\";\nimport { extractTextMetadata, injectTextMetadata } from \"./features/png/util\";\nimport { mapWithConcurrency } from \"./mapWithConcurrency\";\nimport type { DiffConfig, DiffOptions, Screenshot } from \"./types\";\n\nconst APPROVE_SCREENSHOTS_CONCURRENCY = 8;\n\n/**\n * Class for interacting with the local file system to store the screenshots.\n */\nexport class ScreenshotFileSystem {\n private readonly actual: string;\n private readonly expected: string;\n private readonly diff: string;\n\n constructor(outputDir: string) {\n this.actual = path.resolve(outputDir, \"actual\");\n this.expected = path.resolve(outputDir, \"expected\");\n this.diff = path.resolve(outputDir, \"diff\");\n\n this.ensureParentDirSync(this.actual);\n this.ensureParentDirSync(this.expected);\n this.ensureParentDirSync(this.diff);\n }\n\n clearActual() {\n this.removeDir(this.actual);\n }\n\n clearDiff() {\n this.removeDir(this.diff);\n }\n\n getActualScreenshots(): Promise<string[]> {\n return Array.fromAsync(glob(path.resolve(this.actual, \"**/*.png\")));\n }\n\n getExpectedScreenshots(): Promise<string[]> {\n return Array.fromAsync(glob(path.resolve(this.expected, \"**/*.png\")));\n }\n\n getDiffScreenshots(): Promise<string[]> {\n return Array.fromAsync(glob(path.resolve(this.diff, \"**/*.png\")));\n }\n\n clearActualAndDiff() {\n this.clearActual();\n this.clearDiff();\n }\n\n /**\n * Approve a screenshot based on its actual file path.\n * @param actualFilePath - The path to the actual screenshot file.\n * @returns The paths to the actual, expected, and diff screenshot files.\n */\n async approveFromActualPath(actualFilePath: string) {\n const actualAbsolute = this.resolveActualPath(actualFilePath);\n const relativePath = path.relative(this.actual, actualAbsolute);\n\n if (relativePath.startsWith(\"..\")) {\n throw new Error(\n `Cannot approve screenshot outside of actual directory: ${actualFilePath}`,\n );\n }\n\n return this.approveRelative(relativePath);\n }\n\n /**\n * Apply baseline updates for grouped screenshots (same rules as `cappa approve`).\n */\n async approveScreenshots(\n screenshots: Screenshot[],\n diff: DiffOptions,\n ): Promise<void> {\n const outputDir = path.dirname(this.actual);\n\n await mapWithConcurrency(\n APPROVE_SCREENSHOTS_CONCURRENCY,\n screenshots,\n (screenshot) => this.approveOneScreenshot(screenshot, outputDir, diff),\n );\n }\n\n private async approveOneScreenshot(\n screenshot: Screenshot,\n outputDir: string,\n diff: DiffOptions,\n ): Promise<void> {\n const logger = getLogger();\n\n logger.debug(`Approving screenshot with category: ${screenshot.category}`);\n\n if (screenshot.category === \"new\") {\n logger.debug(`Approving new screenshot: ${screenshot.actualPath}`);\n await this.approveFromActualPath(\n path.resolve(outputDir, screenshot.actualPath),\n );\n return;\n }\n\n if (screenshot.category === \"deleted\") {\n logger.debug(`Deleting expected screenshot: ${screenshot.expectedPath}`);\n await fsp.unlink(path.resolve(outputDir, screenshot.expectedPath));\n return;\n }\n\n if (screenshot.category === \"changed\") {\n logger.debug(`Deleting diff screenshot: ${screenshot.diffPath}`);\n await fsp.unlink(path.resolve(outputDir, screenshot.diffPath));\n await this.approveFromActualPath(\n path.resolve(outputDir, screenshot.actualPath),\n );\n return;\n }\n\n if (screenshot.category === \"passed\") {\n if (!screenshot.expectedPath) {\n throw new Error(\"Expected path is required for passed screenshots\");\n }\n\n const matches = await imagesMatch(\n path.resolve(outputDir, screenshot.actualPath),\n path.resolve(outputDir, screenshot.expectedPath),\n diff.type === \"gmsd\"\n ? { threshold: diff.threshold }\n : (diff as DiffConfig),\n );\n\n if (!matches) {\n await this.approveFromActualPath(\n path.resolve(outputDir, screenshot.actualPath),\n );\n }\n }\n }\n\n /**\n * Approve a screenshot based on its name.\n * @param name - The name of the screenshot. Can include '.png' extension.\n * @returns The paths to the actual, expected, and diff screenshot files.\n */\n async approveByName(name: string) {\n const relativeWithExtension = name.endsWith(\".png\") ? name : `${name}.png`;\n\n return this.approveRelative(relativeWithExtension);\n }\n\n /**\n * Approve a screenshot based on a relative path.\n * @param relativePath - The relative path to the screenshot.\n * @returns The paths to the actual, expected, and diff screenshot files.\n */\n private async approveRelative(relativePath: string) {\n const actualPath = path.resolve(this.actual, relativePath);\n const expectedPath = path.resolve(this.expected, relativePath);\n const diffPath = path.resolve(this.diff, relativePath);\n\n await this.ensureParentDir(expectedPath);\n\n await fsp.copyFile(actualPath, expectedPath);\n\n try {\n await fsp.access(diffPath);\n } catch {\n return {\n actualPath,\n expectedPath,\n diffPath,\n };\n }\n\n await this.copyDiffMetadataToExpected(diffPath, expectedPath);\n await fsp.unlink(diffPath);\n\n return {\n actualPath,\n expectedPath,\n diffPath,\n };\n }\n\n private async copyDiffMetadataToExpected(\n diffPath: string,\n expectedPath: string,\n ): Promise<void> {\n const diffExtension = path.extname(diffPath).toLowerCase();\n const expectedExtension = path.extname(expectedPath).toLowerCase();\n\n if (diffExtension !== \".png\" || expectedExtension !== \".png\") {\n return;\n }\n\n try {\n const diffBuffer = await fsp.readFile(diffPath);\n const diffMetadata = extractTextMetadata(diffBuffer);\n\n if (Object.keys(diffMetadata).length === 0) {\n return;\n }\n\n const expectedBuffer = await fsp.readFile(expectedPath);\n const expectedMetadata = extractTextMetadata(expectedBuffer);\n\n const mergedMetadata = {\n ...expectedMetadata,\n ...diffMetadata,\n };\n\n const expectedWithMetadata = injectTextMetadata(\n expectedBuffer,\n mergedMetadata,\n );\n await fsp.writeFile(expectedPath, expectedWithMetadata);\n } catch {\n // Ignore metadata transfer errors to keep approval resilient.\n }\n }\n\n /**\n * Ensure the parent directory of a file exists. If not, it creates it.\n * @param filePath - The path to the file.\n */\n async ensureParentDir(filePath: string) {\n const dir = path.dirname(filePath);\n await fsp.mkdir(dir, { recursive: true });\n }\n\n /**\n * Synchronous version used only during constructor initialization.\n */\n private ensureParentDirSync(filePath: string) {\n const dir = path.dirname(filePath);\n\n if (!fs.existsSync(dir)) {\n fs.mkdirSync(dir, { recursive: true });\n }\n }\n\n /**\n * Remove a directory and all its contents.\n * @param dir - The path to the directory.\n */\n private removeDir(dir: string) {\n if (fs.existsSync(dir)) {\n fs.rmSync(dir, { recursive: true, force: true });\n }\n }\n\n /**\n * Get the actual directory path\n */\n getActualDir(): string {\n return this.actual;\n }\n\n /**\n * Get the expected directory path\n */\n getExpectedDir(): string {\n return this.expected;\n }\n\n /**\n * Get the diff directory path\n */\n getDiffDir(): string {\n return this.diff;\n }\n\n /**\n * Get the path to an actual screenshot file\n */\n getActualFilePath(filename: string): string {\n return path.resolve(this.actual, filename);\n }\n\n /**\n * Get the path to an expected screenshot file\n */\n getExpectedFilePath(filename: string): string {\n return path.resolve(this.expected, filename);\n }\n\n /**\n * Get the path to a diff screenshot file\n */\n getDiffFilePath(filename: string): string {\n return path.resolve(this.diff, filename);\n }\n\n /**\n * Write a file to the actual directory\n */\n async writeActualFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getActualFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Write a file to the diff directory\n */\n async writeDiffFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getDiffFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Check if an expected file exists\n */\n async hasExpectedFile(filename: string): Promise<boolean> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n await fsp.access(expectedPath);\n return true;\n } catch {\n return false;\n }\n }\n\n /**\n * Read an expected file\n */\n async readExpectedFile(filename: string): Promise<Buffer> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n return await fsp.readFile(expectedPath);\n } catch {\n throw new Error(`Expected image not found: ${expectedPath}`);\n }\n }\n\n /**\n * Resolve the actual path of a screenshot file.\n * @param filePath - The path to the screenshot file.\n * @returns The actual path of the screenshot file.\n */\n private resolveActualPath(filePath: string) {\n if (path.isAbsolute(filePath)) {\n return filePath;\n }\n\n return path.resolve(this.actual, filePath);\n }\n\n getRelativePath(directory: \"actual\" | \"expected\" | \"diff\", filePath: string) {\n const relativePath = path.relative(this[directory], filePath);\n\n if (relativePath.startsWith(\"..\")) {\n throw new Error(\n `Cannot resolve relative path outside of ${directory} directory: ${filePath}`,\n );\n }\n\n return relativePath;\n }\n}\n","import path from \"node:path\";\nimport { getLogger, type Logger } from \"@cappa/logger\";\nimport {\n type Browser,\n type BrowserContext,\n chromium,\n firefox,\n type Page,\n type PageScreenshotOptions,\n webkit,\n} from \"playwright-core\";\nimport {\n compareImagesGMSD,\n type CompareResult as GMSDCompareResult,\n} from \"./compare/gmsd\";\nimport {\n compareImages,\n createDiffSizePngImage,\n type CompareResult as PixelCompareResult,\n} from \"./compare/pixel\";\nimport { ScreenshotFileSystem } from \"./filesystem\";\nimport type {\n DiffConfig,\n DiffConfigGMSD,\n DiffOptions,\n DiffOptionsGMSD,\n DiffOptionsPixel,\n ScreenshotOptions,\n ScreenshotSettings,\n ScreenshotVariant,\n ScreenshotVariantWithUrl,\n} from \"./types\";\n\nconst defaultPixelDiffConfig: DiffOptionsPixel = {\n type: \"pixel\",\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n};\n\nconst defaultGMSDDiffConfig: DiffOptionsGMSD = {\n type: \"gmsd\",\n threshold: 0.1,\n downsample: 0,\n c: 170,\n};\n\nexport interface ScreenshotCaptureDetails {\n filename: string;\n filepath?: string;\n comparisonResult?: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n skipped?: boolean;\n}\n\nexport interface ScreenshotVariantCaptureDetails\n extends ScreenshotCaptureDetails {\n id: string;\n label?: string;\n}\n\nexport interface ScreenshotCaptureResult {\n base: ScreenshotCaptureDetails;\n variants: ScreenshotVariantCaptureDetails[];\n}\n\nexport interface ScreenshotCaptureExtras {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n variants?: Record<\n string,\n {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n }\n >;\n /**\n * Optional diff configuration override applied to this capture.\n * Merged on top of the global ScreenshotTool diff config.\n */\n diff?: DiffOptions;\n /**\n * Skip navigating to the base URL before capturing the base screenshot.\n * Use this when the page is already at the correct URL and in a stable state,\n * to avoid the redundant navigation.\n */\n skipBaseNavigation?: boolean;\n /**\n * Optional callback invoked after each navigation (variants only, or base when\n * skipBaseNavigation is false) to wait for visual stability before capturing.\n */\n waitForStability?: (page: Page) => Promise<void>;\n /**\n * Timestamp (from `performance.now()`) marking when the screenshot process\n * started — i.e. when the browser first navigated to the page. When provided,\n * the logged duration covers the full journey: navigation → stability waits →\n * capture. When omitted, timing begins at the capture step itself.\n */\n captureStart?: number;\n}\n\nclass ScreenshotTool {\n browserType: \"chromium\" | \"firefox\" | \"webkit\";\n headless: boolean;\n viewport: { width: number; height: number };\n fullPage: boolean;\n outputDir: string;\n browser: Browser | null = null;\n context: BrowserContext | null = null;\n page: Page | null = null;\n concurrency: number;\n contexts: BrowserContext[] = [];\n pages: Page[] = [];\n diff: DiffOptions;\n logger: Logger;\n retries: number;\n filesystem: ScreenshotFileSystem;\n logConsoleEvents: boolean;\n connectionTimeout: number;\n\n constructor(options: {\n browserType?: \"chromium\" | \"firefox\" | \"webkit\";\n headless?: boolean;\n viewport?: { width: number; height: number };\n fullPage?: boolean;\n outputDir?: string;\n diff?: DiffOptions;\n retries?: number;\n concurrency?: number;\n logConsoleEvents?: boolean;\n connectionTimeout?: number;\n }) {\n this.browserType = options.browserType || \"chromium\";\n this.headless = options.headless !== false; // Default to headless\n this.viewport = options.viewport || { width: 1920, height: 1080 };\n this.fullPage = options.fullPage ?? true;\n this.outputDir = options.outputDir || \"./screenshots\";\n this.diff = this.resolveDiffOptions(options.diff);\n this.concurrency = Math.max(1, options.concurrency || 1);\n this.logConsoleEvents = options.logConsoleEvents ?? true;\n this.connectionTimeout = options.connectionTimeout ?? 20000;\n\n this.logger = getLogger();\n this.retries = options.retries || 2;\n this.filesystem = new ScreenshotFileSystem(this.outputDir);\n }\n\n private resolveDiffOptions(diff?: DiffOptions): DiffOptions {\n if (diff?.type === \"gmsd\") {\n return { ...defaultGMSDDiffConfig, ...diff };\n }\n\n return { ...defaultPixelDiffConfig, ...diff, type: \"pixel\" };\n }\n\n private mergeDiffOptions(override?: DiffOptions): DiffOptions {\n const base = this.resolveDiffOptions(this.diff);\n\n if (!override) {\n return base;\n }\n\n if (override.type === \"gmsd\" || base.type === \"gmsd\") {\n const gmsdBase: DiffOptionsGMSD =\n base.type === \"gmsd\" ? base : defaultGMSDDiffConfig;\n\n return { ...gmsdBase, ...override, type: \"gmsd\" };\n }\n\n return {\n ...(base as DiffOptionsPixel),\n ...(override as DiffOptionsPixel),\n type: \"pixel\",\n };\n }\n\n /**\n * Initialize playwright and page\n */\n async init() {\n // Launch browser based on type\n const browserMap = {\n chromium,\n firefox,\n webkit,\n };\n\n const browserClass = browserMap[this.browserType];\n if (!browserClass) {\n throw new Error(`Unsupported browser type: ${this.browserType}`);\n }\n\n const browser = await browserClass.launch({\n headless: this.headless,\n });\n\n if (!browser)\n throw new Error(\"Something went wrong with starting the browser.\");\n\n this.browser = browser;\n\n const tempCtx = await browser.newContext();\n const tempPage = await tempCtx.newPage();\n const defaultUserAgent = await tempPage.evaluate(() => navigator.userAgent);\n await tempCtx.close();\n\n // Create N contexts and pages in parallel\n const results = await Promise.all(\n Array.from({ length: this.concurrency }, async () => {\n const context = await browser.newContext({\n reducedMotion: \"reduce\",\n deviceScaleFactor: 2,\n userAgent: `${defaultUserAgent} CappaStorybook`,\n viewport: this.viewport,\n });\n const page = await context.newPage();\n return { context, page };\n }),\n );\n\n this.contexts = results.map((r) => r.context);\n this.pages = results.map((r) => r.page);\n\n // Backward compatibility\n this.context = this.contexts[0] ?? null;\n this.page = this.pages[0] ?? null;\n }\n\n /**\n * Closes browser\n * If not closed, the process will not exit\n */\n async close() {\n for (const context of this.contexts) {\n await context.close();\n }\n if (this.browser) {\n await this.browser.close();\n }\n }\n\n /**\n * Navigates to a URL with \"domcontentloaded\" waitUntil\n */\n async goTo(page: Page, url: string) {\n if (!this.context) {\n throw new Error(\"Browser not initialized\");\n }\n await page.goto(url, {\n waitUntil: \"domcontentloaded\",\n timeout: this.connectionTimeout,\n });\n }\n\n /**\n * Takes a screenshot of the page\n */\n async takeScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n ) {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n return;\n }\n\n try {\n // Generate filename - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n // Ensure parent directories exist before taking screenshot\n await this.filesystem.ensureParentDir(filepath);\n\n // Take screenshot\n const screenshotOptions = {\n path: filepath,\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n await this.withViewport(page, options.viewport, async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n await page.screenshot(screenshotOptions);\n });\n\n this.logger.success(`Screenshot saved: ${filepath}`);\n\n return filepath;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n /**\n * Sets the viewport size and executes the action, ensuring the original viewport is restored\n * even if the action throws an error.\n */\n private async withViewport<T>(\n page: Page,\n viewport: ScreenshotSettings[\"viewport\"],\n action: () => Promise<T>,\n ): Promise<T> {\n if (!viewport) {\n return action();\n }\n\n const previousViewport = page.viewportSize();\n\n // Check if the new viewport is the same as the current one\n if (\n previousViewport &&\n previousViewport.width === viewport.width &&\n previousViewport.height === viewport.height\n ) {\n return action();\n }\n\n await page.setViewportSize(viewport);\n\n try {\n return await action();\n } finally {\n // Always restore the original viewport, even if the action throws an error\n if (previousViewport) {\n await page.setViewportSize(previousViewport);\n }\n }\n }\n\n /**\n * Takes a screenshot and returns the buffer (for comparison purposes)\n */\n async takeScreenshotBuffer(\n page: Page,\n options: ScreenshotSettings,\n ): Promise<Buffer> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n throw new Error(\"Screenshot skipped\");\n }\n\n try {\n // Take screenshot without saving to file\n const screenshotOptions = {\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n const buffer = await this.withViewport(\n page,\n options.viewport,\n async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n return page.screenshot(screenshotOptions);\n },\n );\n\n return buffer;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async takeScreenshotWithComparison(\n page: Page,\n filename: string,\n referenceImage: Buffer,\n options: ScreenshotSettings & {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n },\n diffOverride?: DiffOptions,\n ): Promise<{\n screenshotPath: string;\n comparisonResult: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n }> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n try {\n // Generate filename and take screenshot - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n const screenshotSettings: ScreenshotSettings = {\n fullPage: options.fullPage ?? this.fullPage,\n mask: options.mask,\n omitBackground: options.omitBackground,\n delay: options.delay,\n viewport: options.viewport,\n };\n\n const retryScreenshot = await this.retryScreenshot(\n page,\n referenceImage,\n screenshotSettings,\n diffOverride,\n );\n\n if (!retryScreenshot.screenshotPath) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n // Save screenshot to actual directory\n await this.filesystem.writeActualFile(\n filename,\n retryScreenshot.screenshotPath,\n );\n this.logger.debug(`Actual screenshot saved: ${filepath}`);\n\n if (retryScreenshot.passed) {\n this.logger.success(`Screenshot passed visual comparison`);\n } else {\n this.logger.error(`Screenshot failed visual comparison`);\n }\n\n let diffImagePath: string | undefined;\n\n // Save diff image if requested and there are differences\n if (\n options.saveDiffImage &&\n retryScreenshot.comparisonResult?.diffBuffer &&\n !retryScreenshot.passed\n ) {\n const diffFilename = options.diffImageFilename || filename;\n // Save to diff directory\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n\n await this.filesystem.writeDiffFile(\n diffFilename,\n retryScreenshot.comparisonResult.diffBuffer,\n );\n\n this.logger.debug(`Diff image saved: ${diffImagePath}`);\n }\n\n // different sizes diff image\n if (\n retryScreenshot.comparisonResult !== null &&\n typeof retryScreenshot.comparisonResult === \"object\" &&\n \"differentSizes\" in retryScreenshot.comparisonResult &&\n retryScreenshot.comparisonResult.differentSizes\n ) {\n this.logger.warn(`Screenshot has different sizes than reference image`);\n\n const diffFilename = options.diffImageFilename || filename;\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n const diffBuffer = await createDiffSizePngImage(200, 200);\n\n await this.filesystem.writeDiffFile(diffFilename, diffBuffer);\n\n this.logger.debug(`Diff Size image saved: ${diffImagePath}`);\n }\n\n return {\n screenshotPath: filepath,\n comparisonResult: retryScreenshot.comparisonResult,\n diffImagePath,\n };\n } catch (error) {\n this.logger.error(\n `Error taking screenshot with comparison of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async retryScreenshot(\n page: Page,\n referenceImage: Buffer,\n options: ScreenshotSettings,\n diffOverride?: DiffOptions,\n ) {\n const diffConfig = this.mergeDiffOptions(diffOverride);\n\n for (let i = 0; i < this.retries; i++) {\n try {\n const screenshotBuffer = await this.takeScreenshotBuffer(page, {\n ...options,\n delay: this.getIncBackoffDelay(i, options.delay || 0),\n });\n\n if (!screenshotBuffer) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n const comparisonResult =\n diffConfig.type === \"gmsd\"\n ? await compareImagesGMSD(\n screenshotBuffer,\n referenceImage,\n true,\n diffConfig as DiffConfigGMSD,\n )\n : await compareImages(\n screenshotBuffer,\n referenceImage,\n true,\n diffConfig as DiffConfig,\n );\n\n // last retry\n if (i === this.retries - 1 && !comparisonResult.passed) {\n this.logger.error(\n `Failed to match screenshot after ${this.retries} retries`,\n );\n return {\n screenshotPath: screenshotBuffer,\n comparisonResult,\n passed: false,\n };\n }\n\n if (comparisonResult.passed) {\n return {\n screenshotPath: screenshotBuffer,\n comparisonResult,\n passed: true,\n };\n } else {\n const summary =\n \"numDiffPixels\" in comparisonResult\n ? comparisonResult.differentSizes\n ? \"different image sizes\"\n : `${comparisonResult.numDiffPixels} pixels different (${comparisonResult.percentDifference.toFixed(2)}%)`\n : `gmsd score ${comparisonResult.gmsd.toFixed(4)}`;\n\n this.logger.warn(\n `Comparison did not match. Retrying in ${this.getIncBackoffDelay(i + 1, options.delay || 0)}ms... \\nComparison result: ${summary}`,\n );\n }\n } catch (error) {\n this.logger.error(\n `Error taking screenshot after ${i + 1} retries:`,\n (error as Error).message,\n );\n }\n }\n\n return {\n screenshotPath: null,\n comparisonResult: null,\n passed: false,\n };\n }\n\n getVariantFilename(filename: string, variant: ScreenshotVariant): string {\n if (variant.filename) {\n return variant.filename;\n }\n\n const parsed = path.parse(filename);\n const sanitizedId = variant.id\n .trim()\n .replace(/[^a-zA-Z0-9_-]+/g, \"-\")\n .replace(/-+/g, \"-\")\n .replace(/^-|-$/g, \"\");\n const suffix = sanitizedId || \"variant\";\n const ext = parsed.ext || \".png\";\n const variantName = `${parsed.name}--${suffix}${ext}`;\n\n return parsed.dir ? path.join(parsed.dir, variantName) : variantName;\n }\n\n /**\n * Captures a single screenshot with the given options\n */\n private async captureSingleScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n extras: {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n captureStart?: number;\n } = {},\n ): Promise<ScreenshotCaptureDetails> {\n const result: ScreenshotCaptureDetails = { filename };\n\n if (options.skip) {\n result.skipped = true;\n return result;\n }\n\n const start = extras.captureStart ?? performance.now();\n const saveDiff = extras.saveDiffImage ?? false;\n const diffFilename = extras.diffImageFilename ?? filename;\n const diffOverride = extras.diff;\n\n if (!(await this.filesystem.hasExpectedFile(filename))) {\n this.logger.debug(\n `Expected image not found for ${filename}, taking screenshot`,\n );\n\n result.filepath = await this.takeScreenshot(page, filename, options);\n } else {\n const { screenshotPath, comparisonResult, diffImagePath } =\n await this.takeScreenshotWithComparison(\n page,\n filename,\n await this.filesystem.readExpectedFile(filename),\n {\n ...options,\n saveDiffImage: saveDiff,\n diffImageFilename: diffFilename,\n },\n diffOverride,\n );\n\n result.filepath = screenshotPath;\n result.comparisonResult = comparisonResult;\n result.diffImagePath = diffImagePath;\n }\n\n const duration = Math.round(performance.now() - start);\n this.logger.debug(`${filename} captured in ${duration}ms`);\n\n return result;\n }\n\n async capture(\n page: Page,\n filename: string,\n options: ScreenshotOptions,\n extras: ScreenshotCaptureExtras = {},\n ): Promise<ScreenshotCaptureResult> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n const { variants = [], ...baseOptions } = options;\n const baseResult: ScreenshotCaptureDetails = { filename };\n const variantResults: ScreenshotVariantCaptureDetails[] = [];\n\n const baseSaveDiff = extras.saveDiffImage ?? false;\n const baseDiffFilename = extras.diffImageFilename ?? filename;\n const baseDiffOverride = extras.diff;\n\n if (baseOptions.skip) {\n return {\n base: { ...baseResult, skipped: true },\n variants: variants.map((variant) => ({\n id: variant.id,\n label: variant.label,\n filename: this.getVariantFilename(filename, variant),\n skipped: true,\n })),\n };\n }\n\n // Capture base screenshot\n const baseCaptureResult = await this.captureSingleScreenshot(\n page,\n filename,\n baseOptions,\n {\n saveDiffImage: baseSaveDiff,\n diffImageFilename: baseDiffFilename,\n diff: baseDiffOverride,\n captureStart: extras.captureStart,\n },\n );\n\n baseResult.filepath = baseCaptureResult.filepath;\n baseResult.comparisonResult = baseCaptureResult.comparisonResult;\n baseResult.diffImagePath = baseCaptureResult.diffImagePath;\n baseResult.skipped = baseCaptureResult.skipped;\n\n for (const variant of variants) {\n const variantFilename = this.getVariantFilename(filename, variant);\n const variantOptions: ScreenshotSettings = {\n ...baseOptions,\n ...variant.options,\n };\n\n const variantResult: ScreenshotVariantCaptureDetails = {\n id: variant.id,\n label: variant.label,\n filename: variantFilename,\n };\n\n if (variantOptions.skip) {\n variantResult.skipped = true;\n variantResults.push(variantResult);\n continue;\n }\n\n const variantExtra = extras.variants?.[variant.id];\n const variantSaveDiff = variantExtra?.saveDiffImage ?? baseSaveDiff;\n const variantDiffFilename =\n variantExtra?.diffImageFilename ?? variantFilename;\n const variantDiffOverride = variantExtra?.diff ?? baseDiffOverride;\n\n const variantCaptureResult = await this.captureSingleScreenshot(\n page,\n variantFilename,\n variantOptions,\n {\n saveDiffImage: variantSaveDiff,\n diffImageFilename: variantDiffFilename,\n diff: variantDiffOverride,\n },\n );\n\n variantResult.filepath = variantCaptureResult.filepath;\n variantResult.comparisonResult = variantCaptureResult.comparisonResult;\n variantResult.diffImagePath = variantCaptureResult.diffImagePath;\n variantResult.skipped = variantCaptureResult.skipped;\n\n variantResults.push(variantResult);\n }\n\n return {\n base: baseResult,\n variants: variantResults,\n };\n }\n\n /**\n * Applies SVG and UI optimizations for screenshots\n */\n private async applyScreenshotOptimizations(page: Page) {\n await page.addStyleTag({\n content: `\n *, *::before, *::after {\n -moz-animation: none !important;\n -moz-transition: none !important;\n transition: none !important; \n animation: none !important;\n }\n *, input, textarea { caret-color: transparent !important }\n *:focus { outline: none !important }\n *:focus-visible { outline: none !important }\n *:focus-within { outline: none !important }\n * { text-rendering: optimizeLegibility !important }\n ::-webkit-scrollbar { display: none !important }\n html { scroll-behavior: auto !important }\n svg, svg * {\n shape-rendering: crispEdges !important;\n text-rendering: geometricPrecision !important;\n vector-effect: non-scaling-stroke !important;\n }\n img { image-rendering: crisp-edges !important }\n `,\n });\n }\n\n /**\n * Captures screenshots for multiple variants, each with their own URL\n */\n async captureWithVariants(\n page: Page,\n baseFilename: string,\n baseUrl: string,\n baseOptions: ScreenshotSettings,\n variants: ScreenshotVariantWithUrl[],\n extras: ScreenshotCaptureExtras = {},\n ): Promise<ScreenshotCaptureResult> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n const baseResult: ScreenshotCaptureDetails = { filename: baseFilename };\n const variantResults: ScreenshotVariantCaptureDetails[] = [];\n\n const baseSaveDiff = extras.saveDiffImage ?? false;\n const baseDiffFilename = extras.diffImageFilename ?? baseFilename;\n const baseDiffOverride = extras.diff;\n\n // Capture base screenshot\n let baseStart: number;\n if (!extras.skipBaseNavigation) {\n baseStart = performance.now();\n getLogger().debug(`Going to base URL: ${baseUrl}`);\n await page.goto(baseUrl, { timeout: this.connectionTimeout });\n await this.applyScreenshotOptimizations(page);\n await extras.waitForStability?.(page);\n } else {\n baseStart = performance.now();\n }\n\n const baseCaptureResult = await this.captureSingleScreenshot(\n page,\n baseFilename,\n baseOptions,\n {\n saveDiffImage: baseSaveDiff,\n diffImageFilename: baseDiffFilename,\n diff: baseDiffOverride,\n captureStart: extras.captureStart ?? baseStart,\n },\n );\n\n baseResult.filepath = baseCaptureResult.filepath;\n baseResult.comparisonResult = baseCaptureResult.comparisonResult;\n baseResult.diffImagePath = baseCaptureResult.diffImagePath;\n baseResult.skipped = baseCaptureResult.skipped;\n\n // Capture variant screenshots\n for (const variant of variants) {\n const variantFilename =\n variant.filename || this.getVariantFilename(baseFilename, variant);\n const variantOptions: ScreenshotSettings = {\n ...baseOptions,\n ...variant.options,\n };\n\n const variantResult: ScreenshotVariantCaptureDetails = {\n id: variant.id,\n label: variant.label,\n filename: variantFilename,\n };\n\n if (variantOptions.skip) {\n variantResult.skipped = true;\n variantResults.push(variantResult);\n continue;\n }\n\n // Navigate to variant URL and apply optimizations\n const variantStart = performance.now();\n getLogger().debug(`Going to variant URL: ${variant.url}`);\n await page.goto(variant.url, { timeout: this.connectionTimeout });\n await this.applyScreenshotOptimizations(page);\n await extras.waitForStability?.(page);\n\n const variantExtra = extras.variants?.[variant.id];\n const variantSaveDiff = variantExtra?.saveDiffImage ?? baseSaveDiff;\n const variantDiffFilename =\n variantExtra?.diffImageFilename ?? variantFilename;\n const variantDiffOverride = variantExtra?.diff ?? baseDiffOverride;\n\n const variantCaptureResult = await this.captureSingleScreenshot(\n page,\n variantFilename,\n variantOptions,\n {\n saveDiffImage: variantSaveDiff,\n diffImageFilename: variantDiffFilename,\n diff: variantDiffOverride,\n captureStart: variantStart,\n },\n );\n\n variantResult.filepath = variantCaptureResult.filepath;\n variantResult.comparisonResult = variantCaptureResult.comparisonResult;\n variantResult.diffImagePath = variantCaptureResult.diffImagePath;\n variantResult.skipped = variantCaptureResult.skipped;\n\n variantResults.push(variantResult);\n }\n\n return {\n base: baseResult,\n variants: variantResults,\n };\n }\n\n /**\n * Gets the exponential backoff delay\n */\n getIncBackoffDelay(i: number, delay: number): number {\n return i > 0 ? 500 * 2 ** (i - 1) + (delay || 0) : 0;\n }\n\n /**\n * Get a page from the pool by index\n */\n getPageFromPool(index: number): Page {\n if (index < 0) {\n throw new Error(`Page index ${index} must be non-negative`);\n }\n\n if (index >= this.pages.length) {\n throw new Error(\n `Page index ${index} exceeds pool size ${this.pages.length}`,\n );\n }\n\n if (!this.pages[index]) {\n throw new Error(`Page index ${index} is undefined`);\n }\n\n return this.pages[index];\n }\n}\n\nexport default ScreenshotTool;\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["fsp","path","os","fs","path","fsp","fs","path"],"sources":["../src/features/png/util.ts","../src/features/png/png.ts","../src/compare/gmsd.ts","../src/compare/pixel.ts","../src/config.ts","../src/mapWithConcurrency.ts","../src/filesystem.ts","../src/screenshot.ts"],"sourcesContent":["import { open } from \"node:fs/promises\";\nimport type { MetadataEntries } from \"./types\";\n\ntype ParsedChunk = {\n type: string;\n data: Buffer;\n length: number;\n offset: number;\n};\n\n// Magic Bytes:\n// The first 8 bytes of every valid PNG file.\n// Used to verify that the file is actually a PNG before processing.\nconst pngSignature = Buffer.from([\n 0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,\n]);\n\n// A pre-calculated lookup table for the CRC32 algorithm.\n// We use this to quickly calculate the checksum for each chunk we write.\n// Without this table, calculating CRC bit-by-bit would be significantly slower.\nconst crcTable = new Uint32Array(256).map((_, index) => {\n let c = index;\n for (let k = 0; k < 8; k++) {\n c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;\n }\n\n return c >>> 0;\n});\n\n/**\n * Chunk Parser Generator\n *\n * A PNG file is essentially a list of chunks.\n * Structure of a chunk:\n * 1. Length (4 bytes): The size of the data field.\n * 2. Type (4 bytes): ASCII name (e.g., 'IHDR', 'tEXt', 'IEND').\n * 3. Data (Length bytes): The actual payload.\n * 4. CRC (4 bytes): Checksum.\n */\nfunction* readChunks(buffer: Buffer): Generator<ParsedChunk> {\n let offset = pngSignature.length;\n\n while (offset + 8 <= buffer.length) {\n const length = buffer.readUInt32BE(offset);\n const type = buffer.toString(\"ascii\", offset + 4, offset + 8);\n const dataStart = offset + 8;\n const dataEnd = dataStart + length;\n\n if (dataEnd > buffer.length) {\n return;\n }\n\n const data = buffer.subarray(dataStart, dataEnd);\n\n yield { type, data, length, offset };\n\n offset = dataEnd + 4; // Skip CRC\n\n if (type === \"IEND\") {\n return;\n }\n }\n}\n\n/**\n * Constructs a raw binary `tEXt` chunk.\n */\nexport function createTextChunk(key: string, value: string) {\n const keyBuffer = Buffer.from(key, \"latin1\");\n const valueBuffer = Buffer.from(value, \"latin1\");\n const data = Buffer.concat([keyBuffer, Buffer.from([0]), valueBuffer]);\n const lengthBuffer = Buffer.alloc(4);\n const typeBuffer = Buffer.from(\"tEXt\");\n\n lengthBuffer.writeUInt32BE(data.length, 0);\n\n const crcBuffer = Buffer.alloc(4);\n crcBuffer.writeUInt32BE(crc32(Buffer.concat([typeBuffer, data])), 0);\n\n return Buffer.concat([lengthBuffer, typeBuffer, data, crcBuffer]);\n}\n\n/**\n * Calculates the CRC32 checksum for a buffer.\n * Used to ensure data integrity.\n */\nexport function crc32(buffer: Buffer) {\n let crc = 0 ^ -1;\n\n for (let i = 0; i < buffer.length; i++) {\n // biome-ignore lint/style/noNonNullAssertion: we know the index is valid\n crc = (crc >>> 8) ^ crcTable[(crc ^ buffer[i]!) & 0xff]!;\n }\n\n return (crc ^ -1) >>> 0;\n}\n\n/**\n * Helper to locate the IEND chunk, which marks the end of a PNG stream.\n */\nfunction findIendChunk(buffer: Buffer): ParsedChunk | undefined {\n for (const chunk of readChunks(buffer)) {\n if (chunk.type === \"IEND\") {\n return chunk;\n }\n }\n\n return undefined;\n}\n\n/**\n * Inserts metadata chunks into a PNG buffer.\n * It places them right before the final `IEND` chunk.\n */\nexport function injectTextMetadata(buffer: Buffer, metadata: MetadataEntries) {\n if (!buffer.subarray(0, pngSignature.length).equals(pngSignature)) {\n return buffer;\n }\n\n const iendChunk = findIendChunk(buffer);\n if (!iendChunk) {\n return buffer;\n }\n\n const textChunks = Object.entries(metadata).map(([key, value]) =>\n createTextChunk(key, value),\n );\n\n return Buffer.concat([\n buffer.subarray(0, iendChunk.offset),\n ...textChunks,\n buffer.subarray(iendChunk.offset),\n ]);\n}\n\nexport function isValidPngSignature(buffer: Buffer): boolean {\n if (buffer.length < pngSignature.length) return false;\n return buffer.subarray(0, pngSignature.length).equals(pngSignature);\n}\n\nconst IHDR_MIN_BYTES = 24;\n\nexport async function readIhdrDimensions(\n source: string | Buffer,\n): Promise<{ width: number; height: number }> {\n let buf: Buffer;\n\n if (typeof source === \"string\") {\n const fh = await open(source, \"r\");\n try {\n buf = Buffer.alloc(IHDR_MIN_BYTES);\n await fh.read(buf, 0, IHDR_MIN_BYTES, 0);\n } finally {\n await fh.close();\n }\n } else {\n buf = source;\n }\n\n if (\n buf.length < IHDR_MIN_BYTES ||\n !buf.subarray(0, pngSignature.length).equals(pngSignature)\n ) {\n throw new Error(\"Not a valid PNG\");\n }\n\n const width = buf.readUInt32BE(16);\n const height = buf.readUInt32BE(20);\n return { width, height };\n}\n\n/**\n * Scans a raw PNG buffer and extracts key-value pairs from `tEXt` chunks.\n */\nexport function extractTextMetadata(buffer: Buffer): MetadataEntries {\n if (!buffer.subarray(0, pngSignature.length).equals(pngSignature)) {\n return {};\n }\n\n const metadata: MetadataEntries = {};\n\n for (const chunk of readChunks(buffer)) {\n if (chunk.type !== \"tEXt\") {\n continue;\n }\n\n const separatorIndex = chunk.data.indexOf(0);\n if (separatorIndex < 0) {\n continue;\n }\n\n const key = chunk.data.toString(\"latin1\", 0, separatorIndex);\n const value = chunk.data.toString(\"latin1\", separatorIndex + 1);\n\n metadata[key] = value;\n }\n\n return metadata;\n}\n","import { readFile, writeFile } from \"node:fs/promises\";\nimport sharp from \"sharp\";\nimport type { MetadataEntries } from \"./types\";\nimport { extractTextMetadata, injectTextMetadata } from \"./util\";\n\n/**\n * A wrapper around `sharp` that adds support for reading and writing\n * textual metadata (tEXt chunks). Used for fast PNG decode/encode.\n */\nexport class PNG {\n private width_: number;\n private height_: number;\n private data_: Buffer;\n private sourcePath?: string;\n private metadataEntries: MetadataEntries;\n\n private constructor(\n width: number,\n height: number,\n data: Buffer,\n sourcePath?: string,\n metadata?: MetadataEntries,\n ) {\n this.width_ = width;\n this.height_ = height;\n this.data_ = data;\n this.sourcePath = sourcePath;\n this.metadataEntries = { ...(metadata ?? {}) };\n }\n\n static create(width: number, height: number): PNG {\n const data = Buffer.alloc(width * height * 4, 0);\n return new PNG(width, height, data);\n }\n\n static async load(source: string | Buffer): Promise<PNG> {\n const buffer = typeof source === \"string\" ? await readFile(source) : source;\n const metadata = extractTextMetadata(buffer);\n\n const pipeline = sharp(buffer).ensureAlpha();\n const { data: raw, info } = await pipeline\n .raw()\n .toBuffer({ resolveWithObject: true });\n\n const data = Buffer.from(raw);\n const sourcePath = typeof source === \"string\" ? source : undefined;\n\n return new PNG(info.width, info.height, data, sourcePath, metadata);\n }\n\n get width(): number {\n return this.width_;\n }\n\n get height(): number {\n return this.height_;\n }\n\n get data(): Buffer {\n return this.data_;\n }\n\n get metadata(): MetadataEntries {\n return { ...this.metadataEntries };\n }\n\n setMetadata(key: string, value: string): void {\n this.metadataEntries = { ...this.metadataEntries, [key]: value };\n }\n\n replaceMetadata(metadata: MetadataEntries): void {\n this.metadataEntries = { ...metadata };\n }\n\n removeMetadata(key: string): void {\n const { [key]: _, ...remaining } = this.metadataEntries;\n this.metadataEntries = remaining;\n }\n\n clearMetadata(): void {\n this.metadataEntries = {};\n }\n\n async toBuffer(): Promise<Buffer> {\n const baseBuffer = await sharp(this.data_, {\n raw: { width: this.width_, height: this.height_, channels: 4 },\n })\n .png()\n .toBuffer();\n\n if (Object.keys(this.metadataEntries).length === 0) {\n return baseBuffer;\n }\n\n return injectTextMetadata(baseBuffer, this.metadataEntries);\n }\n\n async save(filepath?: string): Promise<void> {\n const targetPath = filepath ?? this.sourcePath;\n\n if (!targetPath) {\n throw new Error(\"No filepath provided for saving PNG\");\n }\n\n await writeFile(targetPath, await this.toBuffer());\n }\n}\n","import fs from \"node:fs\";\nimport gmsd, { type GmsdOptions } from \"@blazediff/gmsd\";\nimport { getLogger } from \"@cappa/logger\";\nimport { PNG } from \"../features/png/png\";\nimport type { DiffConfigGMSD } from \"../types\";\n\nexport type CompareOptions = GmsdOptions;\n\nexport interface CompareResult {\n gmsd: number;\n diffBuffer?: Buffer; // PNG buffer of the diff image\n passed: boolean; // Whether the comparison passed based on threshold\n error?: string; // Error message if the comparison failed\n}\n\nconst compare = (\n image1: Uint8Array | Uint8ClampedArray,\n image2: Uint8Array | Uint8ClampedArray,\n diff: Uint8Array | Uint8ClampedArray | undefined,\n width: number,\n height: number,\n options?: GmsdOptions,\n) => {\n return gmsd(image1, image2, diff, width, height, options);\n};\n\n/**\n * Compare two PNG images and return the difference\n * @param image1 - First image (file path or Buffer)\n * @param image2 - Second image (file path or Buffer)\n * @param withDiff - Whether to create a diff image\n * @param options - Comparison options\n * @returns Comparison result\n */\nexport async function compareImagesGMSD(\n image1: string | Buffer,\n image2: string | Buffer,\n withDiff: boolean = false,\n options: DiffConfigGMSD = {},\n): Promise<CompareResult> {\n // Load both PNGs in parallel with sharp for better performance\n const [png1, png2] = await Promise.all([loadPNG(image1), loadPNG(image2)]);\n\n const { width, height } = png1;\n\n if (width !== png2.width || height !== png2.height) {\n return { gmsd: Infinity, passed: false };\n }\n\n const diff = withDiff ? PNG.create(width, height) : undefined;\n\n try {\n const gmsd = compare(png1.data, png2.data, diff?.data, width, height, {\n downsample: options.downsample ?? 0,\n c: options.c ?? 170,\n });\n\n // Convert diff image to buffer\n const diffBuffer = diff\n ? await annotateDiffImage(diff, options).toBuffer()\n : undefined;\n\n return {\n gmsd,\n diffBuffer,\n passed: gmsd <= (options.threshold ?? 0.1),\n };\n } catch (error) {\n getLogger().error((error as Error).message || \"Unknown error\");\n\n return {\n gmsd: Infinity,\n passed: false,\n error: (error as Error).message || \"Unknown error\",\n };\n }\n}\n\n/**\n * Load a PNG image from file path or Buffer\n */\nasync function loadPNG(source: string | Buffer): Promise<PNG> {\n return PNG.load(source);\n}\n\nfunction annotateDiffImage(image: PNG, options: DiffConfigGMSD) {\n image.setMetadata(\"cappa.diff.algorithm\", \"gmsd\");\n\n for (const [key, value] of Object.entries(options)) {\n if (value === undefined) {\n continue;\n }\n\n image.setMetadata(`cappa.diff.${key}`, String(value));\n }\n\n return image;\n}\n\n/**\n * Save a comparison result diff image to file\n * @param result - Comparison result containing diffBuffer\n * @param outputPath - Path to save the diff image\n */\nexport function saveDiffImage(result: CompareResult, outputPath: string): void {\n if (!result.diffBuffer) {\n throw new Error(\"No diff buffer available in comparison result\");\n }\n\n fs.writeFileSync(outputPath, result.diffBuffer);\n}\n\n/**\n * Quick comparison function that returns only pass/fail\n * @param image1 - First image (file path or Buffer)\n * @param image2 - Second image (file path or Buffer)\n * @param options - Comparison options\n * @returns Whether the images match\n */\nexport async function imagesMatchGMSD(\n image1: string | Buffer,\n image2: string | Buffer,\n options: DiffConfigGMSD = {},\n): Promise<boolean> {\n const result = await compareImagesGMSD(image1, image2, false, options);\n\n return result.passed;\n}\n","import fs from \"node:fs\";\nimport fsp from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport {\n type BlazeDiffOptions,\n type BlazeDiffResult,\n compare as blazediffCompare,\n type InterpretResult,\n} from \"@blazediff/core-native\";\nimport { getLogger } from \"@cappa/logger\";\nimport { PNG } from \"../features/png/png\";\nimport {\n injectTextMetadata,\n isValidPngSignature,\n readIhdrDimensions,\n} from \"../features/png/util\";\nimport type { DiffConfig } from \"../types\";\n\n/** Pixel diff options: Cappa `DiffConfig` plus optional native-only output tuning. */\nexport type CompareOptions = DiffConfig &\n Partial<Pick<BlazeDiffOptions, \"diffMask\" | \"compression\" | \"quality\">>;\n\nexport interface CompareResult {\n numDiffPixels: number;\n totalPixels: number;\n percentDifference: number;\n diffBuffer?: Buffer; // PNG buffer of the diff image\n passed: boolean; // Whether the comparison passed based on threshold\n error?: string; // Error message if the comparison failed\n differentSizes: boolean; // Whether the images have different sizes\n interpretation?: InterpretResult; // Structured diff analysis (when `interpret` is enabled)\n}\n\ntype TempState = { tempRoot?: string };\n\nasync function ensureTempRoot(state: TempState): Promise<string> {\n if (!state.tempRoot) {\n state.tempRoot = await fsp.mkdtemp(path.join(os.tmpdir(), \"cappa-pxl-\"));\n }\n return state.tempRoot;\n}\n\nasync function resolveInputPath(\n source: string | Buffer,\n fileName: string,\n state: TempState,\n): Promise<string> {\n if (typeof source === \"string\") {\n await fsp.access(source, fs.constants.R_OK);\n return path.resolve(source);\n }\n\n if (!isValidPngSignature(source)) {\n throw new Error(\"Invalid PNG buffer: missing PNG signature\");\n }\n\n const root = await ensureTempRoot(state);\n const dest = path.join(root, fileName);\n await fsp.writeFile(dest, source);\n return dest;\n}\n\nfunction toNativeOptions(\n config: DiffConfig,\n withDiff: boolean,\n): BlazeDiffOptions {\n const extra = config as CompareOptions;\n const out: BlazeDiffOptions = {\n threshold: extra.threshold,\n antialiasing: extra.includeAA ?? false,\n };\n\n // Only run the interpretation pass when we are actually producing a diff. This\n // avoids wasted work for pass/fail-only comparisons (e.g. `imagesMatch` during\n // approval), where the interpretation result would be discarded anyway.\n if (extra.interpret && withDiff) {\n out.interpret = true;\n }\n if (extra.diffMask !== undefined) {\n out.diffMask = extra.diffMask;\n }\n if (extra.compression !== undefined) {\n out.compression = extra.compression;\n }\n if (extra.quality !== undefined) {\n out.quality = extra.quality;\n }\n\n return out;\n}\n\n/**\n * Compare two PNG images and return the difference\n * @param image1 - First image (file path or Buffer)\n * @param image2 - Second image (file path or Buffer)\n * @param withDiff - Whether to create a diff image\n * @param options - Comparison options\n * @returns Comparison result\n */\nexport async function compareImages(\n image1: string | Buffer,\n image2: string | Buffer,\n withDiff: boolean = false,\n options: DiffConfig = {},\n): Promise<CompareResult> {\n const state: TempState = {};\n let diffPath: string | undefined;\n\n try {\n const p1 = await resolveInputPath(image1, \"expected.png\", state);\n const p2 = await resolveInputPath(image2, \"actual.png\", state);\n\n if (withDiff) {\n const root = await ensureTempRoot(state);\n diffPath = path.join(root, \"diff.png\");\n }\n\n let nativeResult: BlazeDiffResult;\n\n try {\n nativeResult = await blazediffCompare(\n p1,\n p2,\n withDiff ? diffPath : undefined,\n toNativeOptions(options, withDiff),\n );\n } catch (error) {\n getLogger().error((error as Error).message || \"Unknown error\");\n\n return {\n numDiffPixels: 0,\n totalPixels: 0,\n percentDifference: 0,\n passed: false,\n differentSizes: false,\n error: (error as Error).message || \"Unknown error\",\n };\n }\n\n if (nativeResult.match === false) {\n if (nativeResult.reason === \"file-not-exists\") {\n throw new Error(`File not found: ${nativeResult.file}`);\n }\n\n if (nativeResult.reason === \"layout-diff\") {\n return {\n numDiffPixels: 0,\n totalPixels: 0,\n percentDifference: 0,\n passed: false,\n differentSizes: true,\n };\n }\n }\n\n const { width, height } = await readIhdrDimensions(p1);\n const totalPixels = width * height;\n\n if (nativeResult.match) {\n return {\n numDiffPixels: 0,\n totalPixels,\n percentDifference: 0,\n diffBuffer: undefined,\n passed: isPassed(0, 0, options),\n differentSizes: false,\n };\n }\n\n let diffBuffer: Buffer | undefined;\n if (withDiff && diffPath) {\n const rawDiff = await fsp.readFile(diffPath);\n const diffMetadata: Record<string, string> = {\n \"cappa.diff.algorithm\": \"pixel\",\n };\n for (const [key, value] of Object.entries(options)) {\n if (value !== undefined) {\n diffMetadata[`cappa.diff.${key}`] = String(value);\n }\n }\n diffBuffer = injectTextMetadata(rawDiff, diffMetadata);\n }\n\n const numDiffPixels = nativeResult.diffCount;\n const percentDifference = nativeResult.diffPercentage;\n\n return {\n numDiffPixels,\n totalPixels,\n percentDifference,\n diffBuffer,\n passed: isPassed(percentDifference, numDiffPixels, options),\n differentSizes: false,\n interpretation: nativeResult.interpretation,\n };\n } finally {\n if (state.tempRoot) {\n await fsp\n .rm(state.tempRoot, { recursive: true, force: true })\n .catch(() => {\n // ignore cleanup errors\n });\n }\n }\n}\n\n/**\n * Save a comparison result diff image to file\n * @param result - Comparison result containing diffBuffer\n * @param outputPath - Path to save the diff image\n */\nexport function saveDiffImage(result: CompareResult, outputPath: string): void {\n if (!result.diffBuffer) {\n throw new Error(\"No diff buffer available in comparison result\");\n }\n\n fs.writeFileSync(outputPath, result.diffBuffer);\n}\n\n/**\n * Quick comparison function that returns only pass/fail\n * @param image1 - First image (file path or Buffer)\n * @param image2 - Second image (file path or Buffer)\n * @param options - Comparison options\n * @returns Whether the images match\n */\nexport async function imagesMatch(\n image1: string | Buffer,\n image2: string | Buffer,\n options: DiffConfig = {},\n): Promise<boolean> {\n const result = await compareImages(image1, image2, false, options);\n\n return result.passed;\n}\n\n/**\n * Check if the comparison passed based on the options\n * @param percentDifference - Percentage difference between the images\n * @param numDiffPixels - Number of different pixels\n * @param options - Comparison options\n * @returns Whether the comparison passed\n */\nconst isPassed = (\n percentDifference: number,\n numDiffPixels: number,\n options: DiffConfig,\n) => {\n if (options.maxDiffPercentage && options.maxDiffPixels) {\n return (\n percentDifference <= options.maxDiffPercentage &&\n numDiffPixels <= options.maxDiffPixels\n );\n }\n\n if (options.maxDiffPercentage) {\n return percentDifference <= options.maxDiffPercentage;\n }\n\n if (options.maxDiffPixels) {\n return numDiffPixels <= options.maxDiffPixels;\n }\n\n // fallback to 0 pixels\n return numDiffPixels === 0;\n};\n\n/**\n * Create different size png image with all pixels red\n * @returns\n */\nexport async function createDiffSizePngImage(\n width: number,\n height: number,\n): Promise<Buffer> {\n const png = PNG.create(width, height);\n\n for (let y = 0; y < height; y++) {\n for (let x = 0; x < width; x++) {\n const idx = (width * y + x) << 2;\n png.data[idx] = 255; // red\n png.data[idx + 1] = 0; // green\n png.data[idx + 2] = 0; // blue\n png.data[idx + 3] = 255; // alpha\n }\n }\n\n return png.toBuffer();\n}\n","import type { ConfigEnv, PossiblePromise, UserConfig } from \"./types\";\n\n/**\n * Type helper to make it easier to use cappa.config.ts, or a function that returns it. The function receives a ConfigEnv object.\n */\nexport function defineConfig(\n options:\n | PossiblePromise<UserConfig>\n | ((env: ConfigEnv) => PossiblePromise<UserConfig>),\n): typeof options {\n return options;\n}\n","/**\n * Run async work over `items` with at most `concurrency` tasks in flight.\n * Preserves failure behavior: the first rejection rejects the returned promise.\n * Results are returned in the same order as the input items.\n */\nexport async function mapWithConcurrency<T, R = void>(\n concurrency: number,\n items: readonly T[],\n fn: (item: T, workerIndex: number) => Promise<R>,\n): Promise<R[]> {\n if (items.length === 0) {\n return [];\n }\n\n const limit = Math.max(1, concurrency);\n const workerCount = Math.min(limit, items.length);\n const results: R[] = new Array(items.length);\n let next = 0;\n\n const worker = async (workerIndex: number): Promise<void> => {\n while (true) {\n const i = next++;\n if (i >= items.length) {\n return;\n }\n const item = items[i];\n if (item === undefined) {\n return;\n }\n results[i] = await fn(item, workerIndex);\n }\n };\n\n await Promise.all(Array.from({ length: workerCount }, (_, i) => worker(i)));\n\n return results;\n}\n","import fs from \"node:fs\";\nimport fsp, { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { imagesMatch } from \"./compare/pixel\";\nimport { extractTextMetadata, injectTextMetadata } from \"./features/png/util\";\nimport { mapWithConcurrency } from \"./mapWithConcurrency\";\nimport type {\n DiffConfig,\n DiffMetadata,\n DiffOptions,\n Screenshot,\n} from \"./types\";\n\nconst APPROVE_SCREENSHOTS_CONCURRENCY = 8;\n\n/**\n * Map a diff image path to its sidecar metadata path (`.png` -> `.json`).\n */\nexport function toDiffMetaPath(diffImagePath: string): string {\n const ext = path.extname(diffImagePath);\n return ext\n ? `${diffImagePath.slice(0, -ext.length)}.json`\n : `${diffImagePath}.json`;\n}\n\n/**\n * Read a diff metadata sidecar, returning `undefined` when it is missing or\n * cannot be parsed (so callers can degrade gracefully).\n */\nexport async function readDiffMeta(\n diffImagePath: string,\n): Promise<DiffMetadata | undefined> {\n try {\n const raw = await fsp.readFile(toDiffMetaPath(diffImagePath), \"utf8\");\n return JSON.parse(raw) as DiffMetadata;\n } catch {\n return undefined;\n }\n}\n\n/**\n * Class for interacting with the local file system to store the screenshots.\n */\nexport class ScreenshotFileSystem {\n private readonly actual: string;\n private readonly expected: string;\n private readonly diff: string;\n\n constructor(outputDir: string) {\n this.actual = path.resolve(outputDir, \"actual\");\n this.expected = path.resolve(outputDir, \"expected\");\n this.diff = path.resolve(outputDir, \"diff\");\n\n this.ensureParentDirSync(this.actual);\n this.ensureParentDirSync(this.expected);\n this.ensureParentDirSync(this.diff);\n }\n\n clearActual() {\n this.removeDir(this.actual);\n }\n\n clearDiff() {\n this.removeDir(this.diff);\n }\n\n getActualScreenshots(): Promise<string[]> {\n return Array.fromAsync(glob(path.resolve(this.actual, \"**/*.png\")));\n }\n\n getExpectedScreenshots(): Promise<string[]> {\n return Array.fromAsync(glob(path.resolve(this.expected, \"**/*.png\")));\n }\n\n getDiffScreenshots(): Promise<string[]> {\n return Array.fromAsync(glob(path.resolve(this.diff, \"**/*.png\")));\n }\n\n clearActualAndDiff() {\n this.clearActual();\n this.clearDiff();\n }\n\n /**\n * Approve a screenshot based on its actual file path.\n * @param actualFilePath - The path to the actual screenshot file.\n * @returns The paths to the actual, expected, and diff screenshot files.\n */\n async approveFromActualPath(actualFilePath: string) {\n const actualAbsolute = this.resolveActualPath(actualFilePath);\n const relativePath = path.relative(this.actual, actualAbsolute);\n\n if (relativePath.startsWith(\"..\")) {\n throw new Error(\n `Cannot approve screenshot outside of actual directory: ${actualFilePath}`,\n );\n }\n\n return this.approveRelative(relativePath);\n }\n\n /**\n * Apply baseline updates for grouped screenshots (same rules as `cappa approve`).\n */\n async approveScreenshots(\n screenshots: Screenshot[],\n diff: DiffOptions,\n ): Promise<void> {\n const outputDir = path.dirname(this.actual);\n\n await mapWithConcurrency(\n APPROVE_SCREENSHOTS_CONCURRENCY,\n screenshots,\n (screenshot) => this.approveOneScreenshot(screenshot, outputDir, diff),\n );\n }\n\n private async approveOneScreenshot(\n screenshot: Screenshot,\n outputDir: string,\n diff: DiffOptions,\n ): Promise<void> {\n const logger = getLogger();\n\n logger.debug(`Approving screenshot with category: ${screenshot.category}`);\n\n if (screenshot.category === \"new\") {\n logger.debug(`Approving new screenshot: ${screenshot.actualPath}`);\n await this.approveFromActualPath(\n path.resolve(outputDir, screenshot.actualPath),\n );\n return;\n }\n\n if (screenshot.category === \"deleted\") {\n logger.debug(`Deleting expected screenshot: ${screenshot.expectedPath}`);\n await fsp.unlink(path.resolve(outputDir, screenshot.expectedPath));\n return;\n }\n\n if (screenshot.category === \"changed\") {\n logger.debug(`Deleting diff screenshot: ${screenshot.diffPath}`);\n const diffPath = path.resolve(outputDir, screenshot.diffPath);\n await fsp.unlink(diffPath);\n await fsp.rm(toDiffMetaPath(diffPath), { force: true });\n await this.approveFromActualPath(\n path.resolve(outputDir, screenshot.actualPath),\n );\n return;\n }\n\n if (screenshot.category === \"passed\") {\n if (!screenshot.expectedPath) {\n throw new Error(\"Expected path is required for passed screenshots\");\n }\n\n const matches = await imagesMatch(\n path.resolve(outputDir, screenshot.actualPath),\n path.resolve(outputDir, screenshot.expectedPath),\n diff.type === \"gmsd\"\n ? { threshold: diff.threshold }\n : (diff as DiffConfig),\n );\n\n if (!matches) {\n await this.approveFromActualPath(\n path.resolve(outputDir, screenshot.actualPath),\n );\n }\n }\n }\n\n /**\n * Approve a screenshot based on its name.\n * @param name - The name of the screenshot. Can include '.png' extension.\n * @returns The paths to the actual, expected, and diff screenshot files.\n */\n async approveByName(name: string) {\n const relativeWithExtension = name.endsWith(\".png\") ? name : `${name}.png`;\n\n return this.approveRelative(relativeWithExtension);\n }\n\n /**\n * Approve a screenshot based on a relative path.\n * @param relativePath - The relative path to the screenshot.\n * @returns The paths to the actual, expected, and diff screenshot files.\n */\n private async approveRelative(relativePath: string) {\n const actualPath = path.resolve(this.actual, relativePath);\n const expectedPath = path.resolve(this.expected, relativePath);\n const diffPath = path.resolve(this.diff, relativePath);\n\n await this.ensureParentDir(expectedPath);\n\n await fsp.copyFile(actualPath, expectedPath);\n\n try {\n await fsp.access(diffPath);\n } catch {\n return {\n actualPath,\n expectedPath,\n diffPath,\n };\n }\n\n await this.copyDiffMetadataToExpected(diffPath, expectedPath);\n await fsp.unlink(diffPath);\n await fsp.rm(toDiffMetaPath(diffPath), { force: true });\n\n return {\n actualPath,\n expectedPath,\n diffPath,\n };\n }\n\n private async copyDiffMetadataToExpected(\n diffPath: string,\n expectedPath: string,\n ): Promise<void> {\n const diffExtension = path.extname(diffPath).toLowerCase();\n const expectedExtension = path.extname(expectedPath).toLowerCase();\n\n if (diffExtension !== \".png\" || expectedExtension !== \".png\") {\n return;\n }\n\n try {\n const diffBuffer = await fsp.readFile(diffPath);\n const diffMetadata = extractTextMetadata(diffBuffer);\n\n if (Object.keys(diffMetadata).length === 0) {\n return;\n }\n\n const expectedBuffer = await fsp.readFile(expectedPath);\n const expectedMetadata = extractTextMetadata(expectedBuffer);\n\n const mergedMetadata = {\n ...expectedMetadata,\n ...diffMetadata,\n };\n\n const expectedWithMetadata = injectTextMetadata(\n expectedBuffer,\n mergedMetadata,\n );\n await fsp.writeFile(expectedPath, expectedWithMetadata);\n } catch {\n // Ignore metadata transfer errors to keep approval resilient.\n }\n }\n\n /**\n * Ensure the parent directory of a file exists. If not, it creates it.\n * @param filePath - The path to the file.\n */\n async ensureParentDir(filePath: string) {\n const dir = path.dirname(filePath);\n await fsp.mkdir(dir, { recursive: true });\n }\n\n /**\n * Synchronous version used only during constructor initialization.\n */\n private ensureParentDirSync(filePath: string) {\n const dir = path.dirname(filePath);\n\n if (!fs.existsSync(dir)) {\n fs.mkdirSync(dir, { recursive: true });\n }\n }\n\n /**\n * Remove a directory and all its contents.\n * @param dir - The path to the directory.\n */\n private removeDir(dir: string) {\n if (fs.existsSync(dir)) {\n fs.rmSync(dir, { recursive: true, force: true });\n }\n }\n\n /**\n * Get the actual directory path\n */\n getActualDir(): string {\n return this.actual;\n }\n\n /**\n * Get the expected directory path\n */\n getExpectedDir(): string {\n return this.expected;\n }\n\n /**\n * Get the diff directory path\n */\n getDiffDir(): string {\n return this.diff;\n }\n\n /**\n * Get the path to an actual screenshot file\n */\n getActualFilePath(filename: string): string {\n return path.resolve(this.actual, filename);\n }\n\n /**\n * Get the path to an expected screenshot file\n */\n getExpectedFilePath(filename: string): string {\n return path.resolve(this.expected, filename);\n }\n\n /**\n * Get the path to a diff screenshot file\n */\n getDiffFilePath(filename: string): string {\n return path.resolve(this.diff, filename);\n }\n\n /**\n * Write a file to the actual directory\n */\n async writeActualFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getActualFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Write a file to the diff directory\n */\n async writeDiffFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getDiffFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Get the path to a diff metadata sidecar file (`<name>.json`)\n */\n getDiffMetaFilePath(filename: string): string {\n return toDiffMetaPath(this.getDiffFilePath(filename));\n }\n\n /**\n * Write a diff metadata sidecar (`diff/<name>.json`) next to the diff image.\n */\n async writeDiffMetaFile(filename: string, meta: DiffMetadata): Promise<void> {\n const filepath = this.getDiffMetaFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, JSON.stringify(meta));\n }\n\n /**\n * Check if an expected file exists\n */\n async hasExpectedFile(filename: string): Promise<boolean> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n await fsp.access(expectedPath);\n return true;\n } catch {\n return false;\n }\n }\n\n /**\n * Read an expected file\n */\n async readExpectedFile(filename: string): Promise<Buffer> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n return await fsp.readFile(expectedPath);\n } catch {\n throw new Error(`Expected image not found: ${expectedPath}`);\n }\n }\n\n /**\n * Resolve the actual path of a screenshot file.\n * @param filePath - The path to the screenshot file.\n * @returns The actual path of the screenshot file.\n */\n private resolveActualPath(filePath: string) {\n if (path.isAbsolute(filePath)) {\n return filePath;\n }\n\n return path.resolve(this.actual, filePath);\n }\n\n getRelativePath(directory: \"actual\" | \"expected\" | \"diff\", filePath: string) {\n const relativePath = path.relative(this[directory], filePath);\n\n if (relativePath.startsWith(\"..\")) {\n throw new Error(\n `Cannot resolve relative path outside of ${directory} directory: ${filePath}`,\n );\n }\n\n return relativePath;\n }\n}\n","import path from \"node:path\";\nimport { getLogger, type Logger } from \"@cappa/logger\";\nimport {\n type Browser,\n type BrowserContext,\n chromium,\n firefox,\n type Page,\n type PageScreenshotOptions,\n webkit,\n} from \"playwright-core\";\nimport {\n compareImagesGMSD,\n type CompareResult as GMSDCompareResult,\n} from \"./compare/gmsd\";\nimport {\n compareImages,\n createDiffSizePngImage,\n type CompareResult as PixelCompareResult,\n} from \"./compare/pixel\";\nimport { ScreenshotFileSystem } from \"./filesystem\";\nimport type {\n DiffConfig,\n DiffConfigGMSD,\n DiffOptions,\n DiffOptionsGMSD,\n DiffOptionsPixel,\n ScreenshotOptions,\n ScreenshotSettings,\n ScreenshotVariant,\n ScreenshotVariantWithUrl,\n} from \"./types\";\n\nconst defaultPixelDiffConfig: DiffOptionsPixel = {\n type: \"pixel\",\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n};\n\nconst defaultGMSDDiffConfig: DiffOptionsGMSD = {\n type: \"gmsd\",\n threshold: 0.1,\n downsample: 0,\n c: 170,\n};\n\nexport interface ScreenshotCaptureDetails {\n filename: string;\n filepath?: string;\n comparisonResult?: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n skipped?: boolean;\n}\n\nexport interface ScreenshotVariantCaptureDetails\n extends ScreenshotCaptureDetails {\n id: string;\n label?: string;\n}\n\nexport interface ScreenshotCaptureResult {\n base: ScreenshotCaptureDetails;\n variants: ScreenshotVariantCaptureDetails[];\n}\n\nexport interface ScreenshotCaptureExtras {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n variants?: Record<\n string,\n {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n }\n >;\n /**\n * Optional diff configuration override applied to this capture.\n * Merged on top of the global ScreenshotTool diff config.\n */\n diff?: DiffOptions;\n /**\n * Skip navigating to the base URL before capturing the base screenshot.\n * Use this when the page is already at the correct URL and in a stable state,\n * to avoid the redundant navigation.\n */\n skipBaseNavigation?: boolean;\n /**\n * Optional callback invoked after each navigation (variants only, or base when\n * skipBaseNavigation is false) to wait for visual stability before capturing.\n */\n waitForStability?: (page: Page) => Promise<void>;\n /**\n * Timestamp (from `performance.now()`) marking when the screenshot process\n * started — i.e. when the browser first navigated to the page. When provided,\n * the logged duration covers the full journey: navigation → stability waits →\n * capture. When omitted, timing begins at the capture step itself.\n */\n captureStart?: number;\n}\n\nclass ScreenshotTool {\n browserType: \"chromium\" | \"firefox\" | \"webkit\";\n headless: boolean;\n viewport: { width: number; height: number };\n fullPage: boolean;\n outputDir: string;\n browser: Browser | null = null;\n context: BrowserContext | null = null;\n page: Page | null = null;\n concurrency: number;\n contexts: BrowserContext[] = [];\n pages: Page[] = [];\n diff: DiffOptions;\n logger: Logger;\n retries: number;\n filesystem: ScreenshotFileSystem;\n logConsoleEvents: boolean;\n connectionTimeout: number;\n\n constructor(options: {\n browserType?: \"chromium\" | \"firefox\" | \"webkit\";\n headless?: boolean;\n viewport?: { width: number; height: number };\n fullPage?: boolean;\n outputDir?: string;\n diff?: DiffOptions;\n retries?: number;\n concurrency?: number;\n logConsoleEvents?: boolean;\n connectionTimeout?: number;\n }) {\n this.browserType = options.browserType || \"chromium\";\n this.headless = options.headless !== false; // Default to headless\n this.viewport = options.viewport || { width: 1920, height: 1080 };\n this.fullPage = options.fullPage ?? true;\n this.outputDir = options.outputDir || \"./screenshots\";\n this.diff = this.resolveDiffOptions(options.diff);\n this.concurrency = Math.max(1, options.concurrency || 1);\n this.logConsoleEvents = options.logConsoleEvents ?? true;\n this.connectionTimeout = options.connectionTimeout ?? 20000;\n\n this.logger = getLogger();\n this.retries = options.retries || 2;\n this.filesystem = new ScreenshotFileSystem(this.outputDir);\n }\n\n private resolveDiffOptions(diff?: DiffOptions): DiffOptions {\n if (diff?.type === \"gmsd\") {\n return { ...defaultGMSDDiffConfig, ...diff };\n }\n\n return { ...defaultPixelDiffConfig, ...diff, type: \"pixel\" };\n }\n\n private mergeDiffOptions(override?: DiffOptions): DiffOptions {\n const base = this.resolveDiffOptions(this.diff);\n\n if (!override) {\n return base;\n }\n\n if (override.type === \"gmsd\" || base.type === \"gmsd\") {\n const gmsdBase: DiffOptionsGMSD =\n base.type === \"gmsd\" ? base : defaultGMSDDiffConfig;\n\n return { ...gmsdBase, ...override, type: \"gmsd\" };\n }\n\n return {\n ...(base as DiffOptionsPixel),\n ...(override as DiffOptionsPixel),\n type: \"pixel\",\n };\n }\n\n /**\n * Initialize playwright and page\n */\n async init() {\n // Launch browser based on type\n const browserMap = {\n chromium,\n firefox,\n webkit,\n };\n\n const browserClass = browserMap[this.browserType];\n if (!browserClass) {\n throw new Error(`Unsupported browser type: ${this.browserType}`);\n }\n\n const browser = await browserClass.launch({\n headless: this.headless,\n });\n\n if (!browser)\n throw new Error(\"Something went wrong with starting the browser.\");\n\n this.browser = browser;\n\n const tempCtx = await browser.newContext();\n const tempPage = await tempCtx.newPage();\n const defaultUserAgent = await tempPage.evaluate(() => navigator.userAgent);\n await tempCtx.close();\n\n // Create N contexts and pages in parallel\n const results = await Promise.all(\n Array.from({ length: this.concurrency }, async () => {\n const context = await browser.newContext({\n reducedMotion: \"reduce\",\n deviceScaleFactor: 2,\n userAgent: `${defaultUserAgent} CappaStorybook`,\n viewport: this.viewport,\n });\n const page = await context.newPage();\n return { context, page };\n }),\n );\n\n this.contexts = results.map((r) => r.context);\n this.pages = results.map((r) => r.page);\n\n // Backward compatibility\n this.context = this.contexts[0] ?? null;\n this.page = this.pages[0] ?? null;\n }\n\n /**\n * Closes browser\n * If not closed, the process will not exit\n */\n async close() {\n for (const context of this.contexts) {\n await context.close();\n }\n if (this.browser) {\n await this.browser.close();\n }\n }\n\n /**\n * Navigates to a URL with \"domcontentloaded\" waitUntil\n */\n async goTo(page: Page, url: string) {\n if (!this.context) {\n throw new Error(\"Browser not initialized\");\n }\n await page.goto(url, {\n waitUntil: \"domcontentloaded\",\n timeout: this.connectionTimeout,\n });\n }\n\n /**\n * Takes a screenshot of the page\n */\n async takeScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n ) {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n return;\n }\n\n try {\n // Generate filename - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n // Ensure parent directories exist before taking screenshot\n await this.filesystem.ensureParentDir(filepath);\n\n // Take screenshot\n const screenshotOptions = {\n path: filepath,\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n await this.withViewport(page, options.viewport, async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n await page.screenshot(screenshotOptions);\n });\n\n this.logger.success(`Screenshot saved: ${filepath}`);\n\n return filepath;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n /**\n * Sets the viewport size and executes the action, ensuring the original viewport is restored\n * even if the action throws an error.\n */\n private async withViewport<T>(\n page: Page,\n viewport: ScreenshotSettings[\"viewport\"],\n action: () => Promise<T>,\n ): Promise<T> {\n if (!viewport) {\n return action();\n }\n\n const previousViewport = page.viewportSize();\n\n // Check if the new viewport is the same as the current one\n if (\n previousViewport &&\n previousViewport.width === viewport.width &&\n previousViewport.height === viewport.height\n ) {\n return action();\n }\n\n await page.setViewportSize(viewport);\n\n try {\n return await action();\n } finally {\n // Always restore the original viewport, even if the action throws an error\n if (previousViewport) {\n await page.setViewportSize(previousViewport);\n }\n }\n }\n\n /**\n * Takes a screenshot and returns the buffer (for comparison purposes)\n */\n async takeScreenshotBuffer(\n page: Page,\n options: ScreenshotSettings,\n ): Promise<Buffer> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n throw new Error(\"Screenshot skipped\");\n }\n\n try {\n // Take screenshot without saving to file\n const screenshotOptions = {\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n const buffer = await this.withViewport(\n page,\n options.viewport,\n async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n return page.screenshot(screenshotOptions);\n },\n );\n\n return buffer;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async takeScreenshotWithComparison(\n page: Page,\n filename: string,\n referenceImage: string | Buffer,\n options: ScreenshotSettings & {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n },\n diffOverride?: DiffOptions,\n ): Promise<{\n screenshotPath: string;\n comparisonResult: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n }> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n try {\n // Generate filename and take screenshot - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n const screenshotSettings: ScreenshotSettings = {\n fullPage: options.fullPage ?? this.fullPage,\n mask: options.mask,\n omitBackground: options.omitBackground,\n delay: options.delay,\n viewport: options.viewport,\n };\n\n const retryScreenshot = await this.retryScreenshot(\n page,\n referenceImage,\n screenshotSettings,\n diffOverride,\n );\n\n if (!retryScreenshot.screenshotPath) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n // Save screenshot to actual directory\n await this.filesystem.writeActualFile(\n filename,\n retryScreenshot.screenshotPath,\n );\n this.logger.debug(`Actual screenshot saved: ${filepath}`);\n\n if (retryScreenshot.passed) {\n this.logger.success(`Screenshot passed visual comparison`);\n } else {\n this.logger.error(`Screenshot failed visual comparison`);\n }\n\n let diffImagePath: string | undefined;\n\n // Save diff image if requested and there are differences\n if (\n options.saveDiffImage &&\n retryScreenshot.comparisonResult?.diffBuffer &&\n !retryScreenshot.passed\n ) {\n const diffFilename = options.diffImageFilename || filename;\n // Save to diff directory\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n\n await this.filesystem.writeDiffFile(\n diffFilename,\n retryScreenshot.comparisonResult.diffBuffer,\n );\n\n this.logger.debug(`Diff image saved: ${diffImagePath}`);\n\n // When interpretation is enabled, persist diff stats + interpretation as\n // a sidecar so the review UI and CLI can surface them after rebuilding\n // state from disk. Skipped entirely otherwise so no extra files appear\n // for users who have not opted in (pixel only).\n const result = retryScreenshot.comparisonResult;\n if (\"numDiffPixels\" in result && result.interpretation) {\n await this.filesystem.writeDiffMetaFile(diffFilename, {\n numDiffPixels: result.numDiffPixels,\n percentDifference: result.percentDifference,\n interpretation: result.interpretation,\n });\n }\n }\n\n // different sizes diff image\n if (\n retryScreenshot.comparisonResult !== null &&\n typeof retryScreenshot.comparisonResult === \"object\" &&\n \"differentSizes\" in retryScreenshot.comparisonResult &&\n retryScreenshot.comparisonResult.differentSizes\n ) {\n this.logger.warn(`Screenshot has different sizes than reference image`);\n\n const diffFilename = options.diffImageFilename || filename;\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n const diffBuffer = await createDiffSizePngImage(200, 200);\n\n await this.filesystem.writeDiffFile(diffFilename, diffBuffer);\n\n this.logger.debug(`Diff Size image saved: ${diffImagePath}`);\n }\n\n return {\n screenshotPath: filepath,\n comparisonResult: retryScreenshot.comparisonResult,\n diffImagePath,\n };\n } catch (error) {\n this.logger.error(\n `Error taking screenshot with comparison of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async retryScreenshot(\n page: Page,\n referenceImage: string | Buffer,\n options: ScreenshotSettings,\n diffOverride?: DiffOptions,\n ) {\n const diffConfig = this.mergeDiffOptions(diffOverride);\n\n for (let i = 0; i < this.retries; i++) {\n try {\n const screenshotBuffer = await this.takeScreenshotBuffer(page, {\n ...options,\n delay: this.getIncBackoffDelay(i, options.delay || 0),\n });\n\n if (!screenshotBuffer) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n const comparisonResult =\n diffConfig.type === \"gmsd\"\n ? await compareImagesGMSD(\n screenshotBuffer,\n referenceImage,\n true,\n diffConfig as DiffConfigGMSD,\n )\n : await compareImages(\n screenshotBuffer,\n referenceImage,\n true,\n diffConfig as DiffConfig,\n );\n\n // last retry\n if (i === this.retries - 1 && !comparisonResult.passed) {\n this.logger.error(\n `Failed to match screenshot after ${this.retries} retries`,\n );\n return {\n screenshotPath: screenshotBuffer,\n comparisonResult,\n passed: false,\n };\n }\n\n if (comparisonResult.passed) {\n return {\n screenshotPath: screenshotBuffer,\n comparisonResult,\n passed: true,\n };\n } else {\n const summary =\n \"numDiffPixels\" in comparisonResult\n ? comparisonResult.differentSizes\n ? \"different image sizes\"\n : `${comparisonResult.numDiffPixels} pixels different (${comparisonResult.percentDifference.toFixed(2)}%)`\n : `gmsd score ${comparisonResult.gmsd.toFixed(4)}`;\n\n this.logger.warn(\n `Comparison did not match. Retrying in ${this.getIncBackoffDelay(i + 1, options.delay || 0)}ms... \\nComparison result: ${summary}`,\n );\n }\n } catch (error) {\n this.logger.error(\n `Error taking screenshot after ${i + 1} retries:`,\n (error as Error).message,\n );\n }\n }\n\n return {\n screenshotPath: null,\n comparisonResult: null,\n passed: false,\n };\n }\n\n getVariantFilename(filename: string, variant: ScreenshotVariant): string {\n if (variant.filename) {\n return variant.filename;\n }\n\n const parsed = path.parse(filename);\n const sanitizedId = variant.id\n .trim()\n .replace(/[^a-zA-Z0-9_-]+/g, \"-\")\n .replace(/-+/g, \"-\")\n .replace(/^-|-$/g, \"\");\n const suffix = sanitizedId || \"variant\";\n const ext = parsed.ext || \".png\";\n const variantName = `${parsed.name}--${suffix}${ext}`;\n\n return parsed.dir ? path.join(parsed.dir, variantName) : variantName;\n }\n\n /**\n * Captures a single screenshot with the given options\n */\n private async captureSingleScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n extras: {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n captureStart?: number;\n } = {},\n ): Promise<ScreenshotCaptureDetails> {\n const result: ScreenshotCaptureDetails = { filename };\n\n if (options.skip) {\n result.skipped = true;\n return result;\n }\n\n const start = extras.captureStart ?? performance.now();\n const saveDiff = extras.saveDiffImage ?? false;\n const diffFilename = extras.diffImageFilename ?? filename;\n const diffOverride = extras.diff;\n\n if (!(await this.filesystem.hasExpectedFile(filename))) {\n this.logger.debug(\n `Expected image not found for ${filename}, taking screenshot`,\n );\n\n result.filepath = await this.takeScreenshot(page, filename, options);\n } else {\n const { screenshotPath, comparisonResult, diffImagePath } =\n await this.takeScreenshotWithComparison(\n page,\n filename,\n this.filesystem.getExpectedFilePath(filename),\n {\n ...options,\n saveDiffImage: saveDiff,\n diffImageFilename: diffFilename,\n },\n diffOverride,\n );\n\n result.filepath = screenshotPath;\n result.comparisonResult = comparisonResult;\n result.diffImagePath = diffImagePath;\n }\n\n const duration = Math.round(performance.now() - start);\n this.logger.debug(`${filename} captured in ${duration}ms`);\n\n return result;\n }\n\n async capture(\n page: Page,\n filename: string,\n options: ScreenshotOptions,\n extras: ScreenshotCaptureExtras = {},\n ): Promise<ScreenshotCaptureResult> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n const { variants = [], ...baseOptions } = options;\n const baseResult: ScreenshotCaptureDetails = { filename };\n const variantResults: ScreenshotVariantCaptureDetails[] = [];\n\n const baseSaveDiff = extras.saveDiffImage ?? false;\n const baseDiffFilename = extras.diffImageFilename ?? filename;\n const baseDiffOverride = extras.diff;\n\n if (baseOptions.skip) {\n return {\n base: { ...baseResult, skipped: true },\n variants: variants.map((variant) => ({\n id: variant.id,\n label: variant.label,\n filename: this.getVariantFilename(filename, variant),\n skipped: true,\n })),\n };\n }\n\n // Capture base screenshot\n const baseCaptureResult = await this.captureSingleScreenshot(\n page,\n filename,\n baseOptions,\n {\n saveDiffImage: baseSaveDiff,\n diffImageFilename: baseDiffFilename,\n diff: baseDiffOverride,\n captureStart: extras.captureStart,\n },\n );\n\n baseResult.filepath = baseCaptureResult.filepath;\n baseResult.comparisonResult = baseCaptureResult.comparisonResult;\n baseResult.diffImagePath = baseCaptureResult.diffImagePath;\n baseResult.skipped = baseCaptureResult.skipped;\n\n for (const variant of variants) {\n const variantFilename = this.getVariantFilename(filename, variant);\n const variantOptions: ScreenshotSettings = {\n ...baseOptions,\n ...variant.options,\n };\n\n const variantResult: ScreenshotVariantCaptureDetails = {\n id: variant.id,\n label: variant.label,\n filename: variantFilename,\n };\n\n if (variantOptions.skip) {\n variantResult.skipped = true;\n variantResults.push(variantResult);\n continue;\n }\n\n const variantExtra = extras.variants?.[variant.id];\n const variantSaveDiff = variantExtra?.saveDiffImage ?? baseSaveDiff;\n const variantDiffFilename =\n variantExtra?.diffImageFilename ?? variantFilename;\n const variantDiffOverride = variantExtra?.diff ?? baseDiffOverride;\n\n const variantCaptureResult = await this.captureSingleScreenshot(\n page,\n variantFilename,\n variantOptions,\n {\n saveDiffImage: variantSaveDiff,\n diffImageFilename: variantDiffFilename,\n diff: variantDiffOverride,\n },\n );\n\n variantResult.filepath = variantCaptureResult.filepath;\n variantResult.comparisonResult = variantCaptureResult.comparisonResult;\n variantResult.diffImagePath = variantCaptureResult.diffImagePath;\n variantResult.skipped = variantCaptureResult.skipped;\n\n variantResults.push(variantResult);\n }\n\n return {\n base: baseResult,\n variants: variantResults,\n };\n }\n\n /**\n * Applies SVG and UI optimizations for screenshots\n */\n private async applyScreenshotOptimizations(page: Page) {\n await page.addStyleTag({\n content: `\n *, *::before, *::after {\n -moz-animation: none !important;\n -moz-transition: none !important;\n transition: none !important; \n animation: none !important;\n }\n *, input, textarea { caret-color: transparent !important }\n *:focus { outline: none !important }\n *:focus-visible { outline: none !important }\n *:focus-within { outline: none !important }\n * { text-rendering: optimizeLegibility !important }\n ::-webkit-scrollbar { display: none !important }\n html { scroll-behavior: auto !important }\n svg, svg * {\n shape-rendering: crispEdges !important;\n text-rendering: geometricPrecision !important;\n vector-effect: non-scaling-stroke !important;\n }\n img { image-rendering: crisp-edges !important }\n `,\n });\n }\n\n /**\n * Captures screenshots for multiple variants, each with their own URL\n */\n async captureWithVariants(\n page: Page,\n baseFilename: string,\n baseUrl: string,\n baseOptions: ScreenshotSettings,\n variants: ScreenshotVariantWithUrl[],\n extras: ScreenshotCaptureExtras = {},\n ): Promise<ScreenshotCaptureResult> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n const baseResult: ScreenshotCaptureDetails = { filename: baseFilename };\n const variantResults: ScreenshotVariantCaptureDetails[] = [];\n\n const baseSaveDiff = extras.saveDiffImage ?? false;\n const baseDiffFilename = extras.diffImageFilename ?? baseFilename;\n const baseDiffOverride = extras.diff;\n\n // Capture base screenshot\n let baseStart: number;\n if (!extras.skipBaseNavigation) {\n baseStart = performance.now();\n getLogger().debug(`Going to base URL: ${baseUrl}`);\n await page.goto(baseUrl, { timeout: this.connectionTimeout });\n await this.applyScreenshotOptimizations(page);\n await extras.waitForStability?.(page);\n } else {\n baseStart = performance.now();\n }\n\n const baseCaptureResult = await this.captureSingleScreenshot(\n page,\n baseFilename,\n baseOptions,\n {\n saveDiffImage: baseSaveDiff,\n diffImageFilename: baseDiffFilename,\n diff: baseDiffOverride,\n captureStart: extras.captureStart ?? baseStart,\n },\n );\n\n baseResult.filepath = baseCaptureResult.filepath;\n baseResult.comparisonResult = baseCaptureResult.comparisonResult;\n baseResult.diffImagePath = baseCaptureResult.diffImagePath;\n baseResult.skipped = baseCaptureResult.skipped;\n\n // Capture variant screenshots\n for (const variant of variants) {\n const variantFilename =\n variant.filename || this.getVariantFilename(baseFilename, variant);\n const variantOptions: ScreenshotSettings = {\n ...baseOptions,\n ...variant.options,\n };\n\n const variantResult: ScreenshotVariantCaptureDetails = {\n id: variant.id,\n label: variant.label,\n filename: variantFilename,\n };\n\n if (variantOptions.skip) {\n variantResult.skipped = true;\n variantResults.push(variantResult);\n continue;\n }\n\n // Navigate to variant URL and apply optimizations\n const variantStart = performance.now();\n getLogger().debug(`Going to variant URL: ${variant.url}`);\n await page.goto(variant.url, { timeout: this.connectionTimeout });\n await this.applyScreenshotOptimizations(page);\n await extras.waitForStability?.(page);\n\n const variantExtra = extras.variants?.[variant.id];\n const variantSaveDiff = variantExtra?.saveDiffImage ?? baseSaveDiff;\n const variantDiffFilename =\n variantExtra?.diffImageFilename ?? variantFilename;\n const variantDiffOverride = variantExtra?.diff ?? baseDiffOverride;\n\n const variantCaptureResult = await this.captureSingleScreenshot(\n page,\n variantFilename,\n variantOptions,\n {\n saveDiffImage: variantSaveDiff,\n diffImageFilename: variantDiffFilename,\n diff: variantDiffOverride,\n captureStart: variantStart,\n },\n );\n\n variantResult.filepath = variantCaptureResult.filepath;\n variantResult.comparisonResult = variantCaptureResult.comparisonResult;\n variantResult.diffImagePath = variantCaptureResult.diffImagePath;\n variantResult.skipped = variantCaptureResult.skipped;\n\n variantResults.push(variantResult);\n }\n\n return {\n base: baseResult,\n variants: variantResults,\n };\n }\n\n /**\n * Gets the exponential backoff delay\n */\n getIncBackoffDelay(i: number, delay: number): number {\n return i > 0 ? 500 * 2 ** (i - 1) + (delay || 0) : 0;\n }\n\n /**\n * Get a page from the pool by index\n */\n getPageFromPool(index: number): Page {\n if (index < 0) {\n throw new Error(`Page index ${index} must be non-negative`);\n }\n\n if (index >= this.pages.length) {\n throw new Error(\n `Page index ${index} exceeds pool size ${this.pages.length}`,\n );\n }\n\n if (!this.pages[index]) {\n throw new Error(`Page index ${index} is undefined`);\n }\n\n return this.pages[index];\n }\n}\n\nexport default ScreenshotTool;\n"],"mappings":"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"}
package/dist/index.d.cts CHANGED
@@ -1,5 +1,7 @@
1
+ import { ChangeRegion, InterpretResult, InterpretResult as InterpretResult$1 } from "@blazediff/core-native";
1
2
  import { Browser, BrowserContext, Locator, Page } from "playwright-core";
2
3
  import { Logger } from "@cappa/logger";
4
+
3
5
  //#region src/compare/pixel.d.ts
4
6
  interface CompareResult$1 {
5
7
  numDiffPixels: number;
@@ -9,6 +11,7 @@ interface CompareResult$1 {
9
11
  passed: boolean;
10
12
  error?: string;
11
13
  differentSizes: boolean;
14
+ interpretation?: InterpretResult$1;
12
15
  }
13
16
  /**
14
17
  * Compare two PNG images and return the difference
@@ -29,6 +32,15 @@ declare function compareImages(image1: string | Buffer, image2: string | Buffer,
29
32
  declare function imagesMatch(image1: string | Buffer, image2: string | Buffer, options?: DiffConfig): Promise<boolean>;
30
33
  //#endregion
31
34
  //#region src/filesystem.d.ts
35
+ /**
36
+ * Map a diff image path to its sidecar metadata path (`.png` -> `.json`).
37
+ */
38
+ declare function toDiffMetaPath(diffImagePath: string): string;
39
+ /**
40
+ * Read a diff metadata sidecar, returning `undefined` when it is missing or
41
+ * cannot be parsed (so callers can degrade gracefully).
42
+ */
43
+ declare function readDiffMeta(diffImagePath: string): Promise<DiffMetadata | undefined>;
32
44
  /**
33
45
  * Class for interacting with the local file system to store the screenshots.
34
46
  */
@@ -121,6 +133,14 @@ declare class ScreenshotFileSystem {
121
133
  * Write a file to the diff directory
122
134
  */
123
135
  writeDiffFile(filename: string, data: Buffer): Promise<void>;
136
+ /**
137
+ * Get the path to a diff metadata sidecar file (`<name>.json`)
138
+ */
139
+ getDiffMetaFilePath(filename: string): string;
140
+ /**
141
+ * Write a diff metadata sidecar (`diff/<name>.json`) next to the diff image.
142
+ */
143
+ writeDiffMetaFile(filename: string, meta: DiffMetadata): Promise<void>;
124
144
  /**
125
145
  * Check if an expected file exists
126
146
  */
@@ -250,7 +270,7 @@ declare class ScreenshotTool {
250
270
  * Takes a screenshot and returns the buffer (for comparison purposes)
251
271
  */
252
272
  takeScreenshotBuffer(page: Page, options: ScreenshotSettings): Promise<Buffer>;
253
- takeScreenshotWithComparison(page: Page, filename: string, referenceImage: Buffer, options: ScreenshotSettings & {
273
+ takeScreenshotWithComparison(page: Page, filename: string, referenceImage: string | Buffer, options: ScreenshotSettings & {
254
274
  saveDiffImage?: boolean;
255
275
  diffImageFilename?: string;
256
276
  }, diffOverride?: DiffOptions): Promise<{
@@ -258,7 +278,7 @@ declare class ScreenshotTool {
258
278
  comparisonResult: CompareResult$1 | CompareResult;
259
279
  diffImagePath?: string;
260
280
  }>;
261
- retryScreenshot(page: Page, referenceImage: Buffer, options: ScreenshotSettings, diffOverride?: DiffOptions): Promise<{
281
+ retryScreenshot(page: Page, referenceImage: string | Buffer, options: ScreenshotSettings, diffOverride?: DiffOptions): Promise<{
262
282
  screenshotPath: Buffer<ArrayBufferLike>;
263
283
  comparisonResult: CompareResult | CompareResult$1;
264
284
  passed: boolean;
@@ -381,6 +401,15 @@ interface DiffConfig {
381
401
  * this can mean that small changes still slip through.
382
402
  */
383
403
  maxDiffPercentage?: number;
404
+ /**
405
+ * Run structured interpretation after the raw pixel diff.
406
+ * Default = false
407
+ *
408
+ * When enabled, changed screenshots get a `diff/<name>.json` sidecar describing
409
+ * *what* changed (additions, deletions, color shifts) grouped into regions, with a
410
+ * human-readable summary and severity. Pixel diff only — ignored when `type: 'gmsd'`.
411
+ */
412
+ interpret?: boolean;
384
413
  }
385
414
  /**
386
415
  * Configuration for the comparison of images using GMSD
@@ -533,11 +562,29 @@ type DeletedScreenshot = {
533
562
  category: "deleted";
534
563
  expectedPath: string;
535
564
  };
565
+ /**
566
+ * Pixel-diff statistics and optional structured interpretation for a changed
567
+ * screenshot. Persisted as a `diff/<name>.json` sidecar next to the diff image
568
+ * and read back when the review UI / CLI rebuild state from disk.
569
+ */
570
+ interface DiffMetadata {
571
+ /** Number of differing pixels reported by the pixel diff. */
572
+ numDiffPixels: number;
573
+ /** Percentage of differing pixels (0-100). */
574
+ percentDifference: number;
575
+ /** Structured interpretation, present only when `diff.interpret` is enabled. */
576
+ interpretation?: InterpretResult$1;
577
+ }
536
578
  type ChangedScreenshot = {
537
579
  category: "changed";
538
580
  diffPath: string;
539
581
  actualPath: string;
540
582
  expectedPath: string;
583
+ /**
584
+ * Diff statistics and optional interpretation loaded from the
585
+ * `diff/<name>.json` sidecar. Absent if the sidecar was not written.
586
+ */
587
+ diffMeta?: DiffMetadata;
541
588
  };
542
589
  type PassedScreenshot = {
543
590
  category: "passed";
@@ -595,5 +642,13 @@ declare function imagesMatchGMSD(image1: string | Buffer, image2: string | Buffe
595
642
  */
596
643
  declare function defineConfig(options: PossiblePromise<UserConfig> | ((env: ConfigEnv) => PossiblePromise<UserConfig>)): typeof options;
597
644
  //#endregion
598
- export { type ChangedScreenshot, type ConfigEnv, type DeletedScreenshot, type DiffConfig, type DiffConfigGMSD, type DiffOptions, type DiffOptionsGMSD, type DiffOptionsPixel, type FailedScreenshot, type NewScreenshot, type PassedScreenshot, type Plugin, type PluginDef, type PluginFunction, type Screenshot, type ScreenshotCaptureDetails, type ScreenshotCaptureExtras, type ScreenshotCaptureResult, ScreenshotFileSystem, type ScreenshotOptions, type ScreenshotSettings, ScreenshotTool, type ScreenshotVariant, type ScreenshotVariantCaptureDetails, type ScreenshotVariantWithUrl, type UserConfig, type Viewport, compareImages, compareImagesGMSD, defineConfig, imagesMatch, imagesMatchGMSD };
645
+ //#region src/mapWithConcurrency.d.ts
646
+ /**
647
+ * Run async work over `items` with at most `concurrency` tasks in flight.
648
+ * Preserves failure behavior: the first rejection rejects the returned promise.
649
+ * Results are returned in the same order as the input items.
650
+ */
651
+ declare function mapWithConcurrency<T, R = void>(concurrency: number, items: readonly T[], fn: (item: T, workerIndex: number) => Promise<R>): Promise<R[]>;
652
+ //#endregion
653
+ export { type ChangeRegion, type ChangedScreenshot, type ConfigEnv, type DeletedScreenshot, type DiffConfig, type DiffConfigGMSD, type DiffMetadata, type DiffOptions, type DiffOptionsGMSD, type DiffOptionsPixel, type FailedScreenshot, type InterpretResult, type NewScreenshot, type PassedScreenshot, type Plugin, type PluginDef, type PluginFunction, type Screenshot, type ScreenshotCaptureDetails, type ScreenshotCaptureExtras, type ScreenshotCaptureResult, ScreenshotFileSystem, type ScreenshotOptions, type ScreenshotSettings, ScreenshotTool, type ScreenshotVariant, type ScreenshotVariantCaptureDetails, type ScreenshotVariantWithUrl, type UserConfig, type Viewport, compareImages, compareImagesGMSD, defineConfig, imagesMatch, imagesMatchGMSD, mapWithConcurrency, readDiffMeta, toDiffMetaPath };
599
654
  //# sourceMappingURL=index.d.cts.map