@cappa/core 0.7.0 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +52 -29
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +16 -5
- package/dist/index.d.mts +16 -5
- package/dist/index.mjs +52 -30
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.cjs
CHANGED
|
@@ -27,6 +27,7 @@ let _blazediff_gmsd = require("@blazediff/gmsd");
|
|
|
27
27
|
_blazediff_gmsd = __toESM(_blazediff_gmsd);
|
|
28
28
|
let _cappa_logger = require("@cappa/logger");
|
|
29
29
|
let node_fs_promises = require("node:fs/promises");
|
|
30
|
+
node_fs_promises = __toESM(node_fs_promises);
|
|
30
31
|
let pngjs = require("pngjs");
|
|
31
32
|
let _blazediff_core = require("@blazediff/core");
|
|
32
33
|
_blazediff_core = __toESM(_blazediff_core);
|
|
@@ -225,8 +226,7 @@ const compare$1 = (image1, image2, diff, width, height, options) => {
|
|
|
225
226
|
* @returns Comparison result
|
|
226
227
|
*/
|
|
227
228
|
async function compareImagesGMSD(image1, image2, withDiff = false, options = {}) {
|
|
228
|
-
const png1 = await loadPNG$1(image1);
|
|
229
|
-
const png2 = await loadPNG$1(image2);
|
|
229
|
+
const [png1, png2] = await Promise.all([loadPNG$1(image1), loadPNG$1(image2)]);
|
|
230
230
|
const { width, height } = png1;
|
|
231
231
|
if (width !== png2.width || height !== png2.height) return {
|
|
232
232
|
gmsd: Infinity,
|
|
@@ -290,8 +290,7 @@ const compare = (image1, image2, diff, width, height, options) => {
|
|
|
290
290
|
* @returns Comparison result
|
|
291
291
|
*/
|
|
292
292
|
async function compareImages(image1, image2, withDiff = false, options = {}) {
|
|
293
|
-
const png1 = await loadPNG(image1);
|
|
294
|
-
const png2 = await loadPNG(image2);
|
|
293
|
+
const [png1, png2] = await Promise.all([loadPNG(image1), loadPNG(image2)]);
|
|
295
294
|
const { width, height } = png1;
|
|
296
295
|
if (width !== png2.width || height !== png2.height) return {
|
|
297
296
|
numDiffPixels: 0,
|
|
@@ -398,9 +397,9 @@ var ScreenshotFileSystem = class {
|
|
|
398
397
|
this.actual = node_path.default.resolve(outputDir, "actual");
|
|
399
398
|
this.expected = node_path.default.resolve(outputDir, "expected");
|
|
400
399
|
this.diff = node_path.default.resolve(outputDir, "diff");
|
|
401
|
-
this.
|
|
402
|
-
this.
|
|
403
|
-
this.
|
|
400
|
+
this.ensureParentDirSync(this.actual);
|
|
401
|
+
this.ensureParentDirSync(this.expected);
|
|
402
|
+
this.ensureParentDirSync(this.diff);
|
|
404
403
|
}
|
|
405
404
|
clearActual() {
|
|
406
405
|
this.removeDir(this.actual);
|
|
@@ -450,7 +449,7 @@ var ScreenshotFileSystem = class {
|
|
|
450
449
|
const actualPath = node_path.default.resolve(this.actual, relativePath);
|
|
451
450
|
const expectedPath = node_path.default.resolve(this.expected, relativePath);
|
|
452
451
|
const diffPath = node_path.default.resolve(this.diff, relativePath);
|
|
453
|
-
this.
|
|
452
|
+
this.ensureParentDirSync(expectedPath);
|
|
454
453
|
node_fs.default.copyFileSync(actualPath, expectedPath);
|
|
455
454
|
if (node_fs.default.existsSync(diffPath)) {
|
|
456
455
|
this.copyDiffMetadataToExpected(diffPath, expectedPath);
|
|
@@ -481,7 +480,14 @@ var ScreenshotFileSystem = class {
|
|
|
481
480
|
* Ensure the parent directory of a file exists. If not, it creates it.
|
|
482
481
|
* @param filePath - The path to the file.
|
|
483
482
|
*/
|
|
484
|
-
ensureParentDir(filePath) {
|
|
483
|
+
async ensureParentDir(filePath) {
|
|
484
|
+
const dir = node_path.default.dirname(filePath);
|
|
485
|
+
await node_fs_promises.default.mkdir(dir, { recursive: true });
|
|
486
|
+
}
|
|
487
|
+
/**
|
|
488
|
+
* Synchronous version used only during constructor initialization.
|
|
489
|
+
*/
|
|
490
|
+
ensureParentDirSync(filePath) {
|
|
485
491
|
const dir = node_path.default.dirname(filePath);
|
|
486
492
|
if (!node_fs.default.existsSync(dir)) node_fs.default.mkdirSync(dir, { recursive: true });
|
|
487
493
|
}
|
|
@@ -534,33 +540,41 @@ var ScreenshotFileSystem = class {
|
|
|
534
540
|
/**
|
|
535
541
|
* Write a file to the actual directory
|
|
536
542
|
*/
|
|
537
|
-
writeActualFile(filename, data) {
|
|
543
|
+
async writeActualFile(filename, data) {
|
|
538
544
|
const filepath = this.getActualFilePath(filename);
|
|
539
|
-
this.ensureParentDir(filepath);
|
|
540
|
-
|
|
545
|
+
await this.ensureParentDir(filepath);
|
|
546
|
+
await node_fs_promises.default.writeFile(filepath, data);
|
|
541
547
|
}
|
|
542
548
|
/**
|
|
543
549
|
* Write a file to the diff directory
|
|
544
550
|
*/
|
|
545
|
-
writeDiffFile(filename, data) {
|
|
551
|
+
async writeDiffFile(filename, data) {
|
|
546
552
|
const filepath = this.getDiffFilePath(filename);
|
|
547
|
-
this.ensureParentDir(filepath);
|
|
548
|
-
|
|
553
|
+
await this.ensureParentDir(filepath);
|
|
554
|
+
await node_fs_promises.default.writeFile(filepath, data);
|
|
549
555
|
}
|
|
550
556
|
/**
|
|
551
557
|
* Check if an expected file exists
|
|
552
558
|
*/
|
|
553
|
-
hasExpectedFile(filename) {
|
|
559
|
+
async hasExpectedFile(filename) {
|
|
554
560
|
const expectedPath = this.getExpectedFilePath(filename);
|
|
555
|
-
|
|
561
|
+
try {
|
|
562
|
+
await node_fs_promises.default.access(expectedPath);
|
|
563
|
+
return true;
|
|
564
|
+
} catch {
|
|
565
|
+
return false;
|
|
566
|
+
}
|
|
556
567
|
}
|
|
557
568
|
/**
|
|
558
569
|
* Read an expected file
|
|
559
570
|
*/
|
|
560
|
-
readExpectedFile(filename) {
|
|
571
|
+
async readExpectedFile(filename) {
|
|
561
572
|
const expectedPath = this.getExpectedFilePath(filename);
|
|
562
|
-
|
|
563
|
-
|
|
573
|
+
try {
|
|
574
|
+
return await node_fs_promises.default.readFile(expectedPath);
|
|
575
|
+
} catch {
|
|
576
|
+
throw new Error(`Expected image not found: ${expectedPath}`);
|
|
577
|
+
}
|
|
564
578
|
}
|
|
565
579
|
/**
|
|
566
580
|
* Resolve the actual path of a screenshot file.
|
|
@@ -705,7 +719,7 @@ var ScreenshotTool = class {
|
|
|
705
719
|
if (options.skip) return;
|
|
706
720
|
try {
|
|
707
721
|
const filepath = this.filesystem.getActualFilePath(filename);
|
|
708
|
-
this.filesystem.ensureParentDir(filepath);
|
|
722
|
+
await this.filesystem.ensureParentDir(filepath);
|
|
709
723
|
const screenshotOptions = {
|
|
710
724
|
path: filepath,
|
|
711
725
|
fullPage: options.fullPage ?? this.fullPage,
|
|
@@ -788,7 +802,7 @@ var ScreenshotTool = class {
|
|
|
788
802
|
};
|
|
789
803
|
const retryScreenshot = await this.retryScreenshot(page, referenceImage, screenshotSettings, diffOverride);
|
|
790
804
|
if (!retryScreenshot.screenshotPath) throw new Error("Screenshot buffer is undefined");
|
|
791
|
-
this.filesystem.writeActualFile(filename, retryScreenshot.screenshotPath);
|
|
805
|
+
await this.filesystem.writeActualFile(filename, retryScreenshot.screenshotPath);
|
|
792
806
|
this.logger.debug(`Actual screenshot saved: ${filepath}`);
|
|
793
807
|
if (retryScreenshot.passed) this.logger.success(`Screenshot passed visual comparison`);
|
|
794
808
|
else this.logger.error(`Screenshot failed visual comparison`);
|
|
@@ -796,7 +810,7 @@ var ScreenshotTool = class {
|
|
|
796
810
|
if (options.saveDiffImage && retryScreenshot.comparisonResult?.diffBuffer && !retryScreenshot.passed) {
|
|
797
811
|
const diffFilename = options.diffImageFilename || filename;
|
|
798
812
|
diffImagePath = this.filesystem.getDiffFilePath(diffFilename);
|
|
799
|
-
this.filesystem.writeDiffFile(diffFilename, retryScreenshot.comparisonResult.diffBuffer);
|
|
813
|
+
await this.filesystem.writeDiffFile(diffFilename, retryScreenshot.comparisonResult.diffBuffer);
|
|
800
814
|
this.logger.debug(`Diff image saved: ${diffImagePath}`);
|
|
801
815
|
}
|
|
802
816
|
if (retryScreenshot.comparisonResult !== null && typeof retryScreenshot.comparisonResult === "object" && "differentSizes" in retryScreenshot.comparisonResult && retryScreenshot.comparisonResult.differentSizes) {
|
|
@@ -804,7 +818,7 @@ var ScreenshotTool = class {
|
|
|
804
818
|
const diffFilename = options.diffImageFilename || filename;
|
|
805
819
|
diffImagePath = this.filesystem.getDiffFilePath(diffFilename);
|
|
806
820
|
const diffBuffer = createDiffSizePngImage(200, 200);
|
|
807
|
-
this.filesystem.writeDiffFile(diffFilename, diffBuffer);
|
|
821
|
+
await this.filesystem.writeDiffFile(diffFilename, diffBuffer);
|
|
808
822
|
this.logger.debug(`Diff Size image saved: ${diffImagePath}`);
|
|
809
823
|
}
|
|
810
824
|
return {
|
|
@@ -869,14 +883,15 @@ var ScreenshotTool = class {
|
|
|
869
883
|
result.skipped = true;
|
|
870
884
|
return result;
|
|
871
885
|
}
|
|
886
|
+
const start = extras.captureStart ?? performance.now();
|
|
872
887
|
const saveDiff = extras.saveDiffImage ?? false;
|
|
873
888
|
const diffFilename = extras.diffImageFilename ?? filename;
|
|
874
889
|
const diffOverride = extras.diff;
|
|
875
|
-
if (!this.filesystem.hasExpectedFile(filename)) {
|
|
890
|
+
if (!await this.filesystem.hasExpectedFile(filename)) {
|
|
876
891
|
this.logger.debug(`Expected image not found for ${filename}, taking screenshot`);
|
|
877
892
|
result.filepath = await this.takeScreenshot(page, filename, options);
|
|
878
893
|
} else {
|
|
879
|
-
const { screenshotPath, comparisonResult, diffImagePath } = await this.takeScreenshotWithComparison(page, filename, this.filesystem.readExpectedFile(filename), {
|
|
894
|
+
const { screenshotPath, comparisonResult, diffImagePath } = await this.takeScreenshotWithComparison(page, filename, await this.filesystem.readExpectedFile(filename), {
|
|
880
895
|
...options,
|
|
881
896
|
saveDiffImage: saveDiff,
|
|
882
897
|
diffImageFilename: diffFilename
|
|
@@ -885,6 +900,8 @@ var ScreenshotTool = class {
|
|
|
885
900
|
result.comparisonResult = comparisonResult;
|
|
886
901
|
result.diffImagePath = diffImagePath;
|
|
887
902
|
}
|
|
903
|
+
const duration = Math.round(performance.now() - start);
|
|
904
|
+
this.logger.debug(`${filename} captured in ${duration}ms`);
|
|
888
905
|
return result;
|
|
889
906
|
}
|
|
890
907
|
async capture(page, filename, options, extras = {}) {
|
|
@@ -910,7 +927,8 @@ var ScreenshotTool = class {
|
|
|
910
927
|
const baseCaptureResult = await this.captureSingleScreenshot(page, filename, baseOptions, {
|
|
911
928
|
saveDiffImage: baseSaveDiff,
|
|
912
929
|
diffImageFilename: baseDiffFilename,
|
|
913
|
-
diff: baseDiffOverride
|
|
930
|
+
diff: baseDiffOverride,
|
|
931
|
+
captureStart: extras.captureStart
|
|
914
932
|
});
|
|
915
933
|
baseResult.filepath = baseCaptureResult.filepath;
|
|
916
934
|
baseResult.comparisonResult = baseCaptureResult.comparisonResult;
|
|
@@ -988,7 +1006,9 @@ var ScreenshotTool = class {
|
|
|
988
1006
|
const baseSaveDiff = extras.saveDiffImage ?? false;
|
|
989
1007
|
const baseDiffFilename = extras.diffImageFilename ?? baseFilename;
|
|
990
1008
|
const baseDiffOverride = extras.diff;
|
|
1009
|
+
let baseStart;
|
|
991
1010
|
if (!extras.skipBaseNavigation) {
|
|
1011
|
+
baseStart = performance.now();
|
|
992
1012
|
(0, _cappa_logger.getLogger)().debug(`Going to base URL: ${baseUrl}`);
|
|
993
1013
|
await page.goto(baseUrl);
|
|
994
1014
|
await this.applyScreenshotOptimizations(page);
|
|
@@ -997,7 +1017,8 @@ var ScreenshotTool = class {
|
|
|
997
1017
|
const baseCaptureResult = await this.captureSingleScreenshot(page, baseFilename, baseOptions, {
|
|
998
1018
|
saveDiffImage: baseSaveDiff,
|
|
999
1019
|
diffImageFilename: baseDiffFilename,
|
|
1000
|
-
diff: baseDiffOverride
|
|
1020
|
+
diff: baseDiffOverride,
|
|
1021
|
+
captureStart: extras.captureStart ?? baseStart
|
|
1001
1022
|
});
|
|
1002
1023
|
baseResult.filepath = baseCaptureResult.filepath;
|
|
1003
1024
|
baseResult.comparisonResult = baseCaptureResult.comparisonResult;
|
|
@@ -1019,6 +1040,7 @@ var ScreenshotTool = class {
|
|
|
1019
1040
|
variantResults.push(variantResult);
|
|
1020
1041
|
continue;
|
|
1021
1042
|
}
|
|
1043
|
+
const variantStart = performance.now();
|
|
1022
1044
|
(0, _cappa_logger.getLogger)().debug(`Going to variant URL: ${variant.url}`);
|
|
1023
1045
|
await page.goto(variant.url);
|
|
1024
1046
|
await this.applyScreenshotOptimizations(page);
|
|
@@ -1030,7 +1052,8 @@ var ScreenshotTool = class {
|
|
|
1030
1052
|
const variantCaptureResult = await this.captureSingleScreenshot(page, variantFilename, variantOptions, {
|
|
1031
1053
|
saveDiffImage: variantSaveDiff,
|
|
1032
1054
|
diffImageFilename: variantDiffFilename,
|
|
1033
|
-
diff: variantDiffOverride
|
|
1055
|
+
diff: variantDiffOverride,
|
|
1056
|
+
captureStart: variantStart
|
|
1034
1057
|
});
|
|
1035
1058
|
variantResult.filepath = variantCaptureResult.filepath;
|
|
1036
1059
|
variantResult.comparisonResult = variantCaptureResult.comparisonResult;
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","names":["PngjsPNG","compare","loadPNG","annotateDiffImage","path","fs","path"],"sources":["../src/features/png/util.ts","../src/features/png/png.ts","../src/compare/gmsd.ts","../src/compare/pixel.ts","../src/config.ts","../src/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 = await loadPNG(image1);\n const png2 = await 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 = await loadPNG(image1);\n const png2 = await 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 { 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.ensureParentDir(this.actual);\n this.ensureParentDir(this.expected);\n this.ensureParentDir(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.ensureParentDir(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 ensureParentDir(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 writeActualFile(filename: string, data: Buffer): void {\n const filepath = this.getActualFilePath(filename);\n this.ensureParentDir(filepath);\n fs.writeFileSync(filepath, data);\n }\n\n /**\n * Write a file to the diff directory\n */\n writeDiffFile(filename: string, data: Buffer): void {\n const filepath = this.getDiffFilePath(filename);\n this.ensureParentDir(filepath);\n fs.writeFileSync(filepath, data);\n }\n\n /**\n * Check if an expected file exists\n */\n hasExpectedFile(filename: string): boolean {\n const expectedPath = this.getExpectedFilePath(filename);\n return fs.existsSync(expectedPath);\n }\n\n /**\n * Read an expected file\n */\n readExpectedFile(filename: string): Buffer {\n const expectedPath = this.getExpectedFilePath(filename);\n if (!fs.existsSync(expectedPath)) {\n throw new Error(`Expected image not found: ${expectedPath}`);\n }\n return fs.readFileSync(expectedPath);\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\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 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 this.filesystem.writeActualFile(filename, retryScreenshot.screenshotPath);\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 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 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 } = {},\n ): Promise<ScreenshotCaptureDetails> {\n const result: ScreenshotCaptureDetails = { filename };\n\n if (options.skip) {\n result.skipped = true;\n return result;\n }\n\n const saveDiff = extras.saveDiffImage ?? false;\n const diffFilename = extras.diffImageFilename ?? filename;\n const diffOverride = extras.diff;\n\n if (!this.filesystem.hasExpectedFile(filename)) {\n this.logger.debug(\n `Expected image not found for ${filename}, taking screenshot`,\n );\n\n result.filepath = await this.takeScreenshot(page, filename, options);\n } else {\n const { screenshotPath, comparisonResult, diffImagePath } =\n await this.takeScreenshotWithComparison(\n page,\n filename,\n this.filesystem.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 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 },\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 if (!extras.skipBaseNavigation) {\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 },\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 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 },\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":["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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"}
|
package/dist/index.d.cts
CHANGED
|
@@ -75,7 +75,11 @@ declare class ScreenshotFileSystem {
|
|
|
75
75
|
* Ensure the parent directory of a file exists. If not, it creates it.
|
|
76
76
|
* @param filePath - The path to the file.
|
|
77
77
|
*/
|
|
78
|
-
ensureParentDir(filePath: string): void
|
|
78
|
+
ensureParentDir(filePath: string): Promise<void>;
|
|
79
|
+
/**
|
|
80
|
+
* Synchronous version used only during constructor initialization.
|
|
81
|
+
*/
|
|
82
|
+
private ensureParentDirSync;
|
|
79
83
|
/**
|
|
80
84
|
* Remove a directory and all its contents.
|
|
81
85
|
* @param dir - The path to the directory.
|
|
@@ -108,19 +112,19 @@ declare class ScreenshotFileSystem {
|
|
|
108
112
|
/**
|
|
109
113
|
* Write a file to the actual directory
|
|
110
114
|
*/
|
|
111
|
-
writeActualFile(filename: string, data: Buffer): void
|
|
115
|
+
writeActualFile(filename: string, data: Buffer): Promise<void>;
|
|
112
116
|
/**
|
|
113
117
|
* Write a file to the diff directory
|
|
114
118
|
*/
|
|
115
|
-
writeDiffFile(filename: string, data: Buffer): void
|
|
119
|
+
writeDiffFile(filename: string, data: Buffer): Promise<void>;
|
|
116
120
|
/**
|
|
117
121
|
* Check if an expected file exists
|
|
118
122
|
*/
|
|
119
|
-
hasExpectedFile(filename: string): boolean
|
|
123
|
+
hasExpectedFile(filename: string): Promise<boolean>;
|
|
120
124
|
/**
|
|
121
125
|
* Read an expected file
|
|
122
126
|
*/
|
|
123
|
-
readExpectedFile(filename: string): Buffer
|
|
127
|
+
readExpectedFile(filename: string): Promise<Buffer>;
|
|
124
128
|
/**
|
|
125
129
|
* Resolve the actual path of a screenshot file.
|
|
126
130
|
* @param filePath - The path to the screenshot file.
|
|
@@ -170,6 +174,13 @@ interface ScreenshotCaptureExtras {
|
|
|
170
174
|
* skipBaseNavigation is false) to wait for visual stability before capturing.
|
|
171
175
|
*/
|
|
172
176
|
waitForStability?: (page: Page) => Promise<void>;
|
|
177
|
+
/**
|
|
178
|
+
* Timestamp (from `performance.now()`) marking when the screenshot process
|
|
179
|
+
* started — i.e. when the browser first navigated to the page. When provided,
|
|
180
|
+
* the logged duration covers the full journey: navigation → stability waits →
|
|
181
|
+
* capture. When omitted, timing begins at the capture step itself.
|
|
182
|
+
*/
|
|
183
|
+
captureStart?: number;
|
|
173
184
|
}
|
|
174
185
|
declare class ScreenshotTool {
|
|
175
186
|
browserType: "chromium" | "firefox" | "webkit";
|
package/dist/index.d.mts
CHANGED
|
@@ -75,7 +75,11 @@ declare class ScreenshotFileSystem {
|
|
|
75
75
|
* Ensure the parent directory of a file exists. If not, it creates it.
|
|
76
76
|
* @param filePath - The path to the file.
|
|
77
77
|
*/
|
|
78
|
-
ensureParentDir(filePath: string): void
|
|
78
|
+
ensureParentDir(filePath: string): Promise<void>;
|
|
79
|
+
/**
|
|
80
|
+
* Synchronous version used only during constructor initialization.
|
|
81
|
+
*/
|
|
82
|
+
private ensureParentDirSync;
|
|
79
83
|
/**
|
|
80
84
|
* Remove a directory and all its contents.
|
|
81
85
|
* @param dir - The path to the directory.
|
|
@@ -108,19 +112,19 @@ declare class ScreenshotFileSystem {
|
|
|
108
112
|
/**
|
|
109
113
|
* Write a file to the actual directory
|
|
110
114
|
*/
|
|
111
|
-
writeActualFile(filename: string, data: Buffer): void
|
|
115
|
+
writeActualFile(filename: string, data: Buffer): Promise<void>;
|
|
112
116
|
/**
|
|
113
117
|
* Write a file to the diff directory
|
|
114
118
|
*/
|
|
115
|
-
writeDiffFile(filename: string, data: Buffer): void
|
|
119
|
+
writeDiffFile(filename: string, data: Buffer): Promise<void>;
|
|
116
120
|
/**
|
|
117
121
|
* Check if an expected file exists
|
|
118
122
|
*/
|
|
119
|
-
hasExpectedFile(filename: string): boolean
|
|
123
|
+
hasExpectedFile(filename: string): Promise<boolean>;
|
|
120
124
|
/**
|
|
121
125
|
* Read an expected file
|
|
122
126
|
*/
|
|
123
|
-
readExpectedFile(filename: string): Buffer
|
|
127
|
+
readExpectedFile(filename: string): Promise<Buffer>;
|
|
124
128
|
/**
|
|
125
129
|
* Resolve the actual path of a screenshot file.
|
|
126
130
|
* @param filePath - The path to the screenshot file.
|
|
@@ -170,6 +174,13 @@ interface ScreenshotCaptureExtras {
|
|
|
170
174
|
* skipBaseNavigation is false) to wait for visual stability before capturing.
|
|
171
175
|
*/
|
|
172
176
|
waitForStability?: (page: Page) => Promise<void>;
|
|
177
|
+
/**
|
|
178
|
+
* Timestamp (from `performance.now()`) marking when the screenshot process
|
|
179
|
+
* started — i.e. when the browser first navigated to the page. When provided,
|
|
180
|
+
* the logged duration covers the full journey: navigation → stability waits →
|
|
181
|
+
* capture. When omitted, timing begins at the capture step itself.
|
|
182
|
+
*/
|
|
183
|
+
captureStart?: number;
|
|
173
184
|
}
|
|
174
185
|
declare class ScreenshotTool {
|
|
175
186
|
browserType: "chromium" | "firefox" | "webkit";
|
package/dist/index.mjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import fs from "node:fs";
|
|
2
2
|
import gmsd from "@blazediff/gmsd";
|
|
3
3
|
import { getLogger } from "@cappa/logger";
|
|
4
|
-
import { glob, readFile, writeFile } from "node:fs/promises";
|
|
4
|
+
import fsp, { glob, readFile, writeFile } from "node:fs/promises";
|
|
5
5
|
import { PNG } from "pngjs";
|
|
6
6
|
import blazediff from "@blazediff/core";
|
|
7
7
|
import path from "node:path";
|
|
@@ -198,8 +198,7 @@ const compare$1 = (image1, image2, diff, width, height, options) => {
|
|
|
198
198
|
* @returns Comparison result
|
|
199
199
|
*/
|
|
200
200
|
async function compareImagesGMSD(image1, image2, withDiff = false, options = {}) {
|
|
201
|
-
const png1 = await loadPNG$1(image1);
|
|
202
|
-
const png2 = await loadPNG$1(image2);
|
|
201
|
+
const [png1, png2] = await Promise.all([loadPNG$1(image1), loadPNG$1(image2)]);
|
|
203
202
|
const { width, height } = png1;
|
|
204
203
|
if (width !== png2.width || height !== png2.height) return {
|
|
205
204
|
gmsd: Infinity,
|
|
@@ -263,8 +262,7 @@ const compare = (image1, image2, diff, width, height, options) => {
|
|
|
263
262
|
* @returns Comparison result
|
|
264
263
|
*/
|
|
265
264
|
async function compareImages(image1, image2, withDiff = false, options = {}) {
|
|
266
|
-
const png1 = await loadPNG(image1);
|
|
267
|
-
const png2 = await loadPNG(image2);
|
|
265
|
+
const [png1, png2] = await Promise.all([loadPNG(image1), loadPNG(image2)]);
|
|
268
266
|
const { width, height } = png1;
|
|
269
267
|
if (width !== png2.width || height !== png2.height) return {
|
|
270
268
|
numDiffPixels: 0,
|
|
@@ -371,9 +369,9 @@ var ScreenshotFileSystem = class {
|
|
|
371
369
|
this.actual = path.resolve(outputDir, "actual");
|
|
372
370
|
this.expected = path.resolve(outputDir, "expected");
|
|
373
371
|
this.diff = path.resolve(outputDir, "diff");
|
|
374
|
-
this.
|
|
375
|
-
this.
|
|
376
|
-
this.
|
|
372
|
+
this.ensureParentDirSync(this.actual);
|
|
373
|
+
this.ensureParentDirSync(this.expected);
|
|
374
|
+
this.ensureParentDirSync(this.diff);
|
|
377
375
|
}
|
|
378
376
|
clearActual() {
|
|
379
377
|
this.removeDir(this.actual);
|
|
@@ -423,7 +421,7 @@ var ScreenshotFileSystem = class {
|
|
|
423
421
|
const actualPath = path.resolve(this.actual, relativePath);
|
|
424
422
|
const expectedPath = path.resolve(this.expected, relativePath);
|
|
425
423
|
const diffPath = path.resolve(this.diff, relativePath);
|
|
426
|
-
this.
|
|
424
|
+
this.ensureParentDirSync(expectedPath);
|
|
427
425
|
fs.copyFileSync(actualPath, expectedPath);
|
|
428
426
|
if (fs.existsSync(diffPath)) {
|
|
429
427
|
this.copyDiffMetadataToExpected(diffPath, expectedPath);
|
|
@@ -454,7 +452,14 @@ var ScreenshotFileSystem = class {
|
|
|
454
452
|
* Ensure the parent directory of a file exists. If not, it creates it.
|
|
455
453
|
* @param filePath - The path to the file.
|
|
456
454
|
*/
|
|
457
|
-
ensureParentDir(filePath) {
|
|
455
|
+
async ensureParentDir(filePath) {
|
|
456
|
+
const dir = path.dirname(filePath);
|
|
457
|
+
await fsp.mkdir(dir, { recursive: true });
|
|
458
|
+
}
|
|
459
|
+
/**
|
|
460
|
+
* Synchronous version used only during constructor initialization.
|
|
461
|
+
*/
|
|
462
|
+
ensureParentDirSync(filePath) {
|
|
458
463
|
const dir = path.dirname(filePath);
|
|
459
464
|
if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
|
|
460
465
|
}
|
|
@@ -507,33 +512,41 @@ var ScreenshotFileSystem = class {
|
|
|
507
512
|
/**
|
|
508
513
|
* Write a file to the actual directory
|
|
509
514
|
*/
|
|
510
|
-
writeActualFile(filename, data) {
|
|
515
|
+
async writeActualFile(filename, data) {
|
|
511
516
|
const filepath = this.getActualFilePath(filename);
|
|
512
|
-
this.ensureParentDir(filepath);
|
|
513
|
-
|
|
517
|
+
await this.ensureParentDir(filepath);
|
|
518
|
+
await fsp.writeFile(filepath, data);
|
|
514
519
|
}
|
|
515
520
|
/**
|
|
516
521
|
* Write a file to the diff directory
|
|
517
522
|
*/
|
|
518
|
-
writeDiffFile(filename, data) {
|
|
523
|
+
async writeDiffFile(filename, data) {
|
|
519
524
|
const filepath = this.getDiffFilePath(filename);
|
|
520
|
-
this.ensureParentDir(filepath);
|
|
521
|
-
|
|
525
|
+
await this.ensureParentDir(filepath);
|
|
526
|
+
await fsp.writeFile(filepath, data);
|
|
522
527
|
}
|
|
523
528
|
/**
|
|
524
529
|
* Check if an expected file exists
|
|
525
530
|
*/
|
|
526
|
-
hasExpectedFile(filename) {
|
|
531
|
+
async hasExpectedFile(filename) {
|
|
527
532
|
const expectedPath = this.getExpectedFilePath(filename);
|
|
528
|
-
|
|
533
|
+
try {
|
|
534
|
+
await fsp.access(expectedPath);
|
|
535
|
+
return true;
|
|
536
|
+
} catch {
|
|
537
|
+
return false;
|
|
538
|
+
}
|
|
529
539
|
}
|
|
530
540
|
/**
|
|
531
541
|
* Read an expected file
|
|
532
542
|
*/
|
|
533
|
-
readExpectedFile(filename) {
|
|
543
|
+
async readExpectedFile(filename) {
|
|
534
544
|
const expectedPath = this.getExpectedFilePath(filename);
|
|
535
|
-
|
|
536
|
-
|
|
545
|
+
try {
|
|
546
|
+
return await fsp.readFile(expectedPath);
|
|
547
|
+
} catch {
|
|
548
|
+
throw new Error(`Expected image not found: ${expectedPath}`);
|
|
549
|
+
}
|
|
537
550
|
}
|
|
538
551
|
/**
|
|
539
552
|
* Resolve the actual path of a screenshot file.
|
|
@@ -678,7 +691,7 @@ var ScreenshotTool = class {
|
|
|
678
691
|
if (options.skip) return;
|
|
679
692
|
try {
|
|
680
693
|
const filepath = this.filesystem.getActualFilePath(filename);
|
|
681
|
-
this.filesystem.ensureParentDir(filepath);
|
|
694
|
+
await this.filesystem.ensureParentDir(filepath);
|
|
682
695
|
const screenshotOptions = {
|
|
683
696
|
path: filepath,
|
|
684
697
|
fullPage: options.fullPage ?? this.fullPage,
|
|
@@ -761,7 +774,7 @@ var ScreenshotTool = class {
|
|
|
761
774
|
};
|
|
762
775
|
const retryScreenshot = await this.retryScreenshot(page, referenceImage, screenshotSettings, diffOverride);
|
|
763
776
|
if (!retryScreenshot.screenshotPath) throw new Error("Screenshot buffer is undefined");
|
|
764
|
-
this.filesystem.writeActualFile(filename, retryScreenshot.screenshotPath);
|
|
777
|
+
await this.filesystem.writeActualFile(filename, retryScreenshot.screenshotPath);
|
|
765
778
|
this.logger.debug(`Actual screenshot saved: ${filepath}`);
|
|
766
779
|
if (retryScreenshot.passed) this.logger.success(`Screenshot passed visual comparison`);
|
|
767
780
|
else this.logger.error(`Screenshot failed visual comparison`);
|
|
@@ -769,7 +782,7 @@ var ScreenshotTool = class {
|
|
|
769
782
|
if (options.saveDiffImage && retryScreenshot.comparisonResult?.diffBuffer && !retryScreenshot.passed) {
|
|
770
783
|
const diffFilename = options.diffImageFilename || filename;
|
|
771
784
|
diffImagePath = this.filesystem.getDiffFilePath(diffFilename);
|
|
772
|
-
this.filesystem.writeDiffFile(diffFilename, retryScreenshot.comparisonResult.diffBuffer);
|
|
785
|
+
await this.filesystem.writeDiffFile(diffFilename, retryScreenshot.comparisonResult.diffBuffer);
|
|
773
786
|
this.logger.debug(`Diff image saved: ${diffImagePath}`);
|
|
774
787
|
}
|
|
775
788
|
if (retryScreenshot.comparisonResult !== null && typeof retryScreenshot.comparisonResult === "object" && "differentSizes" in retryScreenshot.comparisonResult && retryScreenshot.comparisonResult.differentSizes) {
|
|
@@ -777,7 +790,7 @@ var ScreenshotTool = class {
|
|
|
777
790
|
const diffFilename = options.diffImageFilename || filename;
|
|
778
791
|
diffImagePath = this.filesystem.getDiffFilePath(diffFilename);
|
|
779
792
|
const diffBuffer = createDiffSizePngImage(200, 200);
|
|
780
|
-
this.filesystem.writeDiffFile(diffFilename, diffBuffer);
|
|
793
|
+
await this.filesystem.writeDiffFile(diffFilename, diffBuffer);
|
|
781
794
|
this.logger.debug(`Diff Size image saved: ${diffImagePath}`);
|
|
782
795
|
}
|
|
783
796
|
return {
|
|
@@ -842,14 +855,15 @@ var ScreenshotTool = class {
|
|
|
842
855
|
result.skipped = true;
|
|
843
856
|
return result;
|
|
844
857
|
}
|
|
858
|
+
const start = extras.captureStart ?? performance.now();
|
|
845
859
|
const saveDiff = extras.saveDiffImage ?? false;
|
|
846
860
|
const diffFilename = extras.diffImageFilename ?? filename;
|
|
847
861
|
const diffOverride = extras.diff;
|
|
848
|
-
if (!this.filesystem.hasExpectedFile(filename)) {
|
|
862
|
+
if (!await this.filesystem.hasExpectedFile(filename)) {
|
|
849
863
|
this.logger.debug(`Expected image not found for ${filename}, taking screenshot`);
|
|
850
864
|
result.filepath = await this.takeScreenshot(page, filename, options);
|
|
851
865
|
} else {
|
|
852
|
-
const { screenshotPath, comparisonResult, diffImagePath } = await this.takeScreenshotWithComparison(page, filename, this.filesystem.readExpectedFile(filename), {
|
|
866
|
+
const { screenshotPath, comparisonResult, diffImagePath } = await this.takeScreenshotWithComparison(page, filename, await this.filesystem.readExpectedFile(filename), {
|
|
853
867
|
...options,
|
|
854
868
|
saveDiffImage: saveDiff,
|
|
855
869
|
diffImageFilename: diffFilename
|
|
@@ -858,6 +872,8 @@ var ScreenshotTool = class {
|
|
|
858
872
|
result.comparisonResult = comparisonResult;
|
|
859
873
|
result.diffImagePath = diffImagePath;
|
|
860
874
|
}
|
|
875
|
+
const duration = Math.round(performance.now() - start);
|
|
876
|
+
this.logger.debug(`${filename} captured in ${duration}ms`);
|
|
861
877
|
return result;
|
|
862
878
|
}
|
|
863
879
|
async capture(page, filename, options, extras = {}) {
|
|
@@ -883,7 +899,8 @@ var ScreenshotTool = class {
|
|
|
883
899
|
const baseCaptureResult = await this.captureSingleScreenshot(page, filename, baseOptions, {
|
|
884
900
|
saveDiffImage: baseSaveDiff,
|
|
885
901
|
diffImageFilename: baseDiffFilename,
|
|
886
|
-
diff: baseDiffOverride
|
|
902
|
+
diff: baseDiffOverride,
|
|
903
|
+
captureStart: extras.captureStart
|
|
887
904
|
});
|
|
888
905
|
baseResult.filepath = baseCaptureResult.filepath;
|
|
889
906
|
baseResult.comparisonResult = baseCaptureResult.comparisonResult;
|
|
@@ -961,7 +978,9 @@ var ScreenshotTool = class {
|
|
|
961
978
|
const baseSaveDiff = extras.saveDiffImage ?? false;
|
|
962
979
|
const baseDiffFilename = extras.diffImageFilename ?? baseFilename;
|
|
963
980
|
const baseDiffOverride = extras.diff;
|
|
981
|
+
let baseStart;
|
|
964
982
|
if (!extras.skipBaseNavigation) {
|
|
983
|
+
baseStart = performance.now();
|
|
965
984
|
getLogger().debug(`Going to base URL: ${baseUrl}`);
|
|
966
985
|
await page.goto(baseUrl);
|
|
967
986
|
await this.applyScreenshotOptimizations(page);
|
|
@@ -970,7 +989,8 @@ var ScreenshotTool = class {
|
|
|
970
989
|
const baseCaptureResult = await this.captureSingleScreenshot(page, baseFilename, baseOptions, {
|
|
971
990
|
saveDiffImage: baseSaveDiff,
|
|
972
991
|
diffImageFilename: baseDiffFilename,
|
|
973
|
-
diff: baseDiffOverride
|
|
992
|
+
diff: baseDiffOverride,
|
|
993
|
+
captureStart: extras.captureStart ?? baseStart
|
|
974
994
|
});
|
|
975
995
|
baseResult.filepath = baseCaptureResult.filepath;
|
|
976
996
|
baseResult.comparisonResult = baseCaptureResult.comparisonResult;
|
|
@@ -992,6 +1012,7 @@ var ScreenshotTool = class {
|
|
|
992
1012
|
variantResults.push(variantResult);
|
|
993
1013
|
continue;
|
|
994
1014
|
}
|
|
1015
|
+
const variantStart = performance.now();
|
|
995
1016
|
getLogger().debug(`Going to variant URL: ${variant.url}`);
|
|
996
1017
|
await page.goto(variant.url);
|
|
997
1018
|
await this.applyScreenshotOptimizations(page);
|
|
@@ -1003,7 +1024,8 @@ var ScreenshotTool = class {
|
|
|
1003
1024
|
const variantCaptureResult = await this.captureSingleScreenshot(page, variantFilename, variantOptions, {
|
|
1004
1025
|
saveDiffImage: variantSaveDiff,
|
|
1005
1026
|
diffImageFilename: variantDiffFilename,
|
|
1006
|
-
diff: variantDiffOverride
|
|
1027
|
+
diff: variantDiffOverride,
|
|
1028
|
+
captureStart: variantStart
|
|
1007
1029
|
});
|
|
1008
1030
|
variantResult.filepath = variantCaptureResult.filepath;
|
|
1009
1031
|
variantResult.comparisonResult = variantCaptureResult.comparisonResult;
|
package/dist/index.mjs.map
CHANGED
|
@@ -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 = await loadPNG(image1);\n const png2 = await 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 = await loadPNG(image1);\n const png2 = await 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 { 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.ensureParentDir(this.actual);\n this.ensureParentDir(this.expected);\n this.ensureParentDir(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.ensureParentDir(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 ensureParentDir(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 writeActualFile(filename: string, data: Buffer): void {\n const filepath = this.getActualFilePath(filename);\n this.ensureParentDir(filepath);\n fs.writeFileSync(filepath, data);\n }\n\n /**\n * Write a file to the diff directory\n */\n writeDiffFile(filename: string, data: Buffer): void {\n const filepath = this.getDiffFilePath(filename);\n this.ensureParentDir(filepath);\n fs.writeFileSync(filepath, data);\n }\n\n /**\n * Check if an expected file exists\n */\n hasExpectedFile(filename: string): boolean {\n const expectedPath = this.getExpectedFilePath(filename);\n return fs.existsSync(expectedPath);\n }\n\n /**\n * Read an expected file\n */\n readExpectedFile(filename: string): Buffer {\n const expectedPath = this.getExpectedFilePath(filename);\n if (!fs.existsSync(expectedPath)) {\n throw new Error(`Expected image not found: ${expectedPath}`);\n }\n return fs.readFileSync(expectedPath);\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\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 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 this.filesystem.writeActualFile(filename, retryScreenshot.screenshotPath);\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 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 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 } = {},\n ): Promise<ScreenshotCaptureDetails> {\n const result: ScreenshotCaptureDetails = { filename };\n\n if (options.skip) {\n result.skipped = true;\n return result;\n }\n\n const saveDiff = extras.saveDiffImage ?? false;\n const diffFilename = extras.diffImageFilename ?? filename;\n const diffOverride = extras.diff;\n\n if (!this.filesystem.hasExpectedFile(filename)) {\n this.logger.debug(\n `Expected image not found for ${filename}, taking screenshot`,\n );\n\n result.filepath = await this.takeScreenshot(page, filename, options);\n } else {\n const { screenshotPath, comparisonResult, diffImagePath } =\n await this.takeScreenshotWithComparison(\n page,\n filename,\n this.filesystem.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 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 },\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 if (!extras.skipBaseNavigation) {\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 },\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 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 },\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":";;;;;;;;;AAYA,MAAM,eAAe,OAAO,KAAK;CAC/B;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAC3C,CAAC;AAKF,MAAM,WAAW,IAAI,YAAY,IAAI,CAAC,KAAK,GAAG,UAAU;CACtD,IAAI,IAAI;AACR,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,KAAI,IAAI,IAAI,aAAc,MAAM,IAAK,MAAM;AAG7C,QAAO,MAAM;EACb;;;;;;;;;;;AAYF,UAAU,WAAW,QAAwC;CAC3D,IAAI,SAAS,aAAa;AAE1B,QAAO,SAAS,KAAK,OAAO,QAAQ;EAClC,MAAM,SAAS,OAAO,aAAa,OAAO;EAC1C,MAAM,OAAO,OAAO,SAAS,SAAS,SAAS,GAAG,SAAS,EAAE;EAC7D,MAAM,YAAY,SAAS;EAC3B,MAAM,UAAU,YAAY;AAE5B,MAAI,UAAU,OAAO,OACnB;AAKF,QAAM;GAAE;GAAM,MAFD,OAAO,SAAS,WAAW,QAAQ;GAE5B;GAAQ;GAAQ;AAEpC,WAAS,UAAU;AAEnB,MAAI,SAAS,OACX;;;;;;AAQN,SAAgB,gBAAgB,KAAa,OAAe;CAC1D,MAAM,YAAY,OAAO,KAAK,KAAK,SAAS;CAC5C,MAAM,cAAc,OAAO,KAAK,OAAO,SAAS;CAChD,MAAM,OAAO,OAAO,OAAO;EAAC;EAAW,OAAO,KAAK,CAAC,EAAE,CAAC;EAAE;EAAY,CAAC;CACtE,MAAM,eAAe,OAAO,MAAM,EAAE;CACpC,MAAM,aAAa,OAAO,KAAK,OAAO;AAEtC,cAAa,cAAc,KAAK,QAAQ,EAAE;CAE1C,MAAM,YAAY,OAAO,MAAM,EAAE;AACjC,WAAU,cAAc,MAAM,OAAO,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,EAAE,EAAE;AAEpE,QAAO,OAAO,OAAO;EAAC;EAAc;EAAY;EAAM;EAAU,CAAC;;;;;;AAOnE,SAAgB,MAAM,QAAgB;CACpC,IAAI,MAAM;AAEV,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IAEjC,OAAO,QAAQ,IAAK,UAAU,MAAM,OAAO,MAAO;AAGpD,SAAQ,MAAM,QAAQ;;;;;AAMxB,SAAS,cAAc,QAAyC;AAC9D,MAAK,MAAM,SAAS,WAAW,OAAO,CACpC,KAAI,MAAM,SAAS,OACjB,QAAO;;;;;;AAWb,SAAgB,mBAAmB,QAAgB,UAA2B;AAC5E,KAAI,CAAC,OAAO,SAAS,GAAG,aAAa,OAAO,CAAC,OAAO,aAAa,CAC/D,QAAO;CAGT,MAAM,YAAY,cAAc,OAAO;AACvC,KAAI,CAAC,UACH,QAAO;CAGT,MAAM,aAAa,OAAO,QAAQ,SAAS,CAAC,KAAK,CAAC,KAAK,WACrD,gBAAgB,KAAK,MAAM,CAC5B;AAED,QAAO,OAAO,OAAO;EACnB,OAAO,SAAS,GAAG,UAAU,OAAO;EACpC,GAAG;EACH,OAAO,SAAS,UAAU,OAAO;EAClC,CAAC;;;;;AAMJ,SAAgB,oBAAoB,QAAiC;AACnE,KAAI,CAAC,OAAO,SAAS,GAAG,aAAa,OAAO,CAAC,OAAO,aAAa,CAC/D,QAAO,EAAE;CAGX,MAAM,WAA4B,EAAE;AAEpC,MAAK,MAAM,SAAS,WAAW,OAAO,EAAE;AACtC,MAAI,MAAM,SAAS,OACjB;EAGF,MAAM,iBAAiB,MAAM,KAAK,QAAQ,EAAE;AAC5C,MAAI,iBAAiB,EACnB;EAGF,MAAM,MAAM,MAAM,KAAK,SAAS,UAAU,GAAG,eAAe;AAG5D,WAAS,OAFK,MAAM,KAAK,SAAS,UAAU,iBAAiB,EAAE;;AAKjE,QAAO;;;;;;;;ACvJT,IAAaA,QAAb,MAAaA,MAAI;CACf;CACA;CACA;CAEA,YACE,OACA,YACA,UACA;AACA,OAAK,QAAQ;AACb,OAAK,aAAa;AAClB,OAAK,kBAAkB,EAAE,GAAI,YAAY,EAAE,EAAG;;CAGhD,OAAO,OAAO,OAAe,QAAgB;AAC3C,SAAO,IAAIA,MAAI,IAAIC,IAAS;GAAE;GAAO;GAAQ,CAAC,CAAoB;;CAGpE,aAAa,KAAK,QAAyB;EACzC,MAAM,SAAS,OAAO,WAAW,WAAW,MAAM,SAAS,OAAO,GAAG;EACrE,MAAM,MAAMA,IAAS,KAAK,KAAK,OAAO;EAEtC,MAAM,WAAW,oBAAoB,OAAO;AAE5C,SAAO,IAAID,MACT,KACA,OAAO,WAAW,WAAW,SAAS,KAAA,GACtC,SACD;;CAGH,IAAI,QAAQ;AACV,SAAO,KAAK,MAAM;;CAGpB,IAAI,SAAS;AACX,SAAO,KAAK,MAAM;;CAGpB,IAAI,OAAO;AACT,SAAO,KAAK,MAAM;;CAGpB,IAAI,WAA4B;AAC9B,SAAO,EAAE,GAAG,KAAK,iBAAiB;;CAGpC,YAAY,KAAa,OAAe;AACtC,OAAK,kBAAkB;GAAE,GAAG,KAAK;IAAkB,MAAM;GAAO;;CAGlE,gBAAgB,UAA2B;AACzC,OAAK,kBAAkB,EAAE,GAAG,UAAU;;CAGxC,eAAe,KAAa;EAC1B,MAAM,GAAG,MAAM,GAAG,GAAG,cAAc,KAAK;AACxC,OAAK,kBAAkB;;CAGzB,gBAAgB;AACd,OAAK,kBAAkB,EAAE;;CAG3B,SAAS,SAAyB;EAChC,MAAM,aAAaC,IAAS,KAAK,MAAM,KAAK,OAAO,QAAQ;AAE3D,MAAI,OAAO,KAAK,KAAK,gBAAgB,CAAC,WAAW,EAC/C,QAAO;AAGT,SAAO,mBAAmB,YAAY,KAAK,gBAAgB;;CAG7D,MAAM,KAAK,UAAmB,SAAyB;EACrD,MAAM,aAAa,YAAY,KAAK;AAEpC,MAAI,CAAC,WACH,OAAM,IAAI,MAAM,sCAAsC;AAGxD,QAAM,UAAU,YAAY,KAAK,SAAS,QAAQ,CAAC;;;;;AC5EvD,MAAMC,aACJ,QACA,QACA,MACA,OACA,QACA,YACG;AACH,QAAO,KAAK,QAAQ,QAAQ,MAAM,OAAO,QAAQ,QAAQ;;;;;;;;;;AAW3D,eAAsB,kBACpB,QACA,QACA,WAAoB,OACpB,UAA0B,EAAE,EACJ;CACxB,MAAM,OAAO,MAAMC,UAAQ,OAAO;CAClC,MAAM,OAAO,MAAMA,UAAQ,OAAO;CAElC,MAAM,EAAE,OAAO,WAAW;AAE1B,KAAI,UAAU,KAAK,SAAS,WAAW,KAAK,OAC1C,QAAO;EAAE,MAAM;EAAU,QAAQ;EAAO;CAG1C,MAAM,OAAO,WAAWC,MAAI,OAAO,OAAO,OAAO,GAAG,KAAA;AAEpD,KAAI;EACF,MAAM,OAAOF,UAAQ,KAAK,MAAM,KAAK,MAAM,MAAM,MAAM,OAAO,QAAQ;GACpE,YAAY,QAAQ,cAAc;GAClC,GAAG,QAAQ,KAAK;GACjB,CAAC;AAOF,SAAO;GACL;GACA,YANiB,OACfG,oBAAkB,MAAM,QAAQ,CAAC,UAAU,GAC3C,KAAA;GAKF,QAAQ,SAAS,QAAQ,aAAa;GACvC;UACM,OAAO;AACd,aAAW,CAAC,MAAO,MAAgB,WAAW,gBAAgB;AAE9D,SAAO;GACL,MAAM;GACN,QAAQ;GACR,OAAQ,MAAgB,WAAW;GACpC;;;;;;AAOL,eAAeF,UAAQ,QAAuC;AAC5D,QAAOC,MAAI,KAAK,OAAO;;AAGzB,SAASC,oBAAkB,OAAY,SAAyB;AAC9D,OAAM,YAAY,wBAAwB,OAAO;AAEjD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,MAAI,UAAU,KAAA,EACZ;AAGF,QAAM,YAAY,cAAc,OAAO,OAAO,MAAM,CAAC;;AAGvD,QAAO;;;;;;;;;AAuBT,eAAsB,gBACpB,QACA,QACA,UAA0B,EAAE,EACV;AAGlB,SAFe,MAAM,kBAAkB,QAAQ,QAAQ,OAAO,QAAQ,EAExD;;;;AC5GhB,MAAM,WACJ,QACA,QACA,MACA,OACA,QACA,YACG;AACH,QAAO,UAAU,QAAQ,QAAQ,MAAM,OAAO,QAAQ,QAAQ;;;;;;;;;;AAWhE,eAAsB,cACpB,QACA,QACA,WAAoB,OACpB,UAAsB,EAAE,EACA;CACxB,MAAM,OAAO,MAAM,QAAQ,OAAO;CAClC,MAAM,OAAO,MAAM,QAAQ,OAAO;CAElC,MAAM,EAAE,OAAO,WAAW;AAE1B,KAAI,UAAU,KAAK,SAAS,WAAW,KAAK,OAC1C,QAAO;EACL,eAAe;EACf,aAAa;EACb,mBAAmB;EACnB,QAAQ;EACR,gBAAgB;EACjB;CAGH,MAAM,OAAO,WAAWC,MAAI,OAAO,OAAO,OAAO,GAAG,KAAA;AAEpD,KAAI;EACF,MAAM,gBAAgB,QACpB,KAAK,MACL,KAAK,MACL,MAAM,MACN,OACA,QACA,QACD;EAED,MAAM,cAAc,QAAQ;EAC5B,MAAM,oBAAqB,gBAAgB,cAAe;AAO1D,SAAO;GACL;GACA;GACA;GACA,YARiB,OACf,kBAAkB,MAAM,QAAQ,CAAC,UAAU,GAC3C,KAAA;GAOF,QAAQ,SAAS,mBAAmB,eAAe,QAAQ;GAC3D,gBAAgB;GACjB;UACM,OAAO;AACd,aAAW,CAAC,MAAO,MAAgB,WAAW,gBAAgB;AAE9D,SAAO;GACL,eAAe;GACf,aAAa;GACb,mBAAmB;GACnB,QAAQ;GACR,gBAAgB;GAChB,OAAQ,MAAgB,WAAW;GACpC;;;;;;AAOL,eAAe,QAAQ,QAAuC;AAC5D,QAAOA,MAAI,KAAK,OAAO;;AAGzB,SAAS,kBAAkB,OAAY,SAAqB;AAC1D,OAAM,YAAY,wBAAwB,QAAQ;AAElD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,MAAI,UAAU,KAAA,EACZ;AAGF,QAAM,YAAY,cAAc,OAAO,OAAO,MAAM,CAAC;;AAGvD,QAAO;;;;;;;;;AAuBT,eAAsB,YACpB,QACA,QACA,UAAsB,EAAE,EACN;AAGlB,SAFe,MAAM,cAAc,QAAQ,QAAQ,OAAO,QAAQ,EAEpD;;;;;;;;;AAUhB,MAAM,YACJ,mBACA,eACA,YACG;AACH,KAAI,QAAQ,qBAAqB,QAAQ,cACvC,QACE,qBAAqB,QAAQ,qBAC7B,iBAAiB,QAAQ;AAI7B,KAAI,QAAQ,kBACV,QAAO,qBAAqB,QAAQ;AAGtC,KAAI,QAAQ,cACV,QAAO,iBAAiB,QAAQ;AAIlC,QAAO,kBAAkB;;;;;;AAO3B,SAAgB,uBAAuB,OAAe,QAAwB;CAC5E,MAAM,MAAMA,MAAI,OAAO,OAAO,OAAO;AAErC,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,IAC1B,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK;EAC9B,MAAM,MAAO,QAAQ,IAAI,KAAM;AAC/B,MAAI,KAAK,OAAO;AAChB,MAAI,KAAK,MAAM,KAAK;AACpB,MAAI,KAAK,MAAM,KAAK;AACpB,MAAI,KAAK,MAAM,KAAK;;AAIxB,QAAO,IAAI,UAAU;;;;;;;AClMvB,SAAgB,aACd,SAGgB;AAChB,QAAO;;;;;;;ACFT,IAAa,uBAAb,MAAkC;CAChC;CACA;CACA;CAEA,YAAY,WAAmB;AAC7B,OAAK,SAAS,KAAK,QAAQ,WAAW,SAAS;AAC/C,OAAK,WAAW,KAAK,QAAQ,WAAW,WAAW;AACnD,OAAK,OAAO,KAAK,QAAQ,WAAW,OAAO;AAE3C,OAAK,gBAAgB,KAAK,OAAO;AACjC,OAAK,gBAAgB,KAAK,SAAS;AACnC,OAAK,gBAAgB,KAAK,KAAK;;CAGjC,cAAc;AACZ,OAAK,UAAU,KAAK,OAAO;;CAG7B,YAAY;AACV,OAAK,UAAU,KAAK,KAAK;;CAG3B,uBAA0C;AACxC,SAAO,MAAM,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ,WAAW,CAAC,CAAC;;CAGrE,yBAA4C;AAC1C,SAAO,MAAM,UAAU,KAAK,KAAK,QAAQ,KAAK,UAAU,WAAW,CAAC,CAAC;;CAGvE,qBAAwC;AACtC,SAAO,MAAM,UAAU,KAAK,KAAK,QAAQ,KAAK,MAAM,WAAW,CAAC,CAAC;;CAGnE,qBAAqB;AACnB,OAAK,aAAa;AAClB,OAAK,WAAW;;;;;;;CAQlB,sBAAsB,gBAAwB;EAC5C,MAAM,iBAAiB,KAAK,kBAAkB,eAAe;EAC7D,MAAM,eAAe,KAAK,SAAS,KAAK,QAAQ,eAAe;AAE/D,MAAI,aAAa,WAAW,KAAK,CAC/B,OAAM,IAAI,MACR,0DAA0D,iBAC3D;AAGH,SAAO,KAAK,gBAAgB,aAAa;;;;;;;CAQ3C,cAAc,MAAc;EAC1B,MAAM,wBAAwB,KAAK,SAAS,OAAO,GAAG,OAAO,GAAG,KAAK;AAErE,SAAO,KAAK,gBAAgB,sBAAsB;;;;;;;CAQpD,gBAAwB,cAAsB;EAC5C,MAAM,aAAa,KAAK,QAAQ,KAAK,QAAQ,aAAa;EAC1D,MAAM,eAAe,KAAK,QAAQ,KAAK,UAAU,aAAa;EAC9D,MAAM,WAAW,KAAK,QAAQ,KAAK,MAAM,aAAa;AAEtD,OAAK,gBAAgB,aAAa;AAElC,KAAG,aAAa,YAAY,aAAa;AAEzC,MAAI,GAAG,WAAW,SAAS,EAAE;AAC3B,QAAK,2BAA2B,UAAU,aAAa;AACvD,MAAG,WAAW,SAAS;;AAGzB,SAAO;GACL;GACA;GACA;GACD;;CAGH,2BAAmC,UAAkB,cAAsB;EACzE,MAAM,gBAAgB,KAAK,QAAQ,SAAS,CAAC,aAAa;EAC1D,MAAM,oBAAoB,KAAK,QAAQ,aAAa,CAAC,aAAa;AAElE,MAAI,kBAAkB,UAAU,sBAAsB,OACpD;AAGF,MAAI;GAEF,MAAM,eAAe,oBADF,GAAG,aAAa,SAAS,CACQ;AAEpD,OAAI,OAAO,KAAK,aAAa,CAAC,WAAW,EACvC;GAGF,MAAM,iBAAiB,GAAG,aAAa,aAAa;GAQpD,MAAM,uBAAuB,mBAC3B,gBANqB;IACrB,GAHuB,oBAAoB,eAAe;IAI1D,GAAG;IACJ,CAKA;AACD,MAAG,cAAc,cAAc,qBAAqB;UAC9C;;;;;;CASV,gBAAgB,UAAkB;EAChC,MAAM,MAAM,KAAK,QAAQ,SAAS;AAElC,MAAI,CAAC,GAAG,WAAW,IAAI,CACrB,IAAG,UAAU,KAAK,EAAE,WAAW,MAAM,CAAC;;;;;;CAQ1C,UAAkB,KAAa;AAC7B,MAAI,GAAG,WAAW,IAAI,CACpB,IAAG,OAAO,KAAK;GAAE,WAAW;GAAM,OAAO;GAAM,CAAC;;;;;CAOpD,eAAuB;AACrB,SAAO,KAAK;;;;;CAMd,iBAAyB;AACvB,SAAO,KAAK;;;;;CAMd,aAAqB;AACnB,SAAO,KAAK;;;;;CAMd,kBAAkB,UAA0B;AAC1C,SAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS;;;;;CAM5C,oBAAoB,UAA0B;AAC5C,SAAO,KAAK,QAAQ,KAAK,UAAU,SAAS;;;;;CAM9C,gBAAgB,UAA0B;AACxC,SAAO,KAAK,QAAQ,KAAK,MAAM,SAAS;;;;;CAM1C,gBAAgB,UAAkB,MAAoB;EACpD,MAAM,WAAW,KAAK,kBAAkB,SAAS;AACjD,OAAK,gBAAgB,SAAS;AAC9B,KAAG,cAAc,UAAU,KAAK;;;;;CAMlC,cAAc,UAAkB,MAAoB;EAClD,MAAM,WAAW,KAAK,gBAAgB,SAAS;AAC/C,OAAK,gBAAgB,SAAS;AAC9B,KAAG,cAAc,UAAU,KAAK;;;;;CAMlC,gBAAgB,UAA2B;EACzC,MAAM,eAAe,KAAK,oBAAoB,SAAS;AACvD,SAAO,GAAG,WAAW,aAAa;;;;;CAMpC,iBAAiB,UAA0B;EACzC,MAAM,eAAe,KAAK,oBAAoB,SAAS;AACvD,MAAI,CAAC,GAAG,WAAW,aAAa,CAC9B,OAAM,IAAI,MAAM,6BAA6B,eAAe;AAE9D,SAAO,GAAG,aAAa,aAAa;;;;;;;CAQtC,kBAA0B,UAAkB;AAC1C,MAAI,KAAK,WAAW,SAAS,CAC3B,QAAO;AAGT,SAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS;;CAG5C,gBAAgB,WAA2C,UAAkB;EAC3E,MAAM,eAAe,KAAK,SAAS,KAAK,YAAY,SAAS;AAE7D,MAAI,aAAa,WAAW,KAAK,CAC/B,OAAM,IAAI,MACR,2CAA2C,UAAU,cAAc,WACpE;AAGH,SAAO;;;;;ACnOX,MAAM,yBAA2C;CAC/C,MAAM;CACN,WAAW;CACX,WAAW;CACX,iBAAiB;CACjB,eAAe;CACf,mBAAmB;CACpB;AAED,MAAM,wBAAyC;CAC7C,MAAM;CACN,WAAW;CACX,YAAY;CACZ,GAAG;CACJ;AAkDD,IAAM,iBAAN,MAAqB;CACnB;CACA;CACA;CACA;CACA;CACA,UAA0B;CAC1B,UAAiC;CACjC,OAAoB;CACpB;CACA,WAA6B,EAAE;CAC/B,QAAgB,EAAE;CAClB;CACA;CACA;CACA;CACA;CAEA,YAAY,SAUT;AACD,OAAK,cAAc,QAAQ,eAAe;AAC1C,OAAK,WAAW,QAAQ,aAAa;AACrC,OAAK,WAAW,QAAQ,YAAY;GAAE,OAAO;GAAM,QAAQ;GAAM;AACjE,OAAK,WAAW,QAAQ,YAAY;AACpC,OAAK,YAAY,QAAQ,aAAa;AACtC,OAAK,OAAO,KAAK,mBAAmB,QAAQ,KAAK;AACjD,OAAK,cAAc,KAAK,IAAI,GAAG,QAAQ,eAAe,EAAE;AACxD,OAAK,mBAAmB,QAAQ,oBAAoB;AAEpD,OAAK,SAAS,WAAW;AACzB,OAAK,UAAU,QAAQ,WAAW;AAClC,OAAK,aAAa,IAAI,qBAAqB,KAAK,UAAU;;CAG5D,mBAA2B,MAAiC;AAC1D,MAAI,MAAM,SAAS,OACjB,QAAO;GAAE,GAAG;GAAuB,GAAG;GAAM;AAG9C,SAAO;GAAE,GAAG;GAAwB,GAAG;GAAM,MAAM;GAAS;;CAG9D,iBAAyB,UAAqC;EAC5D,MAAM,OAAO,KAAK,mBAAmB,KAAK,KAAK;AAE/C,MAAI,CAAC,SACH,QAAO;AAGT,MAAI,SAAS,SAAS,UAAU,KAAK,SAAS,OAI5C,QAAO;GAAE,GAFP,KAAK,SAAS,SAAS,OAAO;GAEV,GAAG;GAAU,MAAM;GAAQ;AAGnD,SAAO;GACL,GAAI;GACJ,GAAI;GACJ,MAAM;GACP;;;;;CAMH,MAAM,OAAO;EAQX,MAAM,eANa;GACjB;GACA;GACA;GACD,CAE+B,KAAK;AACrC,MAAI,CAAC,aACH,OAAM,IAAI,MAAM,6BAA6B,KAAK,cAAc;AAGlE,OAAK,UAAU,MAAM,aAAa,OAAO,EACvC,UAAU,KAAK,UAChB,CAAC;EAEF,MAAM,UAAU,MAAM,KAAK,QAAQ,YAAY;EAE/C,MAAM,mBAAmB,OADR,MAAM,QAAQ,SAAS,EACA,eAAe,UAAU,UAAU;AAC3E,QAAM,QAAQ,OAAO;EAGrB,MAAM,UAAU,MAAM,QAAQ,IAC5B,MAAM,KAAK,EAAE,QAAQ,KAAK,aAAa,EAAE,YAAY;GACnD,MAAM,UAAU,MAAM,KAAK,QAAS,WAAW;IAC7C,eAAe;IACf,mBAAmB;IACnB,WAAW,GAAG,iBAAiB;IAC/B,UAAU,KAAK;IAChB,CAAC;AAEF,UAAO;IAAE;IAAS,MADL,MAAM,QAAQ,SAAS;IACZ;IACxB,CACH;AAED,OAAK,WAAW,QAAQ,KAAK,MAAM,EAAE,QAAQ;AAC7C,OAAK,QAAQ,QAAQ,KAAK,MAAM,EAAE,KAAK;AAGvC,OAAK,UAAU,KAAK,SAAS,MAAM;AACnC,OAAK,OAAO,KAAK,MAAM,MAAM;;;;;;CAO/B,MAAM,QAAQ;AACZ,OAAK,MAAM,WAAW,KAAK,SACzB,OAAM,QAAQ,OAAO;AAEvB,MAAI,KAAK,QACP,OAAM,KAAK,QAAQ,OAAO;;;;;CAO9B,MAAM,KAAK,MAAY,KAAa;AAClC,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,0BAA0B;AAE5C,QAAM,KAAK,KAAK,KAAK,EAAE,WAAW,oBAAoB,CAAC;;;;;CAMzD,MAAM,eACJ,MACA,UACA,SACA;AACA,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,0BAA0B;AAG5C,MAAI,QAAQ,KACV;AAGF,MAAI;GAEF,MAAM,WAAW,KAAK,WAAW,kBAAkB,SAAS;AAG5D,QAAK,WAAW,gBAAgB,SAAS;GAGzC,MAAM,oBAAoB;IACxB,MAAM;IACN,UAAU,QAAQ,YAAY,KAAK;IACnC,MAAM;IACN,SAAS;IACT,MAAM,QAAQ;IACd,gBAAgB,QAAQ;IACxB,OAAO;IACP,YAAY;IACZ,OAAO;IACR;AAED,SAAM,KAAK,aAAa,MAAM,QAAQ,UAAU,YAAY;AAC1D,QAAI,QAAQ,OAAO;AACjB,UAAK,OAAO,MACV,WAAW,QAAQ,MAAM,6BAC1B;AACD,WAAM,KAAK,eAAe,QAAQ,MAAM;;AAG1C,UAAM,KAAK,WAAW,kBAAkB;KACxC;AAEF,QAAK,OAAO,QAAQ,qBAAqB,WAAW;AAEpD,UAAO;WACA,OAAO;AACd,QAAK,OAAO,MACV,8BAA8B,KAAK,KAAK,CAAC,IACxC,MAAgB,QAClB;AACD,SAAM;;;;;;;CAQV,MAAc,aACZ,MACA,UACA,QACY;AACZ,MAAI,CAAC,SACH,QAAO,QAAQ;EAGjB,MAAM,mBAAmB,KAAK,cAAc;AAG5C,MACE,oBACA,iBAAiB,UAAU,SAAS,SACpC,iBAAiB,WAAW,SAAS,OAErC,QAAO,QAAQ;AAGjB,QAAM,KAAK,gBAAgB,SAAS;AAEpC,MAAI;AACF,UAAO,MAAM,QAAQ;YACb;AAER,OAAI,iBACF,OAAM,KAAK,gBAAgB,iBAAiB;;;;;;CAQlD,MAAM,qBACJ,MACA,SACiB;AACjB,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,0BAA0B;AAG5C,MAAI,QAAQ,KACV,OAAM,IAAI,MAAM,qBAAqB;AAGvC,MAAI;GAEF,MAAM,oBAAoB;IACxB,UAAU,QAAQ,YAAY,KAAK;IACnC,MAAM;IACN,SAAS;IACT,MAAM,QAAQ;IACd,gBAAgB,QAAQ;IACxB,OAAO;IACP,YAAY;IACZ,OAAO;IACR;AAiBD,UAfe,MAAM,KAAK,aACxB,MACA,QAAQ,UACR,YAAY;AACV,QAAI,QAAQ,OAAO;AACjB,UAAK,OAAO,MACV,WAAW,QAAQ,MAAM,6BAC1B;AACD,WAAM,KAAK,eAAe,QAAQ,MAAM;;AAG1C,WAAO,KAAK,WAAW,kBAAkB;KAE5C;WAGM,OAAO;AACd,QAAK,OAAO,MACV,8BAA8B,KAAK,KAAK,CAAC,IACxC,MAAgB,QAClB;AACD,SAAM;;;CAIV,MAAM,6BACJ,MACA,UACA,gBACA,SAIA,cAKC;AACD,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,0BAA0B;AAG5C,MAAI;GAEF,MAAM,WAAW,KAAK,WAAW,kBAAkB,SAAS;GAE5D,MAAM,qBAAyC;IAC7C,UAAU,QAAQ,YAAY,KAAK;IACnC,MAAM,QAAQ;IACd,gBAAgB,QAAQ;IACxB,OAAO,QAAQ;IACf,UAAU,QAAQ;IACnB;GAED,MAAM,kBAAkB,MAAM,KAAK,gBACjC,MACA,gBACA,oBACA,aACD;AAED,OAAI,CAAC,gBAAgB,eACnB,OAAM,IAAI,MAAM,iCAAiC;AAInD,QAAK,WAAW,gBAAgB,UAAU,gBAAgB,eAAe;AACzE,QAAK,OAAO,MAAM,4BAA4B,WAAW;AAEzD,OAAI,gBAAgB,OAClB,MAAK,OAAO,QAAQ,sCAAsC;OAE1D,MAAK,OAAO,MAAM,sCAAsC;GAG1D,IAAI;AAGJ,OACE,QAAQ,iBACR,gBAAgB,kBAAkB,cAClC,CAAC,gBAAgB,QACjB;IACA,MAAM,eAAe,QAAQ,qBAAqB;AAElD,oBAAgB,KAAK,WAAW,gBAAgB,aAAa;AAE7D,SAAK,WAAW,cACd,cACA,gBAAgB,iBAAiB,WAClC;AAED,SAAK,OAAO,MAAM,qBAAqB,gBAAgB;;AAIzD,OACE,gBAAgB,qBAAqB,QACrC,OAAO,gBAAgB,qBAAqB,YAC5C,oBAAoB,gBAAgB,oBACpC,gBAAgB,iBAAiB,gBACjC;AACA,SAAK,OAAO,KAAK,sDAAsD;IAEvE,MAAM,eAAe,QAAQ,qBAAqB;AAClD,oBAAgB,KAAK,WAAW,gBAAgB,aAAa;IAC7D,MAAM,aAAa,uBAAuB,KAAK,IAAI;AAEnD,SAAK,WAAW,cAAc,cAAc,WAAW;AAEvD,SAAK,OAAO,MAAM,0BAA0B,gBAAgB;;AAG9D,UAAO;IACL,gBAAgB;IAChB,kBAAkB,gBAAgB;IAClC;IACD;WACM,OAAO;AACd,QAAK,OAAO,MACV,8CAA8C,KAAK,KAAK,CAAC,IACxD,MAAgB,QAClB;AACD,SAAM;;;CAIV,MAAM,gBACJ,MACA,gBACA,SACA,cACA;EACA,MAAM,aAAa,KAAK,iBAAiB,aAAa;AAEtD,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,IAChC,KAAI;GACF,MAAM,mBAAmB,MAAM,KAAK,qBAAqB,MAAM;IAC7D,GAAG;IACH,OAAO,KAAK,mBAAmB,GAAG,QAAQ,SAAS,EAAE;IACtD,CAAC;AAEF,OAAI,CAAC,iBACH,OAAM,IAAI,MAAM,iCAAiC;GAGnD,MAAM,mBACJ,WAAW,SAAS,SAChB,MAAM,kBACJ,kBACA,gBACA,MACA,WACD,GACD,MAAM,cACJ,kBACA,gBACA,MACA,WACD;AAGP,OAAI,MAAM,KAAK,UAAU,KAAK,CAAC,iBAAiB,QAAQ;AACtD,SAAK,OAAO,MACV,oCAAoC,KAAK,QAAQ,UAClD;AACD,WAAO;KACL,gBAAgB;KAChB;KACA,QAAQ;KACT;;AAGH,OAAI,iBAAiB,OACnB,QAAO;IACL,gBAAgB;IAChB;IACA,QAAQ;IACT;QACI;IACL,MAAM,UACJ,mBAAmB,mBACf,iBAAiB,iBACf,0BACA,GAAG,iBAAiB,cAAc,qBAAqB,iBAAiB,kBAAkB,QAAQ,EAAE,CAAC,MACvG,cAAc,iBAAiB,KAAK,QAAQ,EAAE;AAEpD,SAAK,OAAO,KACV,yCAAyC,KAAK,mBAAmB,IAAI,GAAG,QAAQ,SAAS,EAAE,CAAC,6BAA6B,UAC1H;;WAEI,OAAO;AACd,QAAK,OAAO,MACV,iCAAiC,IAAI,EAAE,YACtC,MAAgB,QAClB;;AAIL,SAAO;GACL,gBAAgB;GAChB,kBAAkB;GAClB,QAAQ;GACT;;CAGH,mBAAmB,UAAkB,SAAoC;AACvE,MAAI,QAAQ,SACV,QAAO,QAAQ;EAGjB,MAAM,SAAS,KAAK,MAAM,SAAS;EAMnC,MAAM,SALc,QAAQ,GACzB,MAAM,CACN,QAAQ,oBAAoB,IAAI,CAChC,QAAQ,OAAO,IAAI,CACnB,QAAQ,UAAU,GAAG,IACM;EAC9B,MAAM,MAAM,OAAO,OAAO;EAC1B,MAAM,cAAc,GAAG,OAAO,KAAK,IAAI,SAAS;AAEhD,SAAO,OAAO,MAAM,KAAK,KAAK,OAAO,KAAK,YAAY,GAAG;;;;;CAM3D,MAAc,wBACZ,MACA,UACA,SACA,SAII,EAAE,EAC6B;EACnC,MAAM,SAAmC,EAAE,UAAU;AAErD,MAAI,QAAQ,MAAM;AAChB,UAAO,UAAU;AACjB,UAAO;;EAGT,MAAM,WAAW,OAAO,iBAAiB;EACzC,MAAM,eAAe,OAAO,qBAAqB;EACjD,MAAM,eAAe,OAAO;AAE5B,MAAI,CAAC,KAAK,WAAW,gBAAgB,SAAS,EAAE;AAC9C,QAAK,OAAO,MACV,gCAAgC,SAAS,qBAC1C;AAED,UAAO,WAAW,MAAM,KAAK,eAAe,MAAM,UAAU,QAAQ;SAC/D;GACL,MAAM,EAAE,gBAAgB,kBAAkB,kBACxC,MAAM,KAAK,6BACT,MACA,UACA,KAAK,WAAW,iBAAiB,SAAS,EAC1C;IACE,GAAG;IACH,eAAe;IACf,mBAAmB;IACpB,EACD,aACD;AAEH,UAAO,WAAW;AAClB,UAAO,mBAAmB;AAC1B,UAAO,gBAAgB;;AAGzB,SAAO;;CAGT,MAAM,QACJ,MACA,UACA,SACA,SAAkC,EAAE,EACF;AAClC,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,0BAA0B;EAG5C,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,gBAAgB;EAC1C,MAAM,aAAuC,EAAE,UAAU;EACzD,MAAM,iBAAoD,EAAE;EAE5D,MAAM,eAAe,OAAO,iBAAiB;EAC7C,MAAM,mBAAmB,OAAO,qBAAqB;EACrD,MAAM,mBAAmB,OAAO;AAEhC,MAAI,YAAY,KACd,QAAO;GACL,MAAM;IAAE,GAAG;IAAY,SAAS;IAAM;GACtC,UAAU,SAAS,KAAK,aAAa;IACnC,IAAI,QAAQ;IACZ,OAAO,QAAQ;IACf,UAAU,KAAK,mBAAmB,UAAU,QAAQ;IACpD,SAAS;IACV,EAAE;GACJ;EAIH,MAAM,oBAAoB,MAAM,KAAK,wBACnC,MACA,UACA,aACA;GACE,eAAe;GACf,mBAAmB;GACnB,MAAM;GACP,CACF;AAED,aAAW,WAAW,kBAAkB;AACxC,aAAW,mBAAmB,kBAAkB;AAChD,aAAW,gBAAgB,kBAAkB;AAC7C,aAAW,UAAU,kBAAkB;AAEvC,OAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,kBAAkB,KAAK,mBAAmB,UAAU,QAAQ;GAClE,MAAM,iBAAqC;IACzC,GAAG;IACH,GAAG,QAAQ;IACZ;GAED,MAAM,gBAAiD;IACrD,IAAI,QAAQ;IACZ,OAAO,QAAQ;IACf,UAAU;IACX;AAED,OAAI,eAAe,MAAM;AACvB,kBAAc,UAAU;AACxB,mBAAe,KAAK,cAAc;AAClC;;GAGF,MAAM,eAAe,OAAO,WAAW,QAAQ;GAC/C,MAAM,kBAAkB,cAAc,iBAAiB;GACvD,MAAM,sBACJ,cAAc,qBAAqB;GACrC,MAAM,sBAAsB,cAAc,QAAQ;GAElD,MAAM,uBAAuB,MAAM,KAAK,wBACtC,MACA,iBACA,gBACA;IACE,eAAe;IACf,mBAAmB;IACnB,MAAM;IACP,CACF;AAED,iBAAc,WAAW,qBAAqB;AAC9C,iBAAc,mBAAmB,qBAAqB;AACtD,iBAAc,gBAAgB,qBAAqB;AACnD,iBAAc,UAAU,qBAAqB;AAE7C,kBAAe,KAAK,cAAc;;AAGpC,SAAO;GACL,MAAM;GACN,UAAU;GACX;;;;;CAMH,MAAc,6BAA6B,MAAY;AACrD,QAAM,KAAK,YAAY,EACrB,SAAS;;;;;;;;;;;;;;;;;;;;SAqBV,CAAC;;;;;CAMJ,MAAM,oBACJ,MACA,cACA,SACA,aACA,UACA,SAAkC,EAAE,EACF;AAClC,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,0BAA0B;EAG5C,MAAM,aAAuC,EAAE,UAAU,cAAc;EACvE,MAAM,iBAAoD,EAAE;EAE5D,MAAM,eAAe,OAAO,iBAAiB;EAC7C,MAAM,mBAAmB,OAAO,qBAAqB;EACrD,MAAM,mBAAmB,OAAO;AAGhC,MAAI,CAAC,OAAO,oBAAoB;AAC9B,cAAW,CAAC,MAAM,sBAAsB,UAAU;AAClD,SAAM,KAAK,KAAK,QAAQ;AACxB,SAAM,KAAK,6BAA6B,KAAK;AAC7C,SAAM,OAAO,mBAAmB,KAAK;;EAEvC,MAAM,oBAAoB,MAAM,KAAK,wBACnC,MACA,cACA,aACA;GACE,eAAe;GACf,mBAAmB;GACnB,MAAM;GACP,CACF;AAED,aAAW,WAAW,kBAAkB;AACxC,aAAW,mBAAmB,kBAAkB;AAChD,aAAW,gBAAgB,kBAAkB;AAC7C,aAAW,UAAU,kBAAkB;AAGvC,OAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,kBACJ,QAAQ,YAAY,KAAK,mBAAmB,cAAc,QAAQ;GACpE,MAAM,iBAAqC;IACzC,GAAG;IACH,GAAG,QAAQ;IACZ;GAED,MAAM,gBAAiD;IACrD,IAAI,QAAQ;IACZ,OAAO,QAAQ;IACf,UAAU;IACX;AAED,OAAI,eAAe,MAAM;AACvB,kBAAc,UAAU;AACxB,mBAAe,KAAK,cAAc;AAClC;;AAIF,cAAW,CAAC,MAAM,yBAAyB,QAAQ,MAAM;AACzD,SAAM,KAAK,KAAK,QAAQ,IAAI;AAC5B,SAAM,KAAK,6BAA6B,KAAK;AAC7C,SAAM,OAAO,mBAAmB,KAAK;GAErC,MAAM,eAAe,OAAO,WAAW,QAAQ;GAC/C,MAAM,kBAAkB,cAAc,iBAAiB;GACvD,MAAM,sBACJ,cAAc,qBAAqB;GACrC,MAAM,sBAAsB,cAAc,QAAQ;GAElD,MAAM,uBAAuB,MAAM,KAAK,wBACtC,MACA,iBACA,gBACA;IACE,eAAe;IACf,mBAAmB;IACnB,MAAM;IACP,CACF;AAED,iBAAc,WAAW,qBAAqB;AAC9C,iBAAc,mBAAmB,qBAAqB;AACtD,iBAAc,gBAAgB,qBAAqB;AACnD,iBAAc,UAAU,qBAAqB;AAE7C,kBAAe,KAAK,cAAc;;AAGpC,SAAO;GACL,MAAM;GACN,UAAU;GACX;;;;;CAMH,mBAAmB,GAAW,OAAuB;AACnD,SAAO,IAAI,IAAI,MAAM,MAAM,IAAI,MAAM,SAAS,KAAK;;;;;CAMrD,gBAAgB,OAAqB;AACnC,MAAI,QAAQ,EACV,OAAM,IAAI,MAAM,cAAc,MAAM,uBAAuB;AAG7D,MAAI,SAAS,KAAK,MAAM,OACtB,OAAM,IAAI,MACR,cAAc,MAAM,qBAAqB,KAAK,MAAM,SACrD;AAGH,MAAI,CAAC,KAAK,MAAM,OACd,OAAM,IAAI,MAAM,cAAc,MAAM,eAAe;AAGrD,SAAO,KAAK,MAAM"}
|
|
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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"}
|