devlens-mcp 0.3.0

package/dist/src/utils/image-preprocess.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Image preprocessing utilities for removing Figma presentation artifacts
+ *
+ * Handles:
+ * - Rounded corners from Figma frame exports
+ * - Grey/black backgrounds and borders
+ * - Uniform colored bars (top/bottom/sides)
+ * - Transparent padding around content
+ */
+export interface PreprocessOptions {
+    /** Strategy to use for artifact removal */
+    strategy?: "auto" | "trim" | "alpha" | "content" | "none";
+    /** Threshold for trim strategy (0-255, default 10) */
+    trimThreshold?: number;
+    /** Whether to apply additional trim after content detection */
+    aggressiveTrim?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface PreprocessResult {
+    /** Processed image buffer */
+    buffer: Buffer;
+    /** Strategy that was applied (may include variant info like "auto-content" or "trim") */
+    appliedStrategy: string;
+    /** Artifacts that were detected and removed */
+    artifactsRemoved: string[];
+    /** Original dimensions */
+    originalDimensions: {
+        width: number;
+        height: number;
+    };
+    /** Final dimensions after preprocessing */
+    finalDimensions: {
+        width: number;
+        height: number;
+    };
+    /** Crop information */
+    cropInfo: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Main preprocessing function - automatically detects and removes Figma artifacts
+ */
+export declare function preprocessImage(buffer: Buffer, options?: PreprocessOptions): Promise<PreprocessResult>;
+//# sourceMappingURL=image-preprocess.d.ts.map

package/dist/src/utils/image-preprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-preprocess.d.ts","sourceRoot":"","sources":["../../../src/utils/image-preprocess.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1D,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0BAA0B;IAC1B,kBAAkB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,2CAA2C;IAC3C,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,uBAAuB;IACvB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAkQD;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAgI3B"}

package/dist/src/utils/image-preprocess.js

@@ -0,0 +1,322 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preprocessImage = preprocessImage;
+const sharp_1 = __importDefault(require("sharp"));
+const pngjs_1 = require("pngjs");
+/**
+ * Analyze image edges to detect uniform borders or bars
+ */
+async function analyzeEdges(buffer) {
+    const png = pngjs_1.PNG.sync.read(buffer);
+    const { width, height } = png;
+    // Sample corner pixels (50x50 region in top-left)
+    const cornerSize = Math.min(50, Math.floor(width / 4), Math.floor(height / 4));
+    const cornerPixels = [];
+    for (let y = 0; y < cornerSize; y++) {
+        for (let x = 0; x < cornerSize; x++) {
+            const idx = (width * y + x) * 4;
+            cornerPixels.push({
+                r: png.data[idx],
+                g: png.data[idx + 1],
+                b: png.data[idx + 2],
+                a: png.data[idx + 3],
+            });
+        }
+    }
+    // Calculate average corner color
+    const sum = cornerPixels.reduce((acc, p) => ({
+        r: acc.r + p.r,
+        g: acc.g + p.g,
+        b: acc.b + p.b,
+        a: acc.a + p.a,
+    }), { r: 0, g: 0, b: 0, a: 0 });
+    const count = cornerPixels.length;
+    const avgCornerColor = {
+        r: Math.round(sum.r / count),
+        g: Math.round(sum.g / count),
+        b: Math.round(sum.b / count),
+        a: Math.round(sum.a / count),
+    };
+    // Check if corners have uniform color (grey, white, or black)
+    const isGrey = Math.abs(avgCornerColor.r - avgCornerColor.g) < 10 &&
+        Math.abs(avgCornerColor.g - avgCornerColor.b) < 10;
+    const isDark = avgCornerColor.r < 50 && avgCornerColor.g < 50 && avgCornerColor.b < 50;
+    const isLight = avgCornerColor.r > 180 && avgCornerColor.g > 180 && avgCornerColor.b > 180;
+    return {
+        hasUniformBorder: isGrey && (isDark || isLight),
+        avgCornerColor,
+        isDarkBorder: isGrey && isDark,
+        isLightBorder: isGrey && isLight,
+    };
+}
+/**
+ * Find content bounds by analyzing pixel patterns
+ * Detects and excludes:
+ * - Dark bars (black backgrounds)
+ * - Light grey/white borders
+ * - Transparent padding
+ */
+async function findContentBounds(buffer) {
+    const png = pngjs_1.PNG.sync.read(buffer);
+    const { width, height } = png;
+    // Track which rows and columns have meaningful content
+    const rowHasContent = new Array(height).fill(false);
+    const colHasContent = new Array(width).fill(false);
+    // Analyze each row
+    for (let y = 0; y < height; y++) {
+        let contentPixels = 0;
+        for (let x = 0; x < width; x++) {
+            const idx = (width * y + x) * 4;
+            const r = png.data[idx];
+            const g = png.data[idx + 1];
+            const b = png.data[idx + 2];
+            const alpha = png.data[idx + 3];
+            // Pixel is "content" if it's not a presentation artifact
+            const isDarkBar = r < 30 && g < 30 && b < 30;
+            const isLightGreyBorder = r > 180 && g > 180 && b > 180 &&
+                Math.abs(r - g) < 5 && Math.abs(g - b) < 5;
+            const isTransparent = alpha < 10;
+            if (!isDarkBar && !isLightGreyBorder && !isTransparent) {
+                contentPixels++;
+            }
+        }
+        // Row has content if more than 10% of pixels are content
+        if (contentPixels > width * 0.1) {
+            rowHasContent[y] = true;
+        }
+    }
+    // Analyze each column
+    for (let x = 0; x < width; x++) {
+        let contentPixels = 0;
+        for (let y = 0; y < height; y++) {
+            const idx = (width * y + x) * 4;
+            const r = png.data[idx];
+            const g = png.data[idx + 1];
+            const b = png.data[idx + 2];
+            const alpha = png.data[idx + 3];
+            const isDarkBar = r < 30 && g < 30 && b < 30;
+            const isLightGreyBorder = r > 180 && g > 180 && b > 180 &&
+                Math.abs(r - g) < 5 && Math.abs(g - b) < 5;
+            const isTransparent = alpha < 10;
+            if (!isDarkBar && !isLightGreyBorder && !isTransparent) {
+                contentPixels++;
+            }
+        }
+        if (contentPixels > height * 0.1) {
+            colHasContent[x] = true;
+        }
+    }
+    // Find bounding box
+    const minY = rowHasContent.indexOf(true);
+    const maxY = rowHasContent.lastIndexOf(true);
+    const minX = colHasContent.indexOf(true);
+    const maxX = colHasContent.lastIndexOf(true);
+    if (minY === -1 || minX === -1) {
+        return null; // Could not detect content
+    }
+    return {
+        left: minX,
+        top: minY,
+        width: maxX - minX + 1,
+        height: maxY - minY + 1,
+    };
+}
+/**
+ * Apply trim strategy using Sharp's built-in trim
+ */
+async function applyTrimStrategy(buffer, threshold) {
+    const originalMeta = await (0, sharp_1.default)(buffer).metadata();
+    const result = await (0, sharp_1.default)(buffer)
+        .trim({ threshold })
+        .toBuffer({ resolveWithObject: true });
+    return {
+        buffer: result.data,
+        removed: {
+            top: 0, // Sharp doesn't expose exact trim amounts
+            bottom: 0,
+            left: 0,
+            right: 0,
+        },
+    };
+}
+/**
+ * Apply alpha channel cropping
+ */
+async function applyAlphaCrop(buffer) {
+    const png = pngjs_1.PNG.sync.read(buffer);
+    const { width, height } = png;
+    let minX = width, minY = height, maxX = 0, maxY = 0;
+    const alphaThreshold = 10;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const idx = (width * y + x) * 4;
+            const alpha = png.data[idx + 3];
+            if (alpha > alphaThreshold) {
+                minX = Math.min(minX, x);
+                minY = Math.min(minY, y);
+                maxX = Math.max(maxX, x);
+                maxY = Math.max(maxY, y);
+            }
+        }
+    }
+    const bounds = {
+        left: minX,
+        top: minY,
+        width: maxX - minX + 1,
+        height: maxY - minY + 1,
+    };
+    // Only crop if we found meaningful bounds
+    if (bounds.width < 10 || bounds.height < 10 ||
+        bounds.width === width || bounds.height === height) {
+        return null;
+    }
+    const cropped = await (0, sharp_1.default)(buffer)
+        .extract(bounds)
+        .toBuffer();
+    return { buffer: cropped, bounds };
+}
+/**
+ * Apply content-based detection and cropping
+ */
+async function applyContentCrop(buffer, aggressiveTrim) {
+    const bounds = await findContentBounds(buffer);
+    if (!bounds || bounds.width < 50 || bounds.height < 50) {
+        return null; // Invalid or too small
+    }
+    let processed = await (0, sharp_1.default)(buffer)
+        .extract(bounds)
+        .toBuffer();
+    // Apply additional trim to clean up edges
+    if (aggressiveTrim) {
+        try {
+            const trimmed = await (0, sharp_1.default)(processed)
+                .trim({ threshold: 15 })
+                .toBuffer({ resolveWithObject: true });
+            processed = trimmed.data;
+        }
+        catch {
+            // Trim failed, use extracted version
+        }
+    }
+    return { buffer: processed, bounds };
+}
+/**
+ * Main preprocessing function - automatically detects and removes Figma artifacts
+ */
+async function preprocessImage(buffer, options = {}) {
+    const { strategy = "auto", trimThreshold = 10, aggressiveTrim = true, debug = false, } = options;
+    const originalMeta = await (0, sharp_1.default)(buffer).metadata();
+    const originalDimensions = {
+        width: originalMeta.width,
+        height: originalMeta.height,
+    };
+    const artifactsRemoved = [];
+    let processedBuffer = buffer;
+    let appliedStrategy = strategy;
+    let cropInfo = {
+        left: 0,
+        top: 0,
+        width: originalDimensions.width,
+        height: originalDimensions.height,
+    };
+    // Strategy: none - return original
+    if (strategy === "none") {
+        return {
+            buffer,
+            appliedStrategy: "none",
+            artifactsRemoved: [],
+            originalDimensions,
+            finalDimensions: originalDimensions,
+            cropInfo,
+        };
+    }
+    // Strategy: trim - use Sharp's built-in trim
+    if (strategy === "trim") {
+        const trimResult = await applyTrimStrategy(buffer, trimThreshold);
+        processedBuffer = trimResult.buffer;
+        artifactsRemoved.push("uniform-borders");
+        appliedStrategy = "trim";
+    }
+    // Strategy: alpha - crop to alpha channel bounds
+    else if (strategy === "alpha") {
+        const alphaResult = await applyAlphaCrop(buffer);
+        if (alphaResult) {
+            processedBuffer = alphaResult.buffer;
+            cropInfo = alphaResult.bounds;
+            artifactsRemoved.push("transparent-padding");
+            appliedStrategy = "alpha";
+        }
+        else {
+            appliedStrategy = "alpha-failed-fallback-none";
+        }
+    }
+    // Strategy: content - detect content bounds
+    else if (strategy === "content") {
+        const contentResult = await applyContentCrop(buffer, aggressiveTrim);
+        if (contentResult) {
+            processedBuffer = contentResult.buffer;
+            cropInfo = contentResult.bounds;
+            artifactsRemoved.push("presentation-artifacts");
+            appliedStrategy = "content";
+        }
+        else {
+            appliedStrategy = "content-failed-fallback-none";
+        }
+    }
+    // Strategy: auto - try strategies in order
+    else if (strategy === "auto") {
+        const edgeAnalysis = await analyzeEdges(buffer);
+        if (debug) {
+            console.log("[preprocess] Edge analysis:", edgeAnalysis);
+        }
+        // Try content detection first (most comprehensive)
+        const contentResult = await applyContentCrop(buffer, aggressiveTrim);
+        if (contentResult) {
+            processedBuffer = contentResult.buffer;
+            cropInfo = contentResult.bounds;
+            if (edgeAnalysis.isDarkBorder) {
+                artifactsRemoved.push("dark-bars");
+            }
+            if (edgeAnalysis.isLightBorder) {
+                artifactsRemoved.push("light-borders");
+            }
+            if (!edgeAnalysis.hasUniformBorder) {
+                artifactsRemoved.push("presentation-artifacts");
+            }
+            appliedStrategy = "auto-content";
+        }
+        else {
+            // Fallback to trim
+            const trimResult = await applyTrimStrategy(buffer, trimThreshold);
+            processedBuffer = trimResult.buffer;
+            artifactsRemoved.push("uniform-borders");
+            appliedStrategy = "auto-trim";
+        }
+    }
+    const finalMeta = await (0, sharp_1.default)(processedBuffer).metadata();
+    const finalDimensions = {
+        width: finalMeta.width,
+        height: finalMeta.height,
+    };
+    if (debug) {
+        console.log("[preprocess] Result:", {
+            appliedStrategy,
+            artifactsRemoved,
+            originalDimensions,
+            finalDimensions,
+            cropInfo,
+        });
+    }
+    return {
+        buffer: processedBuffer,
+        appliedStrategy,
+        artifactsRemoved,
+        originalDimensions,
+        finalDimensions,
+        cropInfo,
+    };
+}
+//# sourceMappingURL=image-preprocess.js.map

