@cappa/core 0.7.1 → 0.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -28,7 +28,8 @@ _blazediff_gmsd = __toESM(_blazediff_gmsd);
28
28
  let _cappa_logger = require("@cappa/logger");
29
29
  let node_fs_promises = require("node:fs/promises");
30
30
  node_fs_promises = __toESM(node_fs_promises);
31
- let pngjs = require("pngjs");
31
+ let sharp = require("sharp");
32
+ sharp = __toESM(sharp);
32
33
  let _blazediff_core = require("@blazediff/core");
33
34
  _blazediff_core = __toESM(_blazediff_core);
34
35
  let node_path = require("node:path");
@@ -149,38 +150,41 @@ function extractTextMetadata(buffer) {
149
150
  //#endregion
150
151
  //#region src/features/png/png.ts
151
152
  /**
152
- * A wrapper around `pngjs` that adds support for reading and writing
153
- * textual metadata (tEXt chunks).
153
+ * A wrapper around `sharp` that adds support for reading and writing
154
+ * textual metadata (tEXt chunks). Used for fast PNG decode/encode.
154
155
  */
155
156
  var PNG = class PNG {
156
- image;
157
+ width_;
158
+ height_;
159
+ data_;
157
160
  sourcePath;
158
161
  metadataEntries;
159
- constructor(image, sourcePath, metadata) {
160
- this.image = image;
162
+ constructor(width, height, data, sourcePath, metadata) {
163
+ this.width_ = width;
164
+ this.height_ = height;
165
+ this.data_ = data;
161
166
  this.sourcePath = sourcePath;
162
167
  this.metadataEntries = { ...metadata ?? {} };
163
168
  }
164
169
  static create(width, height) {
165
- return new PNG(new pngjs.PNG({
166
- width,
167
- height
168
- }));
170
+ return new PNG(width, height, Buffer.alloc(width * height * 4, 0));
169
171
  }
170
172
  static async load(source) {
171
173
  const buffer = typeof source === "string" ? await (0, node_fs_promises.readFile)(source) : source;
172
- const png = pngjs.PNG.sync.read(buffer);
173
174
  const metadata = extractTextMetadata(buffer);
174
- return new PNG(png, typeof source === "string" ? source : void 0, metadata);
175
+ const { data: raw, info } = await (0, sharp.default)(buffer).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
176
+ const data = Buffer.from(raw);
177
+ const sourcePath = typeof source === "string" ? source : void 0;
178
+ return new PNG(info.width, info.height, data, sourcePath, metadata);
175
179
  }
176
180
  get width() {
177
- return this.image.width;
181
+ return this.width_;
178
182
  }
179
183
  get height() {
180
- return this.image.height;
184
+ return this.height_;
181
185
  }
182
186
  get data() {
183
- return this.image.data;
187
+ return this.data_;
184
188
  }
185
189
  get metadata() {
186
190
  return { ...this.metadataEntries };
@@ -201,15 +205,19 @@ var PNG = class PNG {
201
205
  clearMetadata() {
202
206
  this.metadataEntries = {};
203
207
  }
204
- toBuffer(options) {
205
- const baseBuffer = pngjs.PNG.sync.write(this.image, options);
208
+ async toBuffer() {
209
+ const baseBuffer = await (0, sharp.default)(this.data_, { raw: {
210
+ width: this.width_,
211
+ height: this.height_,
212
+ channels: 4
213
+ } }).png().toBuffer();
206
214
  if (Object.keys(this.metadataEntries).length === 0) return baseBuffer;
207
215
  return injectTextMetadata(baseBuffer, this.metadataEntries);
208
216
  }
209
- async save(filepath, options) {
217
+ async save(filepath) {
210
218
  const targetPath = filepath ?? this.sourcePath;
211
219
  if (!targetPath) throw new Error("No filepath provided for saving PNG");
212
- await (0, node_fs_promises.writeFile)(targetPath, this.toBuffer(options));
220
+ await (0, node_fs_promises.writeFile)(targetPath, await this.toBuffer());
213
221
  }
214
222
  };
215
223
  //#endregion
@@ -240,7 +248,7 @@ async function compareImagesGMSD(image1, image2, withDiff = false, options = {})
240
248
  });
241
249
  return {
242
250
  gmsd,
243
- diffBuffer: diff ? annotateDiffImage$1(diff, options).toBuffer() : void 0,
251
+ diffBuffer: diff ? await annotateDiffImage$1(diff, options).toBuffer() : void 0,
244
252
  passed: gmsd <= (options.threshold ?? .1)
245
253
  };
246
254
  } catch (error) {
@@ -308,7 +316,7 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
308
316
  numDiffPixels,
309
317
  totalPixels,
310
318
  percentDifference,
311
- diffBuffer: diff ? annotateDiffImage(diff, options).toBuffer() : void 0,
319
+ diffBuffer: diff ? await annotateDiffImage(diff, options).toBuffer() : void 0,
312
320
  passed: isPassed(percentDifference, numDiffPixels, options),
313
321
  differentSizes: false
314
322
  };
@@ -365,7 +373,7 @@ const isPassed = (percentDifference, numDiffPixels, options) => {
365
373
  * Create different size png image with all pixels red
366
374
  * @returns
367
375
  */
368
- function createDiffSizePngImage(width, height) {
376
+ async function createDiffSizePngImage(width, height) {
369
377
  const png = PNG.create(width, height);
370
378
  for (let y = 0; y < height; y++) for (let x = 0; x < width; x++) {
371
379
  const idx = width * y + x << 2;
@@ -817,7 +825,7 @@ var ScreenshotTool = class {
817
825
  this.logger.warn(`Screenshot has different sizes than reference image`);
818
826
  const diffFilename = options.diffImageFilename || filename;
819
827
  diffImagePath = this.filesystem.getDiffFilePath(diffFilename);
820
- const diffBuffer = createDiffSizePngImage(200, 200);
828
+ const diffBuffer = await createDiffSizePngImage(200, 200);
821
829
  await this.filesystem.writeDiffFile(diffFilename, diffBuffer);
822
830
  this.logger.debug(`Diff Size image saved: ${diffImagePath}`);
823
831
  }
@@ -1013,7 +1021,7 @@ var ScreenshotTool = class {
1013
1021
  await page.goto(baseUrl);
1014
1022
  await this.applyScreenshotOptimizations(page);
1015
1023
  await extras.waitForStability?.(page);
1016
- }
1024
+ } else baseStart = performance.now();
1017
1025
  const baseCaptureResult = await this.captureSingleScreenshot(page, baseFilename, baseOptions, {
1018
1026
  saveDiffImage: baseSaveDiff,
1019
1027
  diffImageFilename: baseDiffFilename,
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["PngjsPNG","compare","loadPNG","annotateDiffImage","path","fs","fsp","path"],"sources":["../src/features/png/util.ts","../src/features/png/png.ts","../src/compare/gmsd.ts","../src/compare/pixel.ts","../src/config.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 { type PackerOptions, PNG as PngjsPNG } from \"pngjs\";\nimport type { MetadataEntries, PngWithMetadata } from \"./types\";\nimport { extractTextMetadata, injectTextMetadata } from \"./util\";\n\n/**\n * A wrapper around `pngjs` that adds support for reading and writing\n * textual metadata (tEXt chunks).\n */\nexport class PNG {\n private image: PngWithMetadata;\n private sourcePath?: string;\n private metadataEntries: MetadataEntries;\n\n private constructor(\n image: PngWithMetadata,\n sourcePath?: string,\n metadata?: MetadataEntries,\n ) {\n this.image = image;\n this.sourcePath = sourcePath;\n this.metadataEntries = { ...(metadata ?? {}) };\n }\n\n static create(width: number, height: number) {\n return new PNG(new PngjsPNG({ width, height }) as PngWithMetadata);\n }\n\n static async load(source: string | Buffer) {\n const buffer = typeof source === \"string\" ? await readFile(source) : source;\n const png = PngjsPNG.sync.read(buffer) as PngWithMetadata;\n\n const metadata = extractTextMetadata(buffer);\n\n return new PNG(\n png,\n typeof source === \"string\" ? source : undefined,\n metadata,\n );\n }\n\n get width() {\n return this.image.width;\n }\n\n get height() {\n return this.image.height;\n }\n\n get data() {\n return this.image.data;\n }\n\n get metadata(): MetadataEntries {\n return { ...this.metadataEntries };\n }\n\n setMetadata(key: string, value: string) {\n this.metadataEntries = { ...this.metadataEntries, [key]: value };\n }\n\n replaceMetadata(metadata: MetadataEntries) {\n this.metadataEntries = { ...metadata };\n }\n\n removeMetadata(key: string) {\n const { [key]: _, ...remaining } = this.metadataEntries;\n this.metadataEntries = remaining;\n }\n\n clearMetadata() {\n this.metadataEntries = {};\n }\n\n toBuffer(options?: PackerOptions) {\n const baseBuffer = PngjsPNG.sync.write(this.image, options);\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, options?: PackerOptions) {\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, this.toBuffer(options));\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 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 ? 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 blazediff, { type CoreOptions } from \"@blazediff/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { PNG } from \"../features/png/png\";\nimport type { DiffConfig } from \"../types\";\n\nexport type CompareOptions = CoreOptions;\n\nexport interface CompareResult {\n numDiffPixels: number;\n totalPixels: number;\n percentDifference: number;\n diffBuffer?: Buffer; // PNG buffer of the diff image\n passed: boolean; // Whether the comparison passed based on threshold\n error?: string; // Error message if the comparison failed\n differentSizes: boolean; // Whether the images have different sizes\n}\n\nconst compare = (\n image1: Uint8Array | Uint8ClampedArray,\n image2: Uint8Array | Uint8ClampedArray,\n diff: Uint8Array | Uint8ClampedArray | undefined,\n width: number,\n height: number,\n options?: CoreOptions,\n) => {\n return blazediff(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 compareImages(\n image1: string | Buffer,\n image2: string | Buffer,\n withDiff: boolean = false,\n options: DiffConfig = {},\n): Promise<CompareResult> {\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 {\n numDiffPixels: 0,\n totalPixels: 0,\n percentDifference: 0,\n passed: false,\n differentSizes: true,\n };\n }\n\n const diff = withDiff ? PNG.create(width, height) : undefined;\n\n try {\n const numDiffPixels = compare(\n png1.data,\n png2.data,\n diff?.data,\n width,\n height,\n options,\n );\n\n const totalPixels = width * height;\n const percentDifference = (numDiffPixels / totalPixels) * 100;\n\n // Convert diff image to buffer\n const diffBuffer = diff\n ? annotateDiffImage(diff, options).toBuffer()\n : undefined;\n\n return {\n numDiffPixels,\n totalPixels,\n percentDifference,\n diffBuffer,\n passed: isPassed(percentDifference, numDiffPixels, options),\n differentSizes: false,\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\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: 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 function createDiffSizePngImage(width: number, height: number): 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","import fs from \"node:fs\";\nimport fsp, { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { extractTextMetadata, injectTextMetadata } from \"./features/png/util\";\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 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 * 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 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 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 this.ensureParentDirSync(expectedPath);\n\n fs.copyFileSync(actualPath, expectedPath);\n\n if (fs.existsSync(diffPath)) {\n this.copyDiffMetadataToExpected(diffPath, expectedPath);\n fs.unlinkSync(diffPath);\n }\n\n return {\n actualPath,\n expectedPath,\n diffPath,\n };\n }\n\n private copyDiffMetadataToExpected(diffPath: string, expectedPath: string) {\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 = fs.readFileSync(diffPath);\n const diffMetadata = extractTextMetadata(diffBuffer);\n\n if (Object.keys(diffMetadata).length === 0) {\n return;\n }\n\n const expectedBuffer = fs.readFileSync(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 fs.writeFileSync(expectedPath, expectedWithMetadata);\n } catch {\n // Ignore metadata transfer errors to keep approval resilient.\n }\n }\n\n /**\n * Ensure the parent directory of a file exists. If not, it creates it.\n * @param filePath - The path to the file.\n */\n async ensureParentDir(filePath: string) {\n const dir = path.dirname(filePath);\n await fsp.mkdir(dir, { recursive: true });\n }\n\n /**\n * Synchronous version used only during constructor initialization.\n */\n private ensureParentDirSync(filePath: string) {\n const dir = path.dirname(filePath);\n\n if (!fs.existsSync(dir)) {\n fs.mkdirSync(dir, { recursive: true });\n }\n }\n\n /**\n * Remove a directory and all its contents.\n * @param dir - The path to the directory.\n */\n private removeDir(dir: string) {\n if (fs.existsSync(dir)) {\n fs.rmSync(dir, { recursive: true, force: true });\n }\n }\n\n /**\n * Get the actual directory path\n */\n getActualDir(): string {\n return this.actual;\n }\n\n /**\n * Get the expected directory path\n */\n getExpectedDir(): string {\n return this.expected;\n }\n\n /**\n * Get the diff directory path\n */\n getDiffDir(): string {\n return this.diff;\n }\n\n /**\n * Get the path to an actual screenshot file\n */\n getActualFilePath(filename: string): string {\n return path.resolve(this.actual, filename);\n }\n\n /**\n * Get the path to an expected screenshot file\n */\n getExpectedFilePath(filename: string): string {\n return path.resolve(this.expected, filename);\n }\n\n /**\n * Get the path to a diff screenshot file\n */\n getDiffFilePath(filename: string): string {\n return path.resolve(this.diff, filename);\n }\n\n /**\n * Write a file to the actual directory\n */\n async writeActualFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getActualFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Write a file to the diff directory\n */\n async writeDiffFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getDiffFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Check if an expected file exists\n */\n async hasExpectedFile(filename: string): Promise<boolean> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n await fsp.access(expectedPath);\n return true;\n } catch {\n return false;\n }\n }\n\n /**\n * Read an expected file\n */\n async readExpectedFile(filename: string): Promise<Buffer> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n return await fsp.readFile(expectedPath);\n } catch {\n throw new Error(`Expected image not found: ${expectedPath}`);\n }\n }\n\n /**\n * Resolve the actual path of a screenshot file.\n * @param filePath - The path to the screenshot file.\n * @returns The actual path of the screenshot file.\n */\n private resolveActualPath(filePath: string) {\n if (path.isAbsolute(filePath)) {\n return filePath;\n }\n\n return path.resolve(this.actual, filePath);\n }\n\n getRelativePath(directory: \"actual\" | \"expected\" | \"diff\", filePath: string) {\n const relativePath = path.relative(this[directory], filePath);\n\n if (relativePath.startsWith(\"..\")) {\n throw new Error(\n `Cannot resolve relative path outside of ${directory} directory: ${filePath}`,\n );\n }\n\n return relativePath;\n }\n}\n","import path from \"node:path\";\nimport { getLogger, type Logger } from \"@cappa/logger\";\nimport {\n type Browser,\n type BrowserContext,\n chromium,\n firefox,\n type Page,\n type PageScreenshotOptions,\n webkit,\n} from \"playwright-core\";\nimport {\n compareImagesGMSD,\n type CompareResult as GMSDCompareResult,\n} from \"./compare/gmsd\";\nimport {\n compareImages,\n createDiffSizePngImage,\n type CompareResult as PixelCompareResult,\n} from \"./compare/pixel\";\nimport { ScreenshotFileSystem } from \"./filesystem\";\nimport type {\n DiffConfig,\n DiffConfigGMSD,\n DiffOptions,\n DiffOptionsGMSD,\n DiffOptionsPixel,\n ScreenshotOptions,\n ScreenshotSettings,\n ScreenshotVariant,\n ScreenshotVariantWithUrl,\n} from \"./types\";\n\nconst defaultPixelDiffConfig: DiffOptionsPixel = {\n type: \"pixel\",\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n};\n\nconst defaultGMSDDiffConfig: DiffOptionsGMSD = {\n type: \"gmsd\",\n threshold: 0.1,\n downsample: 0,\n c: 170,\n};\n\nexport interface ScreenshotCaptureDetails {\n filename: string;\n filepath?: string;\n comparisonResult?: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n skipped?: boolean;\n}\n\nexport interface ScreenshotVariantCaptureDetails\n extends ScreenshotCaptureDetails {\n id: string;\n label?: string;\n}\n\nexport interface ScreenshotCaptureResult {\n base: ScreenshotCaptureDetails;\n variants: ScreenshotVariantCaptureDetails[];\n}\n\nexport interface ScreenshotCaptureExtras {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n variants?: Record<\n string,\n {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n }\n >;\n /**\n * Optional diff configuration override applied to this capture.\n * Merged on top of the global ScreenshotTool diff config.\n */\n diff?: DiffOptions;\n /**\n * Skip navigating to the base URL before capturing the base screenshot.\n * Use this when the page is already at the correct URL and in a stable state,\n * to avoid the redundant navigation.\n */\n skipBaseNavigation?: boolean;\n /**\n * Optional callback invoked after each navigation (variants only, or base when\n * skipBaseNavigation is false) to wait for visual stability before capturing.\n */\n waitForStability?: (page: Page) => Promise<void>;\n /**\n * Timestamp (from `performance.now()`) marking when the screenshot process\n * started — i.e. when the browser first navigated to the page. When provided,\n * the logged duration covers the full journey: navigation → stability waits →\n * capture. When omitted, timing begins at the capture step itself.\n */\n captureStart?: number;\n}\n\nclass ScreenshotTool {\n browserType: \"chromium\" | \"firefox\" | \"webkit\";\n headless: boolean;\n viewport: { width: number; height: number };\n fullPage: boolean;\n outputDir: string;\n browser: Browser | null = null;\n context: BrowserContext | null = null;\n page: Page | null = null;\n concurrency: number;\n contexts: BrowserContext[] = [];\n pages: Page[] = [];\n diff: DiffOptions;\n logger: Logger;\n retries: number;\n filesystem: ScreenshotFileSystem;\n logConsoleEvents: boolean;\n\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 }) {\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\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 this.browser = await browserClass.launch({\n headless: this.headless,\n });\n\n const tempCtx = await this.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 this.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, { waitUntil: \"domcontentloaded\" });\n }\n\n /**\n * Takes a screenshot of the page\n */\n async takeScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n ) {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n return;\n }\n\n try {\n // Generate filename - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n // Ensure parent directories exist before taking screenshot\n await this.filesystem.ensureParentDir(filepath);\n\n // Take screenshot\n const screenshotOptions = {\n path: filepath,\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n await this.withViewport(page, options.viewport, async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n await page.screenshot(screenshotOptions);\n });\n\n this.logger.success(`Screenshot saved: ${filepath}`);\n\n return filepath;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n /**\n * Sets the viewport size and executes the action, ensuring the original viewport is restored\n * even if the action throws an error.\n */\n private async withViewport<T>(\n page: Page,\n viewport: ScreenshotSettings[\"viewport\"],\n action: () => Promise<T>,\n ): Promise<T> {\n if (!viewport) {\n return action();\n }\n\n const previousViewport = page.viewportSize();\n\n // Check if the new viewport is the same as the current one\n if (\n previousViewport &&\n previousViewport.width === viewport.width &&\n previousViewport.height === viewport.height\n ) {\n return action();\n }\n\n await page.setViewportSize(viewport);\n\n try {\n return await action();\n } finally {\n // Always restore the original viewport, even if the action throws an error\n if (previousViewport) {\n await page.setViewportSize(previousViewport);\n }\n }\n }\n\n /**\n * Takes a screenshot and returns the buffer (for comparison purposes)\n */\n async takeScreenshotBuffer(\n page: Page,\n options: ScreenshotSettings,\n ): Promise<Buffer> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n throw new Error(\"Screenshot skipped\");\n }\n\n try {\n // Take screenshot without saving to file\n const screenshotOptions = {\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n const buffer = await this.withViewport(\n page,\n options.viewport,\n async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n return page.screenshot(screenshotOptions);\n },\n );\n\n return buffer;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async takeScreenshotWithComparison(\n page: Page,\n filename: string,\n referenceImage: Buffer,\n options: ScreenshotSettings & {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n },\n diffOverride?: DiffOptions,\n ): Promise<{\n screenshotPath: string;\n comparisonResult: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n }> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n try {\n // Generate filename and take screenshot - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n const screenshotSettings: ScreenshotSettings = {\n fullPage: options.fullPage ?? this.fullPage,\n mask: options.mask,\n omitBackground: options.omitBackground,\n delay: options.delay,\n viewport: options.viewport,\n };\n\n const retryScreenshot = await this.retryScreenshot(\n page,\n referenceImage,\n screenshotSettings,\n diffOverride,\n );\n\n if (!retryScreenshot.screenshotPath) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n // Save screenshot to actual directory\n await this.filesystem.writeActualFile(\n filename,\n retryScreenshot.screenshotPath,\n );\n this.logger.debug(`Actual screenshot saved: ${filepath}`);\n\n if (retryScreenshot.passed) {\n this.logger.success(`Screenshot passed visual comparison`);\n } else {\n this.logger.error(`Screenshot failed visual comparison`);\n }\n\n let diffImagePath: string | undefined;\n\n // Save diff image if requested and there are differences\n if (\n options.saveDiffImage &&\n retryScreenshot.comparisonResult?.diffBuffer &&\n !retryScreenshot.passed\n ) {\n const diffFilename = options.diffImageFilename || filename;\n // Save to diff directory\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n\n await this.filesystem.writeDiffFile(\n diffFilename,\n retryScreenshot.comparisonResult.diffBuffer,\n );\n\n this.logger.debug(`Diff image saved: ${diffImagePath}`);\n }\n\n // different sizes diff image\n if (\n retryScreenshot.comparisonResult !== null &&\n typeof retryScreenshot.comparisonResult === \"object\" &&\n \"differentSizes\" in retryScreenshot.comparisonResult &&\n retryScreenshot.comparisonResult.differentSizes\n ) {\n this.logger.warn(`Screenshot has different sizes than reference image`);\n\n const diffFilename = options.diffImageFilename || filename;\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n const diffBuffer = 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);\n await this.applyScreenshotOptimizations(page);\n await extras.waitForStability?.(page);\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);\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":["compare","loadPNG","annotateDiffImage","path","fs","fsp","path"],"sources":["../src/features/png/util.ts","../src/features/png/png.ts","../src/compare/gmsd.ts","../src/compare/pixel.ts","../src/config.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 blazediff, { type CoreOptions } from \"@blazediff/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { PNG } from \"../features/png/png\";\nimport type { DiffConfig } from \"../types\";\n\nexport type CompareOptions = CoreOptions;\n\nexport interface CompareResult {\n numDiffPixels: number;\n totalPixels: number;\n percentDifference: number;\n diffBuffer?: Buffer; // PNG buffer of the diff image\n passed: boolean; // Whether the comparison passed based on threshold\n error?: string; // Error message if the comparison failed\n differentSizes: boolean; // Whether the images have different sizes\n}\n\nconst compare = (\n image1: Uint8Array | Uint8ClampedArray,\n image2: Uint8Array | Uint8ClampedArray,\n diff: Uint8Array | Uint8ClampedArray | undefined,\n width: number,\n height: number,\n options?: CoreOptions,\n) => {\n return blazediff(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 compareImages(\n image1: string | Buffer,\n image2: string | Buffer,\n withDiff: boolean = false,\n options: DiffConfig = {},\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 {\n numDiffPixels: 0,\n totalPixels: 0,\n percentDifference: 0,\n passed: false,\n differentSizes: true,\n };\n }\n\n const diff = withDiff ? PNG.create(width, height) : undefined;\n\n try {\n const numDiffPixels = compare(\n png1.data,\n png2.data,\n diff?.data,\n width,\n height,\n options,\n );\n\n const totalPixels = width * height;\n const percentDifference = (numDiffPixels / totalPixels) * 100;\n\n // Convert diff image to buffer\n const diffBuffer = diff\n ? await annotateDiffImage(diff, options).toBuffer()\n : undefined;\n\n return {\n numDiffPixels,\n totalPixels,\n percentDifference,\n diffBuffer,\n passed: isPassed(percentDifference, numDiffPixels, options),\n differentSizes: false,\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\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: 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","import fs from \"node:fs\";\nimport fsp, { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { extractTextMetadata, injectTextMetadata } from \"./features/png/util\";\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 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 * 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 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 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 this.ensureParentDirSync(expectedPath);\n\n fs.copyFileSync(actualPath, expectedPath);\n\n if (fs.existsSync(diffPath)) {\n this.copyDiffMetadataToExpected(diffPath, expectedPath);\n fs.unlinkSync(diffPath);\n }\n\n return {\n actualPath,\n expectedPath,\n diffPath,\n };\n }\n\n private copyDiffMetadataToExpected(diffPath: string, expectedPath: string) {\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 = fs.readFileSync(diffPath);\n const diffMetadata = extractTextMetadata(diffBuffer);\n\n if (Object.keys(diffMetadata).length === 0) {\n return;\n }\n\n const expectedBuffer = fs.readFileSync(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 fs.writeFileSync(expectedPath, expectedWithMetadata);\n } catch {\n // Ignore metadata transfer errors to keep approval resilient.\n }\n }\n\n /**\n * Ensure the parent directory of a file exists. If not, it creates it.\n * @param filePath - The path to the file.\n */\n async ensureParentDir(filePath: string) {\n const dir = path.dirname(filePath);\n await fsp.mkdir(dir, { recursive: true });\n }\n\n /**\n * Synchronous version used only during constructor initialization.\n */\n private ensureParentDirSync(filePath: string) {\n const dir = path.dirname(filePath);\n\n if (!fs.existsSync(dir)) {\n fs.mkdirSync(dir, { recursive: true });\n }\n }\n\n /**\n * Remove a directory and all its contents.\n * @param dir - The path to the directory.\n */\n private removeDir(dir: string) {\n if (fs.existsSync(dir)) {\n fs.rmSync(dir, { recursive: true, force: true });\n }\n }\n\n /**\n * Get the actual directory path\n */\n getActualDir(): string {\n return this.actual;\n }\n\n /**\n * Get the expected directory path\n */\n getExpectedDir(): string {\n return this.expected;\n }\n\n /**\n * Get the diff directory path\n */\n getDiffDir(): string {\n return this.diff;\n }\n\n /**\n * Get the path to an actual screenshot file\n */\n getActualFilePath(filename: string): string {\n return path.resolve(this.actual, filename);\n }\n\n /**\n * Get the path to an expected screenshot file\n */\n getExpectedFilePath(filename: string): string {\n return path.resolve(this.expected, filename);\n }\n\n /**\n * Get the path to a diff screenshot file\n */\n getDiffFilePath(filename: string): string {\n return path.resolve(this.diff, filename);\n }\n\n /**\n * Write a file to the actual directory\n */\n async writeActualFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getActualFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Write a file to the diff directory\n */\n async writeDiffFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getDiffFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Check if an expected file exists\n */\n async hasExpectedFile(filename: string): Promise<boolean> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n await fsp.access(expectedPath);\n return true;\n } catch {\n return false;\n }\n }\n\n /**\n * Read an expected file\n */\n async readExpectedFile(filename: string): Promise<Buffer> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n return await fsp.readFile(expectedPath);\n } catch {\n throw new Error(`Expected image not found: ${expectedPath}`);\n }\n }\n\n /**\n * Resolve the actual path of a screenshot file.\n * @param filePath - The path to the screenshot file.\n * @returns The actual path of the screenshot file.\n */\n private resolveActualPath(filePath: string) {\n if (path.isAbsolute(filePath)) {\n return filePath;\n }\n\n return path.resolve(this.actual, filePath);\n }\n\n getRelativePath(directory: \"actual\" | \"expected\" | \"diff\", filePath: string) {\n const relativePath = path.relative(this[directory], filePath);\n\n if (relativePath.startsWith(\"..\")) {\n throw new Error(\n `Cannot resolve relative path outside of ${directory} directory: ${filePath}`,\n );\n }\n\n return relativePath;\n }\n}\n","import path from \"node:path\";\nimport { getLogger, type Logger } from \"@cappa/logger\";\nimport {\n type Browser,\n type BrowserContext,\n chromium,\n firefox,\n type Page,\n type PageScreenshotOptions,\n webkit,\n} from \"playwright-core\";\nimport {\n compareImagesGMSD,\n type CompareResult as GMSDCompareResult,\n} from \"./compare/gmsd\";\nimport {\n compareImages,\n createDiffSizePngImage,\n type CompareResult as PixelCompareResult,\n} from \"./compare/pixel\";\nimport { ScreenshotFileSystem } from \"./filesystem\";\nimport type {\n DiffConfig,\n DiffConfigGMSD,\n DiffOptions,\n DiffOptionsGMSD,\n DiffOptionsPixel,\n ScreenshotOptions,\n ScreenshotSettings,\n ScreenshotVariant,\n ScreenshotVariantWithUrl,\n} from \"./types\";\n\nconst defaultPixelDiffConfig: DiffOptionsPixel = {\n type: \"pixel\",\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n};\n\nconst defaultGMSDDiffConfig: DiffOptionsGMSD = {\n type: \"gmsd\",\n threshold: 0.1,\n downsample: 0,\n c: 170,\n};\n\nexport interface ScreenshotCaptureDetails {\n filename: string;\n filepath?: string;\n comparisonResult?: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n skipped?: boolean;\n}\n\nexport interface ScreenshotVariantCaptureDetails\n extends ScreenshotCaptureDetails {\n id: string;\n label?: string;\n}\n\nexport interface ScreenshotCaptureResult {\n base: ScreenshotCaptureDetails;\n variants: ScreenshotVariantCaptureDetails[];\n}\n\nexport interface ScreenshotCaptureExtras {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n variants?: Record<\n string,\n {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n }\n >;\n /**\n * Optional diff configuration override applied to this capture.\n * Merged on top of the global ScreenshotTool diff config.\n */\n diff?: DiffOptions;\n /**\n * Skip navigating to the base URL before capturing the base screenshot.\n * Use this when the page is already at the correct URL and in a stable state,\n * to avoid the redundant navigation.\n */\n skipBaseNavigation?: boolean;\n /**\n * Optional callback invoked after each navigation (variants only, or base when\n * skipBaseNavigation is false) to wait for visual stability before capturing.\n */\n waitForStability?: (page: Page) => Promise<void>;\n /**\n * Timestamp (from `performance.now()`) marking when the screenshot process\n * started — i.e. when the browser first navigated to the page. When provided,\n * the logged duration covers the full journey: navigation → stability waits →\n * capture. When omitted, timing begins at the capture step itself.\n */\n captureStart?: number;\n}\n\nclass ScreenshotTool {\n browserType: \"chromium\" | \"firefox\" | \"webkit\";\n headless: boolean;\n viewport: { width: number; height: number };\n fullPage: boolean;\n outputDir: string;\n browser: Browser | null = null;\n context: BrowserContext | null = null;\n page: Page | null = null;\n concurrency: number;\n contexts: BrowserContext[] = [];\n pages: Page[] = [];\n diff: DiffOptions;\n logger: Logger;\n retries: number;\n filesystem: ScreenshotFileSystem;\n logConsoleEvents: boolean;\n\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 }) {\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\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 this.browser = await browserClass.launch({\n headless: this.headless,\n });\n\n const tempCtx = await this.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 this.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, { waitUntil: \"domcontentloaded\" });\n }\n\n /**\n * Takes a screenshot of the page\n */\n async takeScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n ) {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n return;\n }\n\n try {\n // Generate filename - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n // Ensure parent directories exist before taking screenshot\n await this.filesystem.ensureParentDir(filepath);\n\n // Take screenshot\n const screenshotOptions = {\n path: filepath,\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n await this.withViewport(page, options.viewport, async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n await page.screenshot(screenshotOptions);\n });\n\n this.logger.success(`Screenshot saved: ${filepath}`);\n\n return filepath;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n /**\n * Sets the viewport size and executes the action, ensuring the original viewport is restored\n * even if the action throws an error.\n */\n private async withViewport<T>(\n page: Page,\n viewport: ScreenshotSettings[\"viewport\"],\n action: () => Promise<T>,\n ): Promise<T> {\n if (!viewport) {\n return action();\n }\n\n const previousViewport = page.viewportSize();\n\n // Check if the new viewport is the same as the current one\n if (\n previousViewport &&\n previousViewport.width === viewport.width &&\n previousViewport.height === viewport.height\n ) {\n return action();\n }\n\n await page.setViewportSize(viewport);\n\n try {\n return await action();\n } finally {\n // Always restore the original viewport, even if the action throws an error\n if (previousViewport) {\n await page.setViewportSize(previousViewport);\n }\n }\n }\n\n /**\n * Takes a screenshot and returns the buffer (for comparison purposes)\n */\n async takeScreenshotBuffer(\n page: Page,\n options: ScreenshotSettings,\n ): Promise<Buffer> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n throw new Error(\"Screenshot skipped\");\n }\n\n try {\n // Take screenshot without saving to file\n const screenshotOptions = {\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n const buffer = await this.withViewport(\n page,\n options.viewport,\n async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n return page.screenshot(screenshotOptions);\n },\n );\n\n return buffer;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async takeScreenshotWithComparison(\n page: Page,\n filename: string,\n referenceImage: Buffer,\n options: ScreenshotSettings & {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n },\n diffOverride?: DiffOptions,\n ): Promise<{\n screenshotPath: string;\n comparisonResult: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n }> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n try {\n // Generate filename and take screenshot - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n const screenshotSettings: ScreenshotSettings = {\n fullPage: options.fullPage ?? this.fullPage,\n mask: options.mask,\n omitBackground: options.omitBackground,\n delay: options.delay,\n viewport: options.viewport,\n };\n\n const retryScreenshot = await this.retryScreenshot(\n page,\n referenceImage,\n screenshotSettings,\n diffOverride,\n );\n\n if (!retryScreenshot.screenshotPath) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n // Save screenshot to actual directory\n await this.filesystem.writeActualFile(\n filename,\n retryScreenshot.screenshotPath,\n );\n this.logger.debug(`Actual screenshot saved: ${filepath}`);\n\n if (retryScreenshot.passed) {\n this.logger.success(`Screenshot passed visual comparison`);\n } else {\n this.logger.error(`Screenshot failed visual comparison`);\n }\n\n let diffImagePath: string | undefined;\n\n // Save diff image if requested and there are differences\n if (\n options.saveDiffImage &&\n retryScreenshot.comparisonResult?.diffBuffer &&\n !retryScreenshot.passed\n ) {\n const diffFilename = options.diffImageFilename || filename;\n // Save to diff directory\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n\n await this.filesystem.writeDiffFile(\n diffFilename,\n retryScreenshot.comparisonResult.diffBuffer,\n );\n\n this.logger.debug(`Diff image saved: ${diffImagePath}`);\n }\n\n // different sizes diff image\n if (\n retryScreenshot.comparisonResult !== null &&\n typeof retryScreenshot.comparisonResult === \"object\" &&\n \"differentSizes\" in retryScreenshot.comparisonResult &&\n retryScreenshot.comparisonResult.differentSizes\n ) {\n this.logger.warn(`Screenshot has different sizes than reference image`);\n\n const diffFilename = options.diffImageFilename || filename;\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n const diffBuffer = await createDiffSizePngImage(200, 200);\n\n await this.filesystem.writeDiffFile(diffFilename, diffBuffer);\n\n this.logger.debug(`Diff Size image saved: ${diffImagePath}`);\n }\n\n return {\n screenshotPath: filepath,\n comparisonResult: retryScreenshot.comparisonResult,\n diffImagePath,\n };\n } catch (error) {\n this.logger.error(\n `Error taking screenshot with comparison of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async retryScreenshot(\n page: Page,\n referenceImage: Buffer,\n options: ScreenshotSettings,\n diffOverride?: DiffOptions,\n ) {\n const diffConfig = this.mergeDiffOptions(diffOverride);\n\n for (let i = 0; i < this.retries; i++) {\n try {\n const screenshotBuffer = await this.takeScreenshotBuffer(page, {\n ...options,\n delay: this.getIncBackoffDelay(i, options.delay || 0),\n });\n\n if (!screenshotBuffer) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n const comparisonResult =\n diffConfig.type === \"gmsd\"\n ? await compareImagesGMSD(\n screenshotBuffer,\n referenceImage,\n true,\n diffConfig as DiffConfigGMSD,\n )\n : await compareImages(\n screenshotBuffer,\n referenceImage,\n true,\n diffConfig as DiffConfig,\n );\n\n // last retry\n if (i === this.retries - 1 && !comparisonResult.passed) {\n this.logger.error(\n `Failed to match screenshot after ${this.retries} retries`,\n );\n return {\n screenshotPath: screenshotBuffer,\n comparisonResult,\n passed: false,\n };\n }\n\n if (comparisonResult.passed) {\n return {\n screenshotPath: screenshotBuffer,\n comparisonResult,\n passed: true,\n };\n } else {\n const summary =\n \"numDiffPixels\" in comparisonResult\n ? comparisonResult.differentSizes\n ? \"different image sizes\"\n : `${comparisonResult.numDiffPixels} pixels different (${comparisonResult.percentDifference.toFixed(2)}%)`\n : `gmsd score ${comparisonResult.gmsd.toFixed(4)}`;\n\n this.logger.warn(\n `Comparison did not match. Retrying in ${this.getIncBackoffDelay(i + 1, options.delay || 0)}ms... \\nComparison result: ${summary}`,\n );\n }\n } catch (error) {\n this.logger.error(\n `Error taking screenshot after ${i + 1} retries:`,\n (error as Error).message,\n );\n }\n }\n\n return {\n screenshotPath: null,\n comparisonResult: null,\n passed: false,\n };\n }\n\n getVariantFilename(filename: string, variant: ScreenshotVariant): string {\n if (variant.filename) {\n return variant.filename;\n }\n\n const parsed = path.parse(filename);\n const sanitizedId = variant.id\n .trim()\n .replace(/[^a-zA-Z0-9_-]+/g, \"-\")\n .replace(/-+/g, \"-\")\n .replace(/^-|-$/g, \"\");\n const suffix = sanitizedId || \"variant\";\n const ext = parsed.ext || \".png\";\n const variantName = `${parsed.name}--${suffix}${ext}`;\n\n return parsed.dir ? path.join(parsed.dir, variantName) : variantName;\n }\n\n /**\n * Captures a single screenshot with the given options\n */\n private async captureSingleScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n extras: {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n captureStart?: number;\n } = {},\n ): Promise<ScreenshotCaptureDetails> {\n const result: ScreenshotCaptureDetails = { filename };\n\n if (options.skip) {\n result.skipped = true;\n return result;\n }\n\n const start = extras.captureStart ?? performance.now();\n const saveDiff = extras.saveDiffImage ?? false;\n const diffFilename = extras.diffImageFilename ?? filename;\n const diffOverride = extras.diff;\n\n if (!(await this.filesystem.hasExpectedFile(filename))) {\n this.logger.debug(\n `Expected image not found for ${filename}, taking screenshot`,\n );\n\n result.filepath = await this.takeScreenshot(page, filename, options);\n } else {\n const { screenshotPath, comparisonResult, diffImagePath } =\n await this.takeScreenshotWithComparison(\n page,\n filename,\n await this.filesystem.readExpectedFile(filename),\n {\n ...options,\n saveDiffImage: saveDiff,\n diffImageFilename: diffFilename,\n },\n diffOverride,\n );\n\n result.filepath = screenshotPath;\n result.comparisonResult = comparisonResult;\n result.diffImagePath = diffImagePath;\n }\n\n const duration = Math.round(performance.now() - start);\n this.logger.debug(`${filename} captured in ${duration}ms`);\n\n return result;\n }\n\n async capture(\n page: Page,\n filename: string,\n options: ScreenshotOptions,\n extras: ScreenshotCaptureExtras = {},\n ): Promise<ScreenshotCaptureResult> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n const { variants = [], ...baseOptions } = options;\n const baseResult: ScreenshotCaptureDetails = { filename };\n const variantResults: ScreenshotVariantCaptureDetails[] = [];\n\n const baseSaveDiff = extras.saveDiffImage ?? false;\n const baseDiffFilename = extras.diffImageFilename ?? filename;\n const baseDiffOverride = extras.diff;\n\n if (baseOptions.skip) {\n return {\n base: { ...baseResult, skipped: true },\n variants: variants.map((variant) => ({\n id: variant.id,\n label: variant.label,\n filename: this.getVariantFilename(filename, variant),\n skipped: true,\n })),\n };\n }\n\n // Capture base screenshot\n const baseCaptureResult = await this.captureSingleScreenshot(\n page,\n filename,\n baseOptions,\n {\n saveDiffImage: baseSaveDiff,\n diffImageFilename: baseDiffFilename,\n diff: baseDiffOverride,\n captureStart: extras.captureStart,\n },\n );\n\n baseResult.filepath = baseCaptureResult.filepath;\n baseResult.comparisonResult = baseCaptureResult.comparisonResult;\n baseResult.diffImagePath = baseCaptureResult.diffImagePath;\n baseResult.skipped = baseCaptureResult.skipped;\n\n for (const variant of variants) {\n const variantFilename = this.getVariantFilename(filename, variant);\n const variantOptions: ScreenshotSettings = {\n ...baseOptions,\n ...variant.options,\n };\n\n const variantResult: ScreenshotVariantCaptureDetails = {\n id: variant.id,\n label: variant.label,\n filename: variantFilename,\n };\n\n if (variantOptions.skip) {\n variantResult.skipped = true;\n variantResults.push(variantResult);\n continue;\n }\n\n const variantExtra = extras.variants?.[variant.id];\n const variantSaveDiff = variantExtra?.saveDiffImage ?? baseSaveDiff;\n const variantDiffFilename =\n variantExtra?.diffImageFilename ?? variantFilename;\n const variantDiffOverride = variantExtra?.diff ?? baseDiffOverride;\n\n const variantCaptureResult = await this.captureSingleScreenshot(\n page,\n variantFilename,\n variantOptions,\n {\n saveDiffImage: variantSaveDiff,\n diffImageFilename: variantDiffFilename,\n diff: variantDiffOverride,\n },\n );\n\n variantResult.filepath = variantCaptureResult.filepath;\n variantResult.comparisonResult = variantCaptureResult.comparisonResult;\n variantResult.diffImagePath = variantCaptureResult.diffImagePath;\n variantResult.skipped = variantCaptureResult.skipped;\n\n variantResults.push(variantResult);\n }\n\n return {\n base: baseResult,\n variants: variantResults,\n };\n }\n\n /**\n * Applies SVG and UI optimizations for screenshots\n */\n private async applyScreenshotOptimizations(page: Page) {\n await page.addStyleTag({\n content: `\n *, *::before, *::after {\n -moz-animation: none !important;\n -moz-transition: none !important;\n transition: none !important; \n animation: none !important;\n }\n *, input, textarea { caret-color: transparent !important }\n *:focus { outline: none !important }\n *:focus-visible { outline: none !important }\n *:focus-within { outline: none !important }\n * { text-rendering: optimizeLegibility !important }\n ::-webkit-scrollbar { display: none !important }\n html { scroll-behavior: auto !important }\n svg, svg * {\n shape-rendering: crispEdges !important;\n text-rendering: geometricPrecision !important;\n vector-effect: non-scaling-stroke !important;\n }\n img { image-rendering: crisp-edges !important }\n `,\n });\n }\n\n /**\n * Captures screenshots for multiple variants, each with their own URL\n */\n async captureWithVariants(\n page: Page,\n baseFilename: string,\n baseUrl: string,\n baseOptions: ScreenshotSettings,\n variants: ScreenshotVariantWithUrl[],\n extras: ScreenshotCaptureExtras = {},\n ): Promise<ScreenshotCaptureResult> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n const baseResult: ScreenshotCaptureDetails = { filename: baseFilename };\n const variantResults: ScreenshotVariantCaptureDetails[] = [];\n\n const baseSaveDiff = extras.saveDiffImage ?? false;\n const baseDiffFilename = extras.diffImageFilename ?? baseFilename;\n const baseDiffOverride = extras.diff;\n\n // Capture base screenshot\n let baseStart: number;\n if (!extras.skipBaseNavigation) {\n baseStart = performance.now();\n getLogger().debug(`Going to base URL: ${baseUrl}`);\n await page.goto(baseUrl);\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);\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.mjs CHANGED
@@ -2,7 +2,7 @@ import fs from "node:fs";
2
2
  import gmsd from "@blazediff/gmsd";
3
3
  import { getLogger } from "@cappa/logger";
4
4
  import fsp, { glob, readFile, writeFile } from "node:fs/promises";
5
- import { PNG } from "pngjs";
5
+ import sharp from "sharp";
6
6
  import blazediff from "@blazediff/core";
7
7
  import path from "node:path";
8
8
  import { chromium, firefox, webkit } from "playwright-core";
@@ -121,38 +121,41 @@ function extractTextMetadata(buffer) {
121
121
  //#endregion
122
122
  //#region src/features/png/png.ts
123
123
  /**
124
- * A wrapper around `pngjs` that adds support for reading and writing
125
- * textual metadata (tEXt chunks).
124
+ * A wrapper around `sharp` that adds support for reading and writing
125
+ * textual metadata (tEXt chunks). Used for fast PNG decode/encode.
126
126
  */
127
- var PNG$1 = class PNG$1 {
128
- image;
127
+ var PNG = class PNG {
128
+ width_;
129
+ height_;
130
+ data_;
129
131
  sourcePath;
130
132
  metadataEntries;
131
- constructor(image, sourcePath, metadata) {
132
- this.image = image;
133
+ constructor(width, height, data, sourcePath, metadata) {
134
+ this.width_ = width;
135
+ this.height_ = height;
136
+ this.data_ = data;
133
137
  this.sourcePath = sourcePath;
134
138
  this.metadataEntries = { ...metadata ?? {} };
135
139
  }
136
140
  static create(width, height) {
137
- return new PNG$1(new PNG({
138
- width,
139
- height
140
- }));
141
+ return new PNG(width, height, Buffer.alloc(width * height * 4, 0));
141
142
  }
142
143
  static async load(source) {
143
144
  const buffer = typeof source === "string" ? await readFile(source) : source;
144
- const png = PNG.sync.read(buffer);
145
145
  const metadata = extractTextMetadata(buffer);
146
- return new PNG$1(png, typeof source === "string" ? source : void 0, metadata);
146
+ const { data: raw, info } = await sharp(buffer).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
147
+ const data = Buffer.from(raw);
148
+ const sourcePath = typeof source === "string" ? source : void 0;
149
+ return new PNG(info.width, info.height, data, sourcePath, metadata);
147
150
  }
148
151
  get width() {
149
- return this.image.width;
152
+ return this.width_;
150
153
  }
151
154
  get height() {
152
- return this.image.height;
155
+ return this.height_;
153
156
  }
154
157
  get data() {
155
- return this.image.data;
158
+ return this.data_;
156
159
  }
157
160
  get metadata() {
158
161
  return { ...this.metadataEntries };
@@ -173,15 +176,19 @@ var PNG$1 = class PNG$1 {
173
176
  clearMetadata() {
174
177
  this.metadataEntries = {};
175
178
  }
176
- toBuffer(options) {
177
- const baseBuffer = PNG.sync.write(this.image, options);
179
+ async toBuffer() {
180
+ const baseBuffer = await sharp(this.data_, { raw: {
181
+ width: this.width_,
182
+ height: this.height_,
183
+ channels: 4
184
+ } }).png().toBuffer();
178
185
  if (Object.keys(this.metadataEntries).length === 0) return baseBuffer;
179
186
  return injectTextMetadata(baseBuffer, this.metadataEntries);
180
187
  }
181
- async save(filepath, options) {
188
+ async save(filepath) {
182
189
  const targetPath = filepath ?? this.sourcePath;
183
190
  if (!targetPath) throw new Error("No filepath provided for saving PNG");
184
- await writeFile(targetPath, this.toBuffer(options));
191
+ await writeFile(targetPath, await this.toBuffer());
185
192
  }
186
193
  };
187
194
  //#endregion
@@ -204,7 +211,7 @@ async function compareImagesGMSD(image1, image2, withDiff = false, options = {})
204
211
  gmsd: Infinity,
205
212
  passed: false
206
213
  };
207
- const diff = withDiff ? PNG$1.create(width, height) : void 0;
214
+ const diff = withDiff ? PNG.create(width, height) : void 0;
208
215
  try {
209
216
  const gmsd = compare$1(png1.data, png2.data, diff?.data, width, height, {
210
217
  downsample: options.downsample ?? 0,
@@ -212,7 +219,7 @@ async function compareImagesGMSD(image1, image2, withDiff = false, options = {})
212
219
  });
213
220
  return {
214
221
  gmsd,
215
- diffBuffer: diff ? annotateDiffImage$1(diff, options).toBuffer() : void 0,
222
+ diffBuffer: diff ? await annotateDiffImage$1(diff, options).toBuffer() : void 0,
216
223
  passed: gmsd <= (options.threshold ?? .1)
217
224
  };
218
225
  } catch (error) {
@@ -228,7 +235,7 @@ async function compareImagesGMSD(image1, image2, withDiff = false, options = {})
228
235
  * Load a PNG image from file path or Buffer
229
236
  */
230
237
  async function loadPNG$1(source) {
231
- return PNG$1.load(source);
238
+ return PNG.load(source);
232
239
  }
233
240
  function annotateDiffImage$1(image, options) {
234
241
  image.setMetadata("cappa.diff.algorithm", "gmsd");
@@ -271,7 +278,7 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
271
278
  passed: false,
272
279
  differentSizes: true
273
280
  };
274
- const diff = withDiff ? PNG$1.create(width, height) : void 0;
281
+ const diff = withDiff ? PNG.create(width, height) : void 0;
275
282
  try {
276
283
  const numDiffPixels = compare(png1.data, png2.data, diff?.data, width, height, options);
277
284
  const totalPixels = width * height;
@@ -280,7 +287,7 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
280
287
  numDiffPixels,
281
288
  totalPixels,
282
289
  percentDifference,
283
- diffBuffer: diff ? annotateDiffImage(diff, options).toBuffer() : void 0,
290
+ diffBuffer: diff ? await annotateDiffImage(diff, options).toBuffer() : void 0,
284
291
  passed: isPassed(percentDifference, numDiffPixels, options),
285
292
  differentSizes: false
286
293
  };
@@ -300,7 +307,7 @@ async function compareImages(image1, image2, withDiff = false, options = {}) {
300
307
  * Load a PNG image from file path or Buffer
301
308
  */
302
309
  async function loadPNG(source) {
303
- return PNG$1.load(source);
310
+ return PNG.load(source);
304
311
  }
305
312
  function annotateDiffImage(image, options) {
306
313
  image.setMetadata("cappa.diff.algorithm", "pixel");
@@ -337,8 +344,8 @@ const isPassed = (percentDifference, numDiffPixels, options) => {
337
344
  * Create different size png image with all pixels red
338
345
  * @returns
339
346
  */
340
- function createDiffSizePngImage(width, height) {
341
- const png = PNG$1.create(width, height);
347
+ async function createDiffSizePngImage(width, height) {
348
+ const png = PNG.create(width, height);
342
349
  for (let y = 0; y < height; y++) for (let x = 0; x < width; x++) {
343
350
  const idx = width * y + x << 2;
344
351
  png.data[idx] = 255;
@@ -789,7 +796,7 @@ var ScreenshotTool = class {
789
796
  this.logger.warn(`Screenshot has different sizes than reference image`);
790
797
  const diffFilename = options.diffImageFilename || filename;
791
798
  diffImagePath = this.filesystem.getDiffFilePath(diffFilename);
792
- const diffBuffer = createDiffSizePngImage(200, 200);
799
+ const diffBuffer = await createDiffSizePngImage(200, 200);
793
800
  await this.filesystem.writeDiffFile(diffFilename, diffBuffer);
794
801
  this.logger.debug(`Diff Size image saved: ${diffImagePath}`);
795
802
  }
@@ -985,7 +992,7 @@ var ScreenshotTool = class {
985
992
  await page.goto(baseUrl);
986
993
  await this.applyScreenshotOptimizations(page);
987
994
  await extras.waitForStability?.(page);
988
- }
995
+ } else baseStart = performance.now();
989
996
  const baseCaptureResult = await this.captureSingleScreenshot(page, baseFilename, baseOptions, {
990
997
  saveDiffImage: baseSaveDiff,
991
998
  diffImageFilename: baseDiffFilename,
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["PNG","PngjsPNG","compare","loadPNG","PNG","annotateDiffImage","PNG"],"sources":["../src/features/png/util.ts","../src/features/png/png.ts","../src/compare/gmsd.ts","../src/compare/pixel.ts","../src/config.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 { type PackerOptions, PNG as PngjsPNG } from \"pngjs\";\nimport type { MetadataEntries, PngWithMetadata } from \"./types\";\nimport { extractTextMetadata, injectTextMetadata } from \"./util\";\n\n/**\n * A wrapper around `pngjs` that adds support for reading and writing\n * textual metadata (tEXt chunks).\n */\nexport class PNG {\n private image: PngWithMetadata;\n private sourcePath?: string;\n private metadataEntries: MetadataEntries;\n\n private constructor(\n image: PngWithMetadata,\n sourcePath?: string,\n metadata?: MetadataEntries,\n ) {\n this.image = image;\n this.sourcePath = sourcePath;\n this.metadataEntries = { ...(metadata ?? {}) };\n }\n\n static create(width: number, height: number) {\n return new PNG(new PngjsPNG({ width, height }) as PngWithMetadata);\n }\n\n static async load(source: string | Buffer) {\n const buffer = typeof source === \"string\" ? await readFile(source) : source;\n const png = PngjsPNG.sync.read(buffer) as PngWithMetadata;\n\n const metadata = extractTextMetadata(buffer);\n\n return new PNG(\n png,\n typeof source === \"string\" ? source : undefined,\n metadata,\n );\n }\n\n get width() {\n return this.image.width;\n }\n\n get height() {\n return this.image.height;\n }\n\n get data() {\n return this.image.data;\n }\n\n get metadata(): MetadataEntries {\n return { ...this.metadataEntries };\n }\n\n setMetadata(key: string, value: string) {\n this.metadataEntries = { ...this.metadataEntries, [key]: value };\n }\n\n replaceMetadata(metadata: MetadataEntries) {\n this.metadataEntries = { ...metadata };\n }\n\n removeMetadata(key: string) {\n const { [key]: _, ...remaining } = this.metadataEntries;\n this.metadataEntries = remaining;\n }\n\n clearMetadata() {\n this.metadataEntries = {};\n }\n\n toBuffer(options?: PackerOptions) {\n const baseBuffer = PngjsPNG.sync.write(this.image, options);\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, options?: PackerOptions) {\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, this.toBuffer(options));\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 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 ? 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 blazediff, { type CoreOptions } from \"@blazediff/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { PNG } from \"../features/png/png\";\nimport type { DiffConfig } from \"../types\";\n\nexport type CompareOptions = CoreOptions;\n\nexport interface CompareResult {\n numDiffPixels: number;\n totalPixels: number;\n percentDifference: number;\n diffBuffer?: Buffer; // PNG buffer of the diff image\n passed: boolean; // Whether the comparison passed based on threshold\n error?: string; // Error message if the comparison failed\n differentSizes: boolean; // Whether the images have different sizes\n}\n\nconst compare = (\n image1: Uint8Array | Uint8ClampedArray,\n image2: Uint8Array | Uint8ClampedArray,\n diff: Uint8Array | Uint8ClampedArray | undefined,\n width: number,\n height: number,\n options?: CoreOptions,\n) => {\n return blazediff(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 compareImages(\n image1: string | Buffer,\n image2: string | Buffer,\n withDiff: boolean = false,\n options: DiffConfig = {},\n): Promise<CompareResult> {\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 {\n numDiffPixels: 0,\n totalPixels: 0,\n percentDifference: 0,\n passed: false,\n differentSizes: true,\n };\n }\n\n const diff = withDiff ? PNG.create(width, height) : undefined;\n\n try {\n const numDiffPixels = compare(\n png1.data,\n png2.data,\n diff?.data,\n width,\n height,\n options,\n );\n\n const totalPixels = width * height;\n const percentDifference = (numDiffPixels / totalPixels) * 100;\n\n // Convert diff image to buffer\n const diffBuffer = diff\n ? annotateDiffImage(diff, options).toBuffer()\n : undefined;\n\n return {\n numDiffPixels,\n totalPixels,\n percentDifference,\n diffBuffer,\n passed: isPassed(percentDifference, numDiffPixels, options),\n differentSizes: false,\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\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: 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 function createDiffSizePngImage(width: number, height: number): 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","import fs from \"node:fs\";\nimport fsp, { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { extractTextMetadata, injectTextMetadata } from \"./features/png/util\";\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 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 * 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 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 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 this.ensureParentDirSync(expectedPath);\n\n fs.copyFileSync(actualPath, expectedPath);\n\n if (fs.existsSync(diffPath)) {\n this.copyDiffMetadataToExpected(diffPath, expectedPath);\n fs.unlinkSync(diffPath);\n }\n\n return {\n actualPath,\n expectedPath,\n diffPath,\n };\n }\n\n private copyDiffMetadataToExpected(diffPath: string, expectedPath: string) {\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 = fs.readFileSync(diffPath);\n const diffMetadata = extractTextMetadata(diffBuffer);\n\n if (Object.keys(diffMetadata).length === 0) {\n return;\n }\n\n const expectedBuffer = fs.readFileSync(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 fs.writeFileSync(expectedPath, expectedWithMetadata);\n } catch {\n // Ignore metadata transfer errors to keep approval resilient.\n }\n }\n\n /**\n * Ensure the parent directory of a file exists. If not, it creates it.\n * @param filePath - The path to the file.\n */\n async ensureParentDir(filePath: string) {\n const dir = path.dirname(filePath);\n await fsp.mkdir(dir, { recursive: true });\n }\n\n /**\n * Synchronous version used only during constructor initialization.\n */\n private ensureParentDirSync(filePath: string) {\n const dir = path.dirname(filePath);\n\n if (!fs.existsSync(dir)) {\n fs.mkdirSync(dir, { recursive: true });\n }\n }\n\n /**\n * Remove a directory and all its contents.\n * @param dir - The path to the directory.\n */\n private removeDir(dir: string) {\n if (fs.existsSync(dir)) {\n fs.rmSync(dir, { recursive: true, force: true });\n }\n }\n\n /**\n * Get the actual directory path\n */\n getActualDir(): string {\n return this.actual;\n }\n\n /**\n * Get the expected directory path\n */\n getExpectedDir(): string {\n return this.expected;\n }\n\n /**\n * Get the diff directory path\n */\n getDiffDir(): string {\n return this.diff;\n }\n\n /**\n * Get the path to an actual screenshot file\n */\n getActualFilePath(filename: string): string {\n return path.resolve(this.actual, filename);\n }\n\n /**\n * Get the path to an expected screenshot file\n */\n getExpectedFilePath(filename: string): string {\n return path.resolve(this.expected, filename);\n }\n\n /**\n * Get the path to a diff screenshot file\n */\n getDiffFilePath(filename: string): string {\n return path.resolve(this.diff, filename);\n }\n\n /**\n * Write a file to the actual directory\n */\n async writeActualFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getActualFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Write a file to the diff directory\n */\n async writeDiffFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getDiffFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Check if an expected file exists\n */\n async hasExpectedFile(filename: string): Promise<boolean> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n await fsp.access(expectedPath);\n return true;\n } catch {\n return false;\n }\n }\n\n /**\n * Read an expected file\n */\n async readExpectedFile(filename: string): Promise<Buffer> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n return await fsp.readFile(expectedPath);\n } catch {\n throw new Error(`Expected image not found: ${expectedPath}`);\n }\n }\n\n /**\n * Resolve the actual path of a screenshot file.\n * @param filePath - The path to the screenshot file.\n * @returns The actual path of the screenshot file.\n */\n private resolveActualPath(filePath: string) {\n if (path.isAbsolute(filePath)) {\n return filePath;\n }\n\n return path.resolve(this.actual, filePath);\n }\n\n getRelativePath(directory: \"actual\" | \"expected\" | \"diff\", filePath: string) {\n const relativePath = path.relative(this[directory], filePath);\n\n if (relativePath.startsWith(\"..\")) {\n throw new Error(\n `Cannot resolve relative path outside of ${directory} directory: ${filePath}`,\n );\n }\n\n return relativePath;\n }\n}\n","import path from \"node:path\";\nimport { getLogger, type Logger } from \"@cappa/logger\";\nimport {\n type Browser,\n type BrowserContext,\n chromium,\n firefox,\n type Page,\n type PageScreenshotOptions,\n webkit,\n} from \"playwright-core\";\nimport {\n compareImagesGMSD,\n type CompareResult as GMSDCompareResult,\n} from \"./compare/gmsd\";\nimport {\n compareImages,\n createDiffSizePngImage,\n type CompareResult as PixelCompareResult,\n} from \"./compare/pixel\";\nimport { ScreenshotFileSystem } from \"./filesystem\";\nimport type {\n DiffConfig,\n DiffConfigGMSD,\n DiffOptions,\n DiffOptionsGMSD,\n DiffOptionsPixel,\n ScreenshotOptions,\n ScreenshotSettings,\n ScreenshotVariant,\n ScreenshotVariantWithUrl,\n} from \"./types\";\n\nconst defaultPixelDiffConfig: DiffOptionsPixel = {\n type: \"pixel\",\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n};\n\nconst defaultGMSDDiffConfig: DiffOptionsGMSD = {\n type: \"gmsd\",\n threshold: 0.1,\n downsample: 0,\n c: 170,\n};\n\nexport interface ScreenshotCaptureDetails {\n filename: string;\n filepath?: string;\n comparisonResult?: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n skipped?: boolean;\n}\n\nexport interface ScreenshotVariantCaptureDetails\n extends ScreenshotCaptureDetails {\n id: string;\n label?: string;\n}\n\nexport interface ScreenshotCaptureResult {\n base: ScreenshotCaptureDetails;\n variants: ScreenshotVariantCaptureDetails[];\n}\n\nexport interface ScreenshotCaptureExtras {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n variants?: Record<\n string,\n {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n }\n >;\n /**\n * Optional diff configuration override applied to this capture.\n * Merged on top of the global ScreenshotTool diff config.\n */\n diff?: DiffOptions;\n /**\n * Skip navigating to the base URL before capturing the base screenshot.\n * Use this when the page is already at the correct URL and in a stable state,\n * to avoid the redundant navigation.\n */\n skipBaseNavigation?: boolean;\n /**\n * Optional callback invoked after each navigation (variants only, or base when\n * skipBaseNavigation is false) to wait for visual stability before capturing.\n */\n waitForStability?: (page: Page) => Promise<void>;\n /**\n * Timestamp (from `performance.now()`) marking when the screenshot process\n * started — i.e. when the browser first navigated to the page. When provided,\n * the logged duration covers the full journey: navigation → stability waits →\n * capture. When omitted, timing begins at the capture step itself.\n */\n captureStart?: number;\n}\n\nclass ScreenshotTool {\n browserType: \"chromium\" | \"firefox\" | \"webkit\";\n headless: boolean;\n viewport: { width: number; height: number };\n fullPage: boolean;\n outputDir: string;\n browser: Browser | null = null;\n context: BrowserContext | null = null;\n page: Page | null = null;\n concurrency: number;\n contexts: BrowserContext[] = [];\n pages: Page[] = [];\n diff: DiffOptions;\n logger: Logger;\n retries: number;\n filesystem: ScreenshotFileSystem;\n logConsoleEvents: boolean;\n\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 }) {\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\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 this.browser = await browserClass.launch({\n headless: this.headless,\n });\n\n const tempCtx = await this.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 this.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, { waitUntil: \"domcontentloaded\" });\n }\n\n /**\n * Takes a screenshot of the page\n */\n async takeScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n ) {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n return;\n }\n\n try {\n // Generate filename - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n // Ensure parent directories exist before taking screenshot\n await this.filesystem.ensureParentDir(filepath);\n\n // Take screenshot\n const screenshotOptions = {\n path: filepath,\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n await this.withViewport(page, options.viewport, async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n await page.screenshot(screenshotOptions);\n });\n\n this.logger.success(`Screenshot saved: ${filepath}`);\n\n return filepath;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n /**\n * Sets the viewport size and executes the action, ensuring the original viewport is restored\n * even if the action throws an error.\n */\n private async withViewport<T>(\n page: Page,\n viewport: ScreenshotSettings[\"viewport\"],\n action: () => Promise<T>,\n ): Promise<T> {\n if (!viewport) {\n return action();\n }\n\n const previousViewport = page.viewportSize();\n\n // Check if the new viewport is the same as the current one\n if (\n previousViewport &&\n previousViewport.width === viewport.width &&\n previousViewport.height === viewport.height\n ) {\n return action();\n }\n\n await page.setViewportSize(viewport);\n\n try {\n return await action();\n } finally {\n // Always restore the original viewport, even if the action throws an error\n if (previousViewport) {\n await page.setViewportSize(previousViewport);\n }\n }\n }\n\n /**\n * Takes a screenshot and returns the buffer (for comparison purposes)\n */\n async takeScreenshotBuffer(\n page: Page,\n options: ScreenshotSettings,\n ): Promise<Buffer> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n throw new Error(\"Screenshot skipped\");\n }\n\n try {\n // Take screenshot without saving to file\n const screenshotOptions = {\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n const buffer = await this.withViewport(\n page,\n options.viewport,\n async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n return page.screenshot(screenshotOptions);\n },\n );\n\n return buffer;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async takeScreenshotWithComparison(\n page: Page,\n filename: string,\n referenceImage: Buffer,\n options: ScreenshotSettings & {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n },\n diffOverride?: DiffOptions,\n ): Promise<{\n screenshotPath: string;\n comparisonResult: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n }> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n try {\n // Generate filename and take screenshot - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n const screenshotSettings: ScreenshotSettings = {\n fullPage: options.fullPage ?? this.fullPage,\n mask: options.mask,\n omitBackground: options.omitBackground,\n delay: options.delay,\n viewport: options.viewport,\n };\n\n const retryScreenshot = await this.retryScreenshot(\n page,\n referenceImage,\n screenshotSettings,\n diffOverride,\n );\n\n if (!retryScreenshot.screenshotPath) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n // Save screenshot to actual directory\n await this.filesystem.writeActualFile(\n filename,\n retryScreenshot.screenshotPath,\n );\n this.logger.debug(`Actual screenshot saved: ${filepath}`);\n\n if (retryScreenshot.passed) {\n this.logger.success(`Screenshot passed visual comparison`);\n } else {\n this.logger.error(`Screenshot failed visual comparison`);\n }\n\n let diffImagePath: string | undefined;\n\n // Save diff image if requested and there are differences\n if (\n options.saveDiffImage &&\n retryScreenshot.comparisonResult?.diffBuffer &&\n !retryScreenshot.passed\n ) {\n const diffFilename = options.diffImageFilename || filename;\n // Save to diff directory\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n\n await this.filesystem.writeDiffFile(\n diffFilename,\n retryScreenshot.comparisonResult.diffBuffer,\n );\n\n this.logger.debug(`Diff image saved: ${diffImagePath}`);\n }\n\n // different sizes diff image\n if (\n retryScreenshot.comparisonResult !== null &&\n typeof retryScreenshot.comparisonResult === \"object\" &&\n \"differentSizes\" in retryScreenshot.comparisonResult &&\n retryScreenshot.comparisonResult.differentSizes\n ) {\n this.logger.warn(`Screenshot has different sizes than reference image`);\n\n const diffFilename = options.diffImageFilename || filename;\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n const diffBuffer = 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);\n await this.applyScreenshotOptimizations(page);\n await extras.waitForStability?.(page);\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);\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","loadPNG","annotateDiffImage"],"sources":["../src/features/png/util.ts","../src/features/png/png.ts","../src/compare/gmsd.ts","../src/compare/pixel.ts","../src/config.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 blazediff, { type CoreOptions } from \"@blazediff/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { PNG } from \"../features/png/png\";\nimport type { DiffConfig } from \"../types\";\n\nexport type CompareOptions = CoreOptions;\n\nexport interface CompareResult {\n numDiffPixels: number;\n totalPixels: number;\n percentDifference: number;\n diffBuffer?: Buffer; // PNG buffer of the diff image\n passed: boolean; // Whether the comparison passed based on threshold\n error?: string; // Error message if the comparison failed\n differentSizes: boolean; // Whether the images have different sizes\n}\n\nconst compare = (\n image1: Uint8Array | Uint8ClampedArray,\n image2: Uint8Array | Uint8ClampedArray,\n diff: Uint8Array | Uint8ClampedArray | undefined,\n width: number,\n height: number,\n options?: CoreOptions,\n) => {\n return blazediff(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 compareImages(\n image1: string | Buffer,\n image2: string | Buffer,\n withDiff: boolean = false,\n options: DiffConfig = {},\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 {\n numDiffPixels: 0,\n totalPixels: 0,\n percentDifference: 0,\n passed: false,\n differentSizes: true,\n };\n }\n\n const diff = withDiff ? PNG.create(width, height) : undefined;\n\n try {\n const numDiffPixels = compare(\n png1.data,\n png2.data,\n diff?.data,\n width,\n height,\n options,\n );\n\n const totalPixels = width * height;\n const percentDifference = (numDiffPixels / totalPixels) * 100;\n\n // Convert diff image to buffer\n const diffBuffer = diff\n ? await annotateDiffImage(diff, options).toBuffer()\n : undefined;\n\n return {\n numDiffPixels,\n totalPixels,\n percentDifference,\n diffBuffer,\n passed: isPassed(percentDifference, numDiffPixels, options),\n differentSizes: false,\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\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: 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","import fs from \"node:fs\";\nimport fsp, { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { extractTextMetadata, injectTextMetadata } from \"./features/png/util\";\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 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 * 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 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 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 this.ensureParentDirSync(expectedPath);\n\n fs.copyFileSync(actualPath, expectedPath);\n\n if (fs.existsSync(diffPath)) {\n this.copyDiffMetadataToExpected(diffPath, expectedPath);\n fs.unlinkSync(diffPath);\n }\n\n return {\n actualPath,\n expectedPath,\n diffPath,\n };\n }\n\n private copyDiffMetadataToExpected(diffPath: string, expectedPath: string) {\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 = fs.readFileSync(diffPath);\n const diffMetadata = extractTextMetadata(diffBuffer);\n\n if (Object.keys(diffMetadata).length === 0) {\n return;\n }\n\n const expectedBuffer = fs.readFileSync(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 fs.writeFileSync(expectedPath, expectedWithMetadata);\n } catch {\n // Ignore metadata transfer errors to keep approval resilient.\n }\n }\n\n /**\n * Ensure the parent directory of a file exists. If not, it creates it.\n * @param filePath - The path to the file.\n */\n async ensureParentDir(filePath: string) {\n const dir = path.dirname(filePath);\n await fsp.mkdir(dir, { recursive: true });\n }\n\n /**\n * Synchronous version used only during constructor initialization.\n */\n private ensureParentDirSync(filePath: string) {\n const dir = path.dirname(filePath);\n\n if (!fs.existsSync(dir)) {\n fs.mkdirSync(dir, { recursive: true });\n }\n }\n\n /**\n * Remove a directory and all its contents.\n * @param dir - The path to the directory.\n */\n private removeDir(dir: string) {\n if (fs.existsSync(dir)) {\n fs.rmSync(dir, { recursive: true, force: true });\n }\n }\n\n /**\n * Get the actual directory path\n */\n getActualDir(): string {\n return this.actual;\n }\n\n /**\n * Get the expected directory path\n */\n getExpectedDir(): string {\n return this.expected;\n }\n\n /**\n * Get the diff directory path\n */\n getDiffDir(): string {\n return this.diff;\n }\n\n /**\n * Get the path to an actual screenshot file\n */\n getActualFilePath(filename: string): string {\n return path.resolve(this.actual, filename);\n }\n\n /**\n * Get the path to an expected screenshot file\n */\n getExpectedFilePath(filename: string): string {\n return path.resolve(this.expected, filename);\n }\n\n /**\n * Get the path to a diff screenshot file\n */\n getDiffFilePath(filename: string): string {\n return path.resolve(this.diff, filename);\n }\n\n /**\n * Write a file to the actual directory\n */\n async writeActualFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getActualFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Write a file to the diff directory\n */\n async writeDiffFile(filename: string, data: Buffer): Promise<void> {\n const filepath = this.getDiffFilePath(filename);\n await this.ensureParentDir(filepath);\n await fsp.writeFile(filepath, data);\n }\n\n /**\n * Check if an expected file exists\n */\n async hasExpectedFile(filename: string): Promise<boolean> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n await fsp.access(expectedPath);\n return true;\n } catch {\n return false;\n }\n }\n\n /**\n * Read an expected file\n */\n async readExpectedFile(filename: string): Promise<Buffer> {\n const expectedPath = this.getExpectedFilePath(filename);\n try {\n return await fsp.readFile(expectedPath);\n } catch {\n throw new Error(`Expected image not found: ${expectedPath}`);\n }\n }\n\n /**\n * Resolve the actual path of a screenshot file.\n * @param filePath - The path to the screenshot file.\n * @returns The actual path of the screenshot file.\n */\n private resolveActualPath(filePath: string) {\n if (path.isAbsolute(filePath)) {\n return filePath;\n }\n\n return path.resolve(this.actual, filePath);\n }\n\n getRelativePath(directory: \"actual\" | \"expected\" | \"diff\", filePath: string) {\n const relativePath = path.relative(this[directory], filePath);\n\n if (relativePath.startsWith(\"..\")) {\n throw new Error(\n `Cannot resolve relative path outside of ${directory} directory: ${filePath}`,\n );\n }\n\n return relativePath;\n }\n}\n","import path from \"node:path\";\nimport { getLogger, type Logger } from \"@cappa/logger\";\nimport {\n type Browser,\n type BrowserContext,\n chromium,\n firefox,\n type Page,\n type PageScreenshotOptions,\n webkit,\n} from \"playwright-core\";\nimport {\n compareImagesGMSD,\n type CompareResult as GMSDCompareResult,\n} from \"./compare/gmsd\";\nimport {\n compareImages,\n createDiffSizePngImage,\n type CompareResult as PixelCompareResult,\n} from \"./compare/pixel\";\nimport { ScreenshotFileSystem } from \"./filesystem\";\nimport type {\n DiffConfig,\n DiffConfigGMSD,\n DiffOptions,\n DiffOptionsGMSD,\n DiffOptionsPixel,\n ScreenshotOptions,\n ScreenshotSettings,\n ScreenshotVariant,\n ScreenshotVariantWithUrl,\n} from \"./types\";\n\nconst defaultPixelDiffConfig: DiffOptionsPixel = {\n type: \"pixel\",\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n};\n\nconst defaultGMSDDiffConfig: DiffOptionsGMSD = {\n type: \"gmsd\",\n threshold: 0.1,\n downsample: 0,\n c: 170,\n};\n\nexport interface ScreenshotCaptureDetails {\n filename: string;\n filepath?: string;\n comparisonResult?: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n skipped?: boolean;\n}\n\nexport interface ScreenshotVariantCaptureDetails\n extends ScreenshotCaptureDetails {\n id: string;\n label?: string;\n}\n\nexport interface ScreenshotCaptureResult {\n base: ScreenshotCaptureDetails;\n variants: ScreenshotVariantCaptureDetails[];\n}\n\nexport interface ScreenshotCaptureExtras {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n variants?: Record<\n string,\n {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n }\n >;\n /**\n * Optional diff configuration override applied to this capture.\n * Merged on top of the global ScreenshotTool diff config.\n */\n diff?: DiffOptions;\n /**\n * Skip navigating to the base URL before capturing the base screenshot.\n * Use this when the page is already at the correct URL and in a stable state,\n * to avoid the redundant navigation.\n */\n skipBaseNavigation?: boolean;\n /**\n * Optional callback invoked after each navigation (variants only, or base when\n * skipBaseNavigation is false) to wait for visual stability before capturing.\n */\n waitForStability?: (page: Page) => Promise<void>;\n /**\n * Timestamp (from `performance.now()`) marking when the screenshot process\n * started — i.e. when the browser first navigated to the page. When provided,\n * the logged duration covers the full journey: navigation → stability waits →\n * capture. When omitted, timing begins at the capture step itself.\n */\n captureStart?: number;\n}\n\nclass ScreenshotTool {\n browserType: \"chromium\" | \"firefox\" | \"webkit\";\n headless: boolean;\n viewport: { width: number; height: number };\n fullPage: boolean;\n outputDir: string;\n browser: Browser | null = null;\n context: BrowserContext | null = null;\n page: Page | null = null;\n concurrency: number;\n contexts: BrowserContext[] = [];\n pages: Page[] = [];\n diff: DiffOptions;\n logger: Logger;\n retries: number;\n filesystem: ScreenshotFileSystem;\n logConsoleEvents: boolean;\n\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 }) {\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\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 this.browser = await browserClass.launch({\n headless: this.headless,\n });\n\n const tempCtx = await this.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 this.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, { waitUntil: \"domcontentloaded\" });\n }\n\n /**\n * Takes a screenshot of the page\n */\n async takeScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n ) {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n return;\n }\n\n try {\n // Generate filename - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n // Ensure parent directories exist before taking screenshot\n await this.filesystem.ensureParentDir(filepath);\n\n // Take screenshot\n const screenshotOptions = {\n path: filepath,\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n await this.withViewport(page, options.viewport, async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n await page.screenshot(screenshotOptions);\n });\n\n this.logger.success(`Screenshot saved: ${filepath}`);\n\n return filepath;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n /**\n * Sets the viewport size and executes the action, ensuring the original viewport is restored\n * even if the action throws an error.\n */\n private async withViewport<T>(\n page: Page,\n viewport: ScreenshotSettings[\"viewport\"],\n action: () => Promise<T>,\n ): Promise<T> {\n if (!viewport) {\n return action();\n }\n\n const previousViewport = page.viewportSize();\n\n // Check if the new viewport is the same as the current one\n if (\n previousViewport &&\n previousViewport.width === viewport.width &&\n previousViewport.height === viewport.height\n ) {\n return action();\n }\n\n await page.setViewportSize(viewport);\n\n try {\n return await action();\n } finally {\n // Always restore the original viewport, even if the action throws an error\n if (previousViewport) {\n await page.setViewportSize(previousViewport);\n }\n }\n }\n\n /**\n * Takes a screenshot and returns the buffer (for comparison purposes)\n */\n async takeScreenshotBuffer(\n page: Page,\n options: ScreenshotSettings,\n ): Promise<Buffer> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n if (options.skip) {\n throw new Error(\"Screenshot skipped\");\n }\n\n try {\n // Take screenshot without saving to file\n const screenshotOptions = {\n fullPage: options.fullPage ?? this.fullPage,\n type: \"png\" as const,\n timeout: 60000,\n mask: options.mask,\n omitBackground: options.omitBackground,\n scale: \"css\" as const,\n animations: \"disabled\",\n caret: \"hide\",\n } satisfies PageScreenshotOptions;\n\n const buffer = await this.withViewport(\n page,\n options.viewport,\n async () => {\n if (options.delay) {\n this.logger.debug(\n `Waiting ${options.delay}ms before taking screenshot`,\n );\n await page.waitForTimeout(options.delay);\n }\n\n return page.screenshot(screenshotOptions);\n },\n );\n\n return buffer;\n } catch (error) {\n this.logger.error(\n `Error taking screenshot of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async takeScreenshotWithComparison(\n page: Page,\n filename: string,\n referenceImage: Buffer,\n options: ScreenshotSettings & {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n },\n diffOverride?: DiffOptions,\n ): Promise<{\n screenshotPath: string;\n comparisonResult: PixelCompareResult | GMSDCompareResult;\n diffImagePath?: string;\n }> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n try {\n // Generate filename and take screenshot - save to actual directory\n const filepath = this.filesystem.getActualFilePath(filename);\n\n const screenshotSettings: ScreenshotSettings = {\n fullPage: options.fullPage ?? this.fullPage,\n mask: options.mask,\n omitBackground: options.omitBackground,\n delay: options.delay,\n viewport: options.viewport,\n };\n\n const retryScreenshot = await this.retryScreenshot(\n page,\n referenceImage,\n screenshotSettings,\n diffOverride,\n );\n\n if (!retryScreenshot.screenshotPath) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n // Save screenshot to actual directory\n await this.filesystem.writeActualFile(\n filename,\n retryScreenshot.screenshotPath,\n );\n this.logger.debug(`Actual screenshot saved: ${filepath}`);\n\n if (retryScreenshot.passed) {\n this.logger.success(`Screenshot passed visual comparison`);\n } else {\n this.logger.error(`Screenshot failed visual comparison`);\n }\n\n let diffImagePath: string | undefined;\n\n // Save diff image if requested and there are differences\n if (\n options.saveDiffImage &&\n retryScreenshot.comparisonResult?.diffBuffer &&\n !retryScreenshot.passed\n ) {\n const diffFilename = options.diffImageFilename || filename;\n // Save to diff directory\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n\n await this.filesystem.writeDiffFile(\n diffFilename,\n retryScreenshot.comparisonResult.diffBuffer,\n );\n\n this.logger.debug(`Diff image saved: ${diffImagePath}`);\n }\n\n // different sizes diff image\n if (\n retryScreenshot.comparisonResult !== null &&\n typeof retryScreenshot.comparisonResult === \"object\" &&\n \"differentSizes\" in retryScreenshot.comparisonResult &&\n retryScreenshot.comparisonResult.differentSizes\n ) {\n this.logger.warn(`Screenshot has different sizes than reference image`);\n\n const diffFilename = options.diffImageFilename || filename;\n diffImagePath = this.filesystem.getDiffFilePath(diffFilename);\n const diffBuffer = await createDiffSizePngImage(200, 200);\n\n await this.filesystem.writeDiffFile(diffFilename, diffBuffer);\n\n this.logger.debug(`Diff Size image saved: ${diffImagePath}`);\n }\n\n return {\n screenshotPath: filepath,\n comparisonResult: retryScreenshot.comparisonResult,\n diffImagePath,\n };\n } catch (error) {\n this.logger.error(\n `Error taking screenshot with comparison of ${page.url()}:`,\n (error as Error).message,\n );\n throw error;\n }\n }\n\n async retryScreenshot(\n page: Page,\n referenceImage: Buffer,\n options: ScreenshotSettings,\n diffOverride?: DiffOptions,\n ) {\n const diffConfig = this.mergeDiffOptions(diffOverride);\n\n for (let i = 0; i < this.retries; i++) {\n try {\n const screenshotBuffer = await this.takeScreenshotBuffer(page, {\n ...options,\n delay: this.getIncBackoffDelay(i, options.delay || 0),\n });\n\n if (!screenshotBuffer) {\n throw new Error(\"Screenshot buffer is undefined\");\n }\n\n const comparisonResult =\n diffConfig.type === \"gmsd\"\n ? await compareImagesGMSD(\n screenshotBuffer,\n referenceImage,\n true,\n diffConfig as DiffConfigGMSD,\n )\n : await compareImages(\n screenshotBuffer,\n referenceImage,\n true,\n diffConfig as DiffConfig,\n );\n\n // last retry\n if (i === this.retries - 1 && !comparisonResult.passed) {\n this.logger.error(\n `Failed to match screenshot after ${this.retries} retries`,\n );\n return {\n screenshotPath: screenshotBuffer,\n comparisonResult,\n passed: false,\n };\n }\n\n if (comparisonResult.passed) {\n return {\n screenshotPath: screenshotBuffer,\n comparisonResult,\n passed: true,\n };\n } else {\n const summary =\n \"numDiffPixels\" in comparisonResult\n ? comparisonResult.differentSizes\n ? \"different image sizes\"\n : `${comparisonResult.numDiffPixels} pixels different (${comparisonResult.percentDifference.toFixed(2)}%)`\n : `gmsd score ${comparisonResult.gmsd.toFixed(4)}`;\n\n this.logger.warn(\n `Comparison did not match. Retrying in ${this.getIncBackoffDelay(i + 1, options.delay || 0)}ms... \\nComparison result: ${summary}`,\n );\n }\n } catch (error) {\n this.logger.error(\n `Error taking screenshot after ${i + 1} retries:`,\n (error as Error).message,\n );\n }\n }\n\n return {\n screenshotPath: null,\n comparisonResult: null,\n passed: false,\n };\n }\n\n getVariantFilename(filename: string, variant: ScreenshotVariant): string {\n if (variant.filename) {\n return variant.filename;\n }\n\n const parsed = path.parse(filename);\n const sanitizedId = variant.id\n .trim()\n .replace(/[^a-zA-Z0-9_-]+/g, \"-\")\n .replace(/-+/g, \"-\")\n .replace(/^-|-$/g, \"\");\n const suffix = sanitizedId || \"variant\";\n const ext = parsed.ext || \".png\";\n const variantName = `${parsed.name}--${suffix}${ext}`;\n\n return parsed.dir ? path.join(parsed.dir, variantName) : variantName;\n }\n\n /**\n * Captures a single screenshot with the given options\n */\n private async captureSingleScreenshot(\n page: Page,\n filename: string,\n options: ScreenshotSettings,\n extras: {\n saveDiffImage?: boolean;\n diffImageFilename?: string;\n diff?: DiffOptions;\n captureStart?: number;\n } = {},\n ): Promise<ScreenshotCaptureDetails> {\n const result: ScreenshotCaptureDetails = { filename };\n\n if (options.skip) {\n result.skipped = true;\n return result;\n }\n\n const start = extras.captureStart ?? performance.now();\n const saveDiff = extras.saveDiffImage ?? false;\n const diffFilename = extras.diffImageFilename ?? filename;\n const diffOverride = extras.diff;\n\n if (!(await this.filesystem.hasExpectedFile(filename))) {\n this.logger.debug(\n `Expected image not found for ${filename}, taking screenshot`,\n );\n\n result.filepath = await this.takeScreenshot(page, filename, options);\n } else {\n const { screenshotPath, comparisonResult, diffImagePath } =\n await this.takeScreenshotWithComparison(\n page,\n filename,\n await this.filesystem.readExpectedFile(filename),\n {\n ...options,\n saveDiffImage: saveDiff,\n diffImageFilename: diffFilename,\n },\n diffOverride,\n );\n\n result.filepath = screenshotPath;\n result.comparisonResult = comparisonResult;\n result.diffImagePath = diffImagePath;\n }\n\n const duration = Math.round(performance.now() - start);\n this.logger.debug(`${filename} captured in ${duration}ms`);\n\n return result;\n }\n\n async capture(\n page: Page,\n filename: string,\n options: ScreenshotOptions,\n extras: ScreenshotCaptureExtras = {},\n ): Promise<ScreenshotCaptureResult> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n const { variants = [], ...baseOptions } = options;\n const baseResult: ScreenshotCaptureDetails = { filename };\n const variantResults: ScreenshotVariantCaptureDetails[] = [];\n\n const baseSaveDiff = extras.saveDiffImage ?? false;\n const baseDiffFilename = extras.diffImageFilename ?? filename;\n const baseDiffOverride = extras.diff;\n\n if (baseOptions.skip) {\n return {\n base: { ...baseResult, skipped: true },\n variants: variants.map((variant) => ({\n id: variant.id,\n label: variant.label,\n filename: this.getVariantFilename(filename, variant),\n skipped: true,\n })),\n };\n }\n\n // Capture base screenshot\n const baseCaptureResult = await this.captureSingleScreenshot(\n page,\n filename,\n baseOptions,\n {\n saveDiffImage: baseSaveDiff,\n diffImageFilename: baseDiffFilename,\n diff: baseDiffOverride,\n captureStart: extras.captureStart,\n },\n );\n\n baseResult.filepath = baseCaptureResult.filepath;\n baseResult.comparisonResult = baseCaptureResult.comparisonResult;\n baseResult.diffImagePath = baseCaptureResult.diffImagePath;\n baseResult.skipped = baseCaptureResult.skipped;\n\n for (const variant of variants) {\n const variantFilename = this.getVariantFilename(filename, variant);\n const variantOptions: ScreenshotSettings = {\n ...baseOptions,\n ...variant.options,\n };\n\n const variantResult: ScreenshotVariantCaptureDetails = {\n id: variant.id,\n label: variant.label,\n filename: variantFilename,\n };\n\n if (variantOptions.skip) {\n variantResult.skipped = true;\n variantResults.push(variantResult);\n continue;\n }\n\n const variantExtra = extras.variants?.[variant.id];\n const variantSaveDiff = variantExtra?.saveDiffImage ?? baseSaveDiff;\n const variantDiffFilename =\n variantExtra?.diffImageFilename ?? variantFilename;\n const variantDiffOverride = variantExtra?.diff ?? baseDiffOverride;\n\n const variantCaptureResult = await this.captureSingleScreenshot(\n page,\n variantFilename,\n variantOptions,\n {\n saveDiffImage: variantSaveDiff,\n diffImageFilename: variantDiffFilename,\n diff: variantDiffOverride,\n },\n );\n\n variantResult.filepath = variantCaptureResult.filepath;\n variantResult.comparisonResult = variantCaptureResult.comparisonResult;\n variantResult.diffImagePath = variantCaptureResult.diffImagePath;\n variantResult.skipped = variantCaptureResult.skipped;\n\n variantResults.push(variantResult);\n }\n\n return {\n base: baseResult,\n variants: variantResults,\n };\n }\n\n /**\n * Applies SVG and UI optimizations for screenshots\n */\n private async applyScreenshotOptimizations(page: Page) {\n await page.addStyleTag({\n content: `\n *, *::before, *::after {\n -moz-animation: none !important;\n -moz-transition: none !important;\n transition: none !important; \n animation: none !important;\n }\n *, input, textarea { caret-color: transparent !important }\n *:focus { outline: none !important }\n *:focus-visible { outline: none !important }\n *:focus-within { outline: none !important }\n * { text-rendering: optimizeLegibility !important }\n ::-webkit-scrollbar { display: none !important }\n html { scroll-behavior: auto !important }\n svg, svg * {\n shape-rendering: crispEdges !important;\n text-rendering: geometricPrecision !important;\n vector-effect: non-scaling-stroke !important;\n }\n img { image-rendering: crisp-edges !important }\n `,\n });\n }\n\n /**\n * Captures screenshots for multiple variants, each with their own URL\n */\n async captureWithVariants(\n page: Page,\n baseFilename: string,\n baseUrl: string,\n baseOptions: ScreenshotSettings,\n variants: ScreenshotVariantWithUrl[],\n extras: ScreenshotCaptureExtras = {},\n ): Promise<ScreenshotCaptureResult> {\n if (!this.browser) {\n throw new Error(\"Browser not initialized\");\n }\n\n const baseResult: ScreenshotCaptureDetails = { filename: baseFilename };\n const variantResults: ScreenshotVariantCaptureDetails[] = [];\n\n const baseSaveDiff = extras.saveDiffImage ?? false;\n const baseDiffFilename = extras.diffImageFilename ?? baseFilename;\n const baseDiffOverride = extras.diff;\n\n // Capture base screenshot\n let baseStart: number;\n if (!extras.skipBaseNavigation) {\n baseStart = performance.now();\n getLogger().debug(`Going to base URL: ${baseUrl}`);\n await page.goto(baseUrl);\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);\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.7.1",
3
+ "version": "0.7.2",
4
4
  "description": "Core Playwright screenshot functionality for Cappa",
5
5
  "author": "Tim Richter",
6
6
  "repository": {
@@ -30,13 +30,12 @@
30
30
  "dependencies": {
31
31
  "@blazediff/core": "^1.9.1",
32
32
  "@blazediff/gmsd": "^1.7.1",
33
- "pngjs": "^7.0.0",
33
+ "sharp": "^0.34.5",
34
34
  "@cappa/logger": "0.0.10"
35
35
  },
36
36
  "devDependencies": {
37
37
  "@arethetypeswrong/cli": "0.18.2",
38
38
  "@types/node": "25.3.5",
39
- "@types/pngjs": "^6.0.5",
40
39
  "@vitest/coverage-v8": "4.0.18",
41
40
  "@vitest/ui": "4.0.18",
42
41
  "playwright-core": "^1.58.2",