@cappa/core 0.12.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.
package/dist/index.cjs CHANGED
@@ -133,6 +133,28 @@ function injectTextMetadata(buffer, metadata) {
133
133
  buffer.subarray(iendChunk.offset)
134
134
  ]);
135
135
  }
136
+ function isValidPngSignature(buffer) {
137
+ if (buffer.length < pngSignature.length) return false;
138
+ return buffer.subarray(0, pngSignature.length).equals(pngSignature);
139
+ }
140
+ const IHDR_MIN_BYTES = 24;
141
+ async function readIhdrDimensions(source) {
142
+ let buf;
143
+ if (typeof source === "string") {
144
+ const fh = await (0, node_fs_promises.open)(source, "r");
145
+ try {
146
+ buf = Buffer.alloc(IHDR_MIN_BYTES);
147
+ await fh.read(buf, 0, IHDR_MIN_BYTES, 0);
148
+ } finally {
149
+ await fh.close();
150
+ }
151
+ } else buf = source;
152
+ if (buf.length < IHDR_MIN_BYTES || !buf.subarray(0, pngSignature.length).equals(pngSignature)) throw new Error("Not a valid PNG");
153
+ return {
154
+ width: buf.readUInt32BE(16),
155
+ height: buf.readUInt32BE(20)
156
+ };
157
+ }
136
158
  /**
137
159
  * Scans a raw PNG buffer and extracts key-value pairs from `tEXt` chunks.
138
160
  */
@@ -249,7 +271,7 @@ async function compareImagesGMSD(image1, image2, withDiff = false, options = {})
249
271
  });
250
272
  return {
251
273
  gmsd,
252
- diffBuffer: diff ? await annotateDiffImage$1(diff, options).toBuffer() : void 0,
274
+ diffBuffer: diff ? await annotateDiffImage(diff, options).toBuffer() : void 0,
253
275
  passed: gmsd <= (options.threshold ?? .1)
254
276
  };
255
277
  } catch (error) {
@@ -267,7 +289,7 @@ async function compareImagesGMSD(image1, image2, withDiff = false, options = {})
267
289
  async function loadPNG(source) {
268
290
  return PNG.load(source);
269
291
  }
270
- function annotateDiffImage$1(image, options) {
292
+ function annotateDiffImage(image, options) {
271
293
  image.setMetadata("cappa.diff.algorithm", "gmsd");
272
294
  for (const [key, value] of Object.entries(options)) {
273
295
  if (value === void 0) continue;
@@ -296,7 +318,7 @@ async function resolveInputPath(source, fileName, state) {
296
318
  await node_fs_promises.default.access(source, node_fs.default.constants.R_OK);
297
319
  return node_path.default.resolve(source);
298
320
  }
299
- await PNG.load(source);
321
+ if (!isValidPngSignature(source)) throw new Error("Invalid PNG buffer: missing PNG signature");
300
322
  const root = await ensureTempRoot(state);
301
323
  const dest = node_path.default.join(root, fileName);
302
324
  await node_fs_promises.default.writeFile(dest, source);
@@ -356,7 +378,7 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
356
378
  differentSizes: true
357
379
  };
358
380
  }
359
- const { width, height } = await PNG.load(p1);
381
+ const { width, height } = await readIhdrDimensions(p1);
360
382
  const totalPixels = width * height;
361
383
  if (nativeResult.match) return {
362
384
  numDiffPixels: 0,
@@ -368,8 +390,10 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
368
390
  };
369
391
  let diffBuffer;
370
392
  if (withDiff && diffPath) {
371
- const raw = await node_fs_promises.default.readFile(diffPath);
372
- diffBuffer = await annotateDiffImage(await PNG.load(raw), options).toBuffer();
393
+ const rawDiff = await node_fs_promises.default.readFile(diffPath);
394
+ const diffMetadata = { "cappa.diff.algorithm": "pixel" };
395
+ for (const [key, value] of Object.entries(options)) if (value !== void 0) diffMetadata[`cappa.diff.${key}`] = String(value);
396
+ diffBuffer = injectTextMetadata(rawDiff, diffMetadata);
373
397
  }
374
398
  const numDiffPixels = nativeResult.diffCount;
375
399
  const percentDifference = nativeResult.diffPercentage;
@@ -389,14 +413,6 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
389
413
  }).catch(() => {});