package/dist/src/utils/image-preprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-preprocess.js","sourceRoot":"","sources":["../../../src/utils/image-preprocess.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/retry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Generic retry utility for wrapping flaky operations.
+ * Supports fixed delay and exponential backoff.
+ */
+export interface RetryOptions {
+    /** Maximum number of attempts (default: 2) */
+    maxAttempts?: number;
+    /** Delay between retries in ms (default: 500) */
+    delayMs?: number;
+    /** Use exponential backoff (default: false) */
+    backoff?: boolean;
+    /** Called on each retry with the attempt number and error */
+    onRetry?: (attempt: number, error: Error) => void;
+}
+/**
+ * Retry an async function up to `maxAttempts` times.
+ * On failure, waits `delayMs` (optionally with exponential backoff) before retrying.
+ * Throws the last error if all attempts fail.
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/src/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACnD;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/dist/src/utils/retry.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Generic retry utility for wrapping flaky operations.
+ * Supports fixed delay and exponential backoff.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retry = retry;
+/**
+ * Retry an async function up to `maxAttempts` times.
+ * On failure, waits `delayMs` (optionally with exponential backoff) before retrying.
+ * Throws the last error if all attempts fail.
+ */
+async function retry(fn, options = {}) {
+    const { maxAttempts = 2, delayMs = 500, backoff = false, onRetry, } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < maxAttempts) {
+                onRetry?.(attempt, error);
+                const waitMs = backoff
+                    ? delayMs * Math.pow(2, attempt - 1)
+                    : delayMs;
+                await new Promise((r) => setTimeout(r, waitMs));
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/src/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/utils/retry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAkBH,sBA6BC;AAlCD;;;;GAIG;AACI,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,EACJ,WAAW,GAAG,CAAC,EACf,OAAO,GAAG,GAAG,EACb,OAAO,GAAG,KAAK,EACf,OAAO,GACR,GAAG,OAAO,CAAC;IAEZ,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;gBAC1B,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC1B,MAAM,MAAM,GAAG,OAAO;oBACpB,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;oBACpC,CAAC,CAAC,OAAO,CAAC;gBACZ,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/src/visual/comparator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Visual comparison engine — compares screenshots against reference images
+ * using pixel-level diffing. Returns a similarity score and a diff image.
+ */
+export interface ComparisonResult {
+    /** Similarity score between 0.0 (completely different) and 1.0 (identical) */
+    similarity: number;
+    /** Number of different pixels */
+    diffPixels: number;
+    /** Total pixels compared */
+    totalPixels: number;
+    /** Path to the diff image (red = differences) */
+    diffImagePath: string;
+    /** Human-readable summary */
+    summary: string;
+}
+export interface PreprocessConfig {
+    /** Whether to enable preprocessing */
+    enabled: boolean;
+    /** Strategy to use for artifact removal */
+    strategy?: "auto" | "trim" | "alpha" | "content" | "none";
+    /** Threshold for trim strategy (0-255) */
+    trimThreshold?: number;
+    /** Apply aggressive trimming after content detection */
+    aggressiveTrim?: boolean;
+    /** Save preprocessed image for debugging */
+    saveDebugImage?: boolean;
+}
+export interface ComparisonOptions {
+    /** Color difference threshold (0-1). Lower = stricter. Default: 0.1 */
+    threshold?: number;
+    /**
+     * How to handle dimension mismatches:
+     * - "fit" (default): resize both to the smaller dimensions
+     * - "scale": resize smaller image up to the larger dimensions
+     * - "crop": extract the overlapping region from both
+     */
+    resizeStrategy?: "fit" | "scale" | "crop";
+    /**
+     * Preprocess reference image to remove Figma artifacts.
+     * Can be boolean (use defaults) or config object for fine control.
+     * Defaults to false for backward compatibility.
+     */
+    preprocessReference?: boolean | PreprocessConfig;
+}
+/**
+ * Compare a screenshot buffer against a reference image buffer.
+ * Both images are resized/cropped to match dimensions before comparison.
+ */
+export declare function compareScreenshots(screenshotBuffer: Buffer, referenceBuffer: Buffer, options?: ComparisonOptions): Promise<ComparisonResult>;
+//# sourceMappingURL=comparator.d.ts.map

package/dist/src/visual/comparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparator.d.ts","sourceRoot":"","sources":["../../../src/visual/comparator.ts"],"names":[],"mappings":"AAKA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1D,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAC1C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAgI3B"}

package/dist/src/visual/comparator.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareScreenshots = compareScreenshots;
+const promises_1 = require("fs/promises");
+const pngjs_1 = require("pngjs");
+const pixelmatch_1 = __importDefault(require("pixelmatch"));
+const image_preprocess_js_1 = require("../utils/image-preprocess.js");
+/**
+ * Compare a screenshot buffer against a reference image buffer.
+ * Both images are resized/cropped to match dimensions before comparison.
+ */
+async function compareScreenshots(screenshotBuffer, referenceBuffer, options = {}) {
+    const { threshold = 0.1, resizeStrategy = "fit", preprocessReference } = options;
+    // Preprocess reference image if requested
+    let processedReferenceBuffer = referenceBuffer;
+    if (preprocessReference) {
+        const preprocessConfig = typeof preprocessReference === "boolean"
+            ? { strategy: "auto" }
+            : {
+                strategy: preprocessReference.strategy,
+                trimThreshold: preprocessReference.trimThreshold,
+                aggressiveTrim: preprocessReference.aggressiveTrim,
+            };
+        const preprocessResult = await (0, image_preprocess_js_1.preprocessImage)(referenceBuffer, preprocessConfig);
+        processedReferenceBuffer = preprocessResult.buffer;
+        // Save debug image if requested
+        if (typeof preprocessReference === "object" && preprocessReference.saveDebugImage) {
+            const debugPath = `/tmp/devlens-preprocessed-${Date.now()}.png`;
+            await (0, promises_1.writeFile)(debugPath, processedReferenceBuffer);
+            console.log(`[comparator] Preprocessed reference saved to: ${debugPath}`);
+            console.log(`[comparator] Removed artifacts: ${preprocessResult.artifactsRemoved.join(", ") || "none"}`);
+            console.log(`[comparator] Strategy used: ${preprocessResult.appliedStrategy}`);
+        }
+    }
+    // Decode both PNGs
+    const screenshot = pngjs_1.PNG.sync.read(screenshotBuffer);
+    const reference = pngjs_1.PNG.sync.read(processedReferenceBuffer);
+    // Resize if dimensions don't match
+    let img1 = screenshot;
+    let img2 = reference;
+    if (screenshot.width !== reference.width ||
+        screenshot.height !== reference.height) {
+        const sharp = (await import("sharp")).default;
+        if (resizeStrategy === "crop") {
+            // Extract the overlapping region from both images
+            const targetWidth = Math.min(screenshot.width, reference.width);
+            const targetHeight = Math.min(screenshot.height, reference.height);
+            const cropped1 = await sharp(screenshotBuffer)
+                .extract({ left: 0, top: 0, width: targetWidth, height: targetHeight })
+                .png()
+                .toBuffer();
+            const cropped2 = await sharp(processedReferenceBuffer)
+                .extract({ left: 0, top: 0, width: targetWidth, height: targetHeight })
+                .png()
+                .toBuffer();
+            img1 = pngjs_1.PNG.sync.read(cropped1);
+            img2 = pngjs_1.PNG.sync.read(cropped2);
+        }
+        else {
+            // "fit" = resize to smaller dimensions, "scale" = resize to larger
+            const targetWidth = resizeStrategy === "scale"
+                ? Math.max(screenshot.width, reference.width)
+                : Math.min(screenshot.width, reference.width);
+            const targetHeight = resizeStrategy === "scale"
+                ? Math.max(screenshot.height, reference.height)
+                : Math.min(screenshot.height, reference.height);
+            const resized1 = await sharp(screenshotBuffer)
+                .resize(targetWidth, targetHeight, { fit: "fill" })
+                .png()
+                .toBuffer();
+            const resized2 = await sharp(processedReferenceBuffer)
+                .resize(targetWidth, targetHeight, { fit: "fill" })
+                .png()
+                .toBuffer();
+            img1 = pngjs_1.PNG.sync.read(resized1);
+            img2 = pngjs_1.PNG.sync.read(resized2);
+        }
+    }
+    // Create diff image
+    const { width, height } = img1;
+    const diff = new pngjs_1.PNG({ width, height });
+    // Run pixel comparison
+    const diffPixels = (0, pixelmatch_1.default)(img1.data, img2.data, diff.data, width, height, {
+        threshold,
+        includeAA: false, // Ignore anti-aliasing differences
+    });
+    const totalPixels = width * height;
+    const similarity = 1 - diffPixels / totalPixels;
+    // Save diff image
+    const diffImagePath = `/tmp/devlens-diff-${Date.now()}.png`;
+    const diffBuffer = pngjs_1.PNG.sync.write(diff);
+    await (0, promises_1.writeFile)(diffImagePath, diffBuffer);
+    // Generate summary
+    const percentage = (similarity * 100).toFixed(1);
+    let summary;
+    if (similarity >= 0.95) {
+        summary = `Excellent match (${percentage}%). The implementation closely matches the design.`;
+    }
+    else if (similarity >= 0.85) {
+        summary = `Good match (${percentage}%). Minor differences detected — check spacing, colors, or small layout shifts.`;
+    }
+    else if (similarity >= 0.7) {
+        summary = `Partial match (${percentage}%). Noticeable differences — review the diff image for layout or styling issues.`;
+    }
+    else {
+        summary = `Low match (${percentage}%). Significant differences — the layout may need substantial changes.`;
+    }
+    return {
+        similarity,
+        diffPixels,
+        totalPixels,
+        diffImagePath,
+        summary,
+    };
+}
+//# sourceMappingURL=comparator.js.map

package/dist/src/visual/comparator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparator.js","sourceRoot":"","sources":["../../../src/visual/comparator.ts"],"names":[],"mappings":"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"}