390
414
  }
391
415
  }
392
- function annotateDiffImage(image, options) {
393
- image.setMetadata("cappa.diff.algorithm", "pixel");
394
- for (const [key, value] of Object.entries(options)) {
395
- if (value === void 0) continue;
396
- image.setMetadata(`cappa.diff.${key}`, String(value));
397
- }
398
- return image;
399
- }
400
416
  /**
401
417
  * Quick comparison function that returns only pass/fail
402
418
  * @param image1 - First image (file path or Buffer)
@@ -448,21 +464,24 @@ function defineConfig(options) {
448
464
  /**
449
465
  * Run async work over `items` with at most `concurrency` tasks in flight.
450
466
  * Preserves failure behavior: the first rejection rejects the returned promise.
467
+ * Results are returned in the same order as the input items.
451
468
  */
452
469
  async function mapWithConcurrency(concurrency, items, fn) {
453
- if (items.length === 0) return;
470
+ if (items.length === 0) return [];
454
471
  const workerCount = Math.min(Math.max(1, concurrency), items.length);
472
+ const results = new Array(items.length);
455
473
  let next = 0;
456
- const worker = async () => {
474
+ const worker = async (workerIndex) => {
457
475
  while (true) {
458
476
  const i = next++;
459
477
  if (i >= items.length) return;
460
478
  const item = items[i];
461
479
  if (item === void 0) return;
462
- await fn(item);
480
+ results[i] = await fn(item, workerIndex);
463
481
  }
464
482
  };
465
- await Promise.all(Array.from({ length: workerCount }, () => worker()));
483
+ await Promise.all(Array.from({ length: workerCount }, (_, i) => worker(i)));
484
+ return results;
466
485
  }
467
486
  //#endregion
468
487
  //#region src/filesystem.ts
@@ -1059,7 +1078,7 @@ var ScreenshotTool = class {
1059
1078
  this.logger.debug(`Expected image not found for ${filename}, taking screenshot`);
1060
1079
  result.filepath = await this.takeScreenshot(page, filename, options);
1061
1080
  } else {
1062
- const { screenshotPath, comparisonResult, diffImagePath } = await this.takeScreenshotWithComparison(page, filename, await this.filesystem.readExpectedFile(filename), {
1081
+ const { screenshotPath, comparisonResult, diffImagePath } = await this.takeScreenshotWithComparison(page, filename, this.filesystem.getExpectedFilePath(filename), {
1063
1082
  ...options,
1064
1083
  saveDiffImage: saveDiff,
1065
1084
  diffImageFilename: diffFilename
@@ -1258,6 +1277,7 @@ exports.compareImagesGMSD = compareImagesGMSD;
1258
1277
  exports.defineConfig = defineConfig;
1259
1278
  exports.imagesMatch = imagesMatch;
1260
1279
  exports.imagesMatchGMSD = imagesMatchGMSD;
1280
+ exports.mapWithConcurrency = mapWithConcurrency;
1261
1281
  exports.readDiffMeta = readDiffMeta;
1262
1282
  exports.toDiffMetaPath = toDiffMetaPath;
1263
1283
 
@@ -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 type InterpretResult,\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 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 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(\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 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 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\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 {\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: 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: 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
@@ -270,7 +270,7 @@ declare class ScreenshotTool {
270
270
  * Takes a screenshot and returns the buffer (for comparison purposes)
271
271
  */
272
272
  takeScreenshotBuffer(page: Page, options: ScreenshotSettings): Promise<Buffer>;
273
- takeScreenshotWithComparison(page: Page, filename: string, referenceImage: Buffer, options: ScreenshotSettings & {
273
+ takeScreenshotWithComparison(page: Page, filename: string, referenceImage: string | Buffer, options: ScreenshotSettings & {
274
274
  saveDiffImage?: boolean;
275
275
  diffImageFilename?: string;
276
276
  }, diffOverride?: DiffOptions): Promise<{
@@ -278,7 +278,7 @@ declare class ScreenshotTool {
278
278
  comparisonResult: CompareResult$1 | CompareResult;
279
279
  diffImagePath?: string;
280
280
  }>;
281
- retryScreenshot(page: Page, referenceImage: Buffer, options: ScreenshotSettings, diffOverride?: DiffOptions): Promise<{
281
+ retryScreenshot(page: Page, referenceImage: string | Buffer, options: ScreenshotSettings, diffOverride?: DiffOptions): Promise<{
282
282
  screenshotPath: Buffer<ArrayBufferLike>;
283
283
  comparisonResult: CompareResult | CompareResult$1;
284
284
  passed: boolean;
@@ -642,5 +642,13 @@ declare function imagesMatchGMSD(image1: string | Buffer, image2: string | Buffe
642
642
  */
643
643
  declare function defineConfig(options: PossiblePromise<UserConfig> | ((env: ConfigEnv) => PossiblePromise<UserConfig>)): typeof options;
644
644
  //#endregion
645
- 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, readDiffMeta, toDiffMetaPath };
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 };
646
654
  //# sourceMappingURL=index.d.cts.map
package/dist/index.d.mts CHANGED
@@ -270,7 +270,7 @@ declare class ScreenshotTool {
270
270
  * Takes a screenshot and returns the buffer (for comparison purposes)
271
271
  */
272
272
  takeScreenshotBuffer(page: Page, options: ScreenshotSettings): Promise<Buffer>;
273
- takeScreenshotWithComparison(page: Page, filename: string, referenceImage: Buffer, options: ScreenshotSettings & {
273
+ takeScreenshotWithComparison(page: Page, filename: string, referenceImage: string | Buffer, options: ScreenshotSettings & {
274
274
  saveDiffImage?: boolean;
275
275
  diffImageFilename?: string;
276
276
  }, diffOverride?: DiffOptions): Promise<{
@@ -278,7 +278,7 @@ declare class ScreenshotTool {
278
278
  comparisonResult: CompareResult$1 | CompareResult;
279
279
  diffImagePath?: string;
280
280
  }>;
281
- retryScreenshot(page: Page, referenceImage: Buffer, options: ScreenshotSettings, diffOverride?: DiffOptions): Promise<{
281
+ retryScreenshot(page: Page, referenceImage: string | Buffer, options: ScreenshotSettings, diffOverride?: DiffOptions): Promise<{
282
282
  screenshotPath: Buffer<ArrayBufferLike>;
283
283
  comparisonResult: CompareResult | CompareResult$1;
284
284
  passed: boolean;
@@ -642,5 +642,13 @@ declare function imagesMatchGMSD(image1: string | Buffer, image2: string | Buffe
642
642
  */
643
643
  declare function defineConfig(options: PossiblePromise<UserConfig> | ((env: ConfigEnv) => PossiblePromise<UserConfig>)): typeof options;
644
644
  //#endregion
645
- 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, readDiffMeta, toDiffMetaPath };
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 };
646
654
  //# sourceMappingURL=index.d.mts.map
package/dist/index.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
  import fs from "node:fs";
2
2
  import gmsd from "@blazediff/gmsd";
3
3
  import { getLogger } from "@cappa/logger";
4
- import fsp, { glob, readFile, writeFile } from "node:fs/promises";
4
+ import fsp, { glob, open, readFile, writeFile } from "node:fs/promises";
5
5
  import sharp from "sharp";
6
6
  import os from "node:os";
7
7
  import path from "node:path";
@@ -104,6 +104,28 @@ function injectTextMetadata(buffer, metadata) {
104
104
  buffer.subarray(iendChunk.offset)
105
105
  ]);
106
106
  }
107
+ function isValidPngSignature(buffer) {
108
+ if (buffer.length < pngSignature.length) return false;
109
+ return buffer.subarray(0, pngSignature.length).equals(pngSignature);
110
+ }
111
+ const IHDR_MIN_BYTES = 24;
112
+ async function readIhdrDimensions(source) {
113
+ let buf;
114
+ if (typeof source === "string") {
115
+ const fh = await open(source, "r");
116
+ try {
117
+ buf = Buffer.alloc(IHDR_MIN_BYTES);
118
+ await fh.read(buf, 0, IHDR_MIN_BYTES, 0);
119
+ } finally {
120
+ await fh.close();
121
+ }
122
+ } else buf = source;
123
+ if (buf.length < IHDR_MIN_BYTES || !buf.subarray(0, pngSignature.length).equals(pngSignature)) throw new Error("Not a valid PNG");
124
+ return {
125
+ width: buf.readUInt32BE(16),
126
+ height: buf.readUInt32BE(20)
127
+ };
128
+ }
107
129
  /**
108
130
  * Scans a raw PNG buffer and extracts key-value pairs from `tEXt` chunks.
109
131
  */
@@ -220,7 +242,7 @@ async function compareImagesGMSD(image1, image2, withDiff = false, options = {})
220
242
  });
221
243
  return {
222
244
  gmsd,
223
- diffBuffer: diff ? await annotateDiffImage$1(diff, options).toBuffer() : void 0,
245
+ diffBuffer: diff ? await annotateDiffImage(diff, options).toBuffer() : void 0,
224
246
  passed: gmsd <= (options.threshold ?? .1)
225
247
  };
226
248
  } catch (error) {
@@ -238,7 +260,7 @@ async function compareImagesGMSD(image1, image2, withDiff = false, options = {})
238
260
  async function loadPNG(source) {
239
261
  return PNG.load(source);
240
262
  }
241
- function annotateDiffImage$1(image, options) {
263
+ function annotateDiffImage(image, options) {
242
264
  image.setMetadata("cappa.diff.algorithm", "gmsd");
243
265
  for (const [key, value] of Object.entries(options)) {
244
266
  if (value === void 0) continue;
@@ -267,7 +289,7 @@ async function resolveInputPath(source, fileName, state) {
267
289
  await fsp.access(source, fs.constants.R_OK);
268
290
  return path.resolve(source);
269
291
  }
270
- await PNG.load(source);
292
+ if (!isValidPngSignature(source)) throw new Error("Invalid PNG buffer: missing PNG signature");
271
293
  const root = await ensureTempRoot(state);
272
294
  const dest = path.join(root, fileName);
273
295
  await fsp.writeFile(dest, source);
@@ -327,7 +349,7 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
327
349
  differentSizes: true
328
350
  };
329
351
  }
330
- const { width, height } = await PNG.load(p1);
352
+ const { width, height } = await readIhdrDimensions(p1);
331
353
  const totalPixels = width * height;
332
354
  if (nativeResult.match) return {
333
355
  numDiffPixels: 0,
@@ -339,8 +361,10 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
339
361
  };
340
362
  let diffBuffer;
341
363
  if (withDiff && diffPath) {
342
- const raw = await fsp.readFile(diffPath);
343
- diffBuffer = await annotateDiffImage(await PNG.load(raw), options).toBuffer();
364
+ const rawDiff = await fsp.readFile(diffPath);
365
+ const diffMetadata = { "cappa.diff.algorithm": "pixel" };
366
+ for (const [key, value] of Object.entries(options)) if (value !== void 0) diffMetadata[`cappa.diff.${key}`] = String(value);
367
+ diffBuffer = injectTextMetadata(rawDiff, diffMetadata);
344
368
  }
345
369
  const numDiffPixels = nativeResult.diffCount;
346
370
  const percentDifference = nativeResult.diffPercentage;
@@ -360,14 +384,6 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
360
384
  }).catch(() => {});
361
385
  }
362
386
  }
363
- function annotateDiffImage(image, options) {
364
- image.setMetadata("cappa.diff.algorithm", "pixel");
365
- for (const [key, value] of Object.entries(options)) {
366
- if (value === void 0) continue;
367
- image.setMetadata(`cappa.diff.${key}`, String(value));
368
- }
369
- return image;
370
- }
371
387
  /**
372
388
  * Quick comparison function that returns only pass/fail
373
389
  * @param image1 - First image (file path or Buffer)
@@ -419,21 +435,24 @@ function defineConfig(options) {
419
435
  /**
420
436
  * Run async work over `items` with at most `concurrency` tasks in flight.
421
437
  * Preserves failure behavior: the first rejection rejects the returned promise.
438
+ * Results are returned in the same order as the input items.
422
439
  */
423
440
  async function mapWithConcurrency(concurrency, items, fn) {
424
- if (items.length === 0) return;
441
+ if (items.length === 0) return [];
425
442
  const workerCount = Math.min(Math.max(1, concurrency), items.length);
443
+ const results = new Array(items.length);
426
444
  let next = 0;
427
- const worker = async () => {
445
+ const worker = async (workerIndex) => {
428
446
  while (true) {
429
447
  const i = next++;
430
448
  if (i >= items.length) return;
431
449
  const item = items[i];
432
450
  if (item === void 0) return;
433
- await fn(item);
451
+ results[i] = await fn(item, workerIndex);
434
452
  }
435
453
  };
436
- await Promise.all(Array.from({ length: workerCount }, () => worker()));
454
+ await Promise.all(Array.from({ length: workerCount }, (_, i) => worker(i)));
455
+ return results;
437
456
  }
438
457
  //#endregion
439
458
  //#region src/filesystem.ts
@@ -1030,7 +1049,7 @@ var ScreenshotTool = class {
1030
1049
  this.logger.debug(`Expected image not found for ${filename}, taking screenshot`);
1031
1050
  result.filepath = await this.takeScreenshot(page, filename, options);
1032
1051
  } else {
1033
- const { screenshotPath, comparisonResult, diffImagePath } = await this.takeScreenshotWithComparison(page, filename, await this.filesystem.readExpectedFile(filename), {
1052
+ const { screenshotPath, comparisonResult, diffImagePath } = await this.takeScreenshotWithComparison(page, filename, this.filesystem.getExpectedFilePath(filename), {
1034
1053
  ...options,
1035
1054
  saveDiffImage: saveDiff,
1036
1055
  diffImageFilename: diffFilename
@@ -1222,6 +1241,6 @@ var ScreenshotTool = class {
1222
1241
  }
1223
1242
  };
1224
1243
  //#endregion
1225
- export { ScreenshotFileSystem, ScreenshotTool, compareImages, compareImagesGMSD, defineConfig, imagesMatch, imagesMatchGMSD, readDiffMeta, toDiffMetaPath };
1244
+ export { ScreenshotFileSystem, ScreenshotTool, compareImages, compareImagesGMSD, defineConfig, imagesMatch, imagesMatchGMSD, mapWithConcurrency, readDiffMeta, toDiffMetaPath };
1226
1245
 
1227
1246
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["compare","annotateDiffImage","blazediffCompare"],"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 type InterpretResult,\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 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 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(\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 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 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\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 {\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: 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: 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.mjs","names":["compare","blazediffCompare"],"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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cappa/core",
3
- "version": "0.12.0",
3
+ "version": "0.12.1",
4
4
  "description": "Core Playwright screenshot functionality for Cappa",
5
5
  "author": "Tim Richter",
6
6
  "repository": {