bruniai 0.1.4 → 0.1.8

package/README.md

@@ -13,7 +13,7 @@ npm install bruniai
 ## Usage
 
 ```typescript
-import { compareUrls } from "bruniai";
+import { compareImages, compareUrls } from "bruniai";
 
 const result = await compareUrls({
   baseUrl: "https://example.com",
@@ -24,6 +24,13 @@ const result = await compareUrls({
 console.log(result.status); // "pass" | "fail" | "warning"
 console.log(result.visual_analysis);
 console.log(result.images.base_screenshot);
+
+const imageResult = await compareImages({
+  baseImage: "https://example.com/design.png",
+  previewImage: "data:image/png;base64,...",
+});
+
+console.log(imageResult.status);
 ```
 
 ## API
@@ -47,6 +54,22 @@ Performs a visual comparison between two URLs.
 - `sections_analysis`: Formatted sections analysis text
 - `images`: Object containing paths to generated screenshots and diff images
 
+### `compareImages(input: CompareImagesInput): Promise<CompareImagesOutput>`
+
+Performs a visual comparison between two images.
+
+**Parameters:**
+
+- `baseImage` (string): Base/reference image as an HTTP(S) URL or `data:image/...`
+- `previewImage` (string): Preview/changed image as an HTTP(S) URL or `data:image/...`
+
+**Returns:**
+
+- `status`: Overall comparison status ("pass" | "fail" | "warning" | "none")
+- `visual_analysis`: Detailed visual analysis result from AI
+- `sections_analysis`: Formatted sections analysis text
+- `images`: Object containing paths to normalized images and diff images
+
 ## Requirements
 
 - Node.js 18+

package/dist/compare-images.d.ts

@@ -0,0 +1,16 @@
+import type { CompareImagesInput, CompareImagesOutput } from "./types.js";
+/**
+ * Compare two images visually and return analysis results.
+ *
+ * This function performs a complete image-native comparison workflow:
+ * - Creates a temporary directory for images
+ * - Normalizes both inputs into PNG images
+ * - Trims margins and generates a diff image
+ * - Matches sections deterministically
+ * - Produces structured analysis output
+ *
+ * @param input - Comparison input parameters
+ * @returns Complete analysis results with image paths
+ */
+export declare function compareImages(input: CompareImagesInput): Promise<CompareImagesOutput>;
+//# sourceMappingURL=compare-images.d.ts.map

package/dist/compare-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-images.d.ts","sourceRoot":"","sources":["../src/compare-images.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAyDpB;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA4C9B"}

package/dist/compare-images.js

@@ -0,0 +1,89 @@
+import { join } from "path";
+import { fileURLToPath } from "url";
+import { mkdirSync, existsSync } from "fs";
+import { tmpdir } from "os";
+async function importRuntimeModule(relativePath) {
+    const modulePath = fileURLToPath(new URL(relativePath, import.meta.url));
+    return (await import(modulePath));
+}
+async function loadImageToImageComparisonModule() {
+    try {
+        return await importRuntimeModule("./runtime/comparison/image-image-core.js");
+    }
+    catch {
+        try {
+            return await importRuntimeModule("../../../dist/comparison/image-image-core.js");
+        }
+        catch {
+            return await importRuntimeModule("../../../src/comparison/image-image-core.js");
+        }
+    }
+}
+function isSupportedImageInput(input) {
+    if (!input) {
+        return false;
+    }
+    if (input.startsWith("data:image/")) {
+        return true;
+    }
+    try {
+        const parsed = new URL(input);
+        return parsed.protocol === "http:" || parsed.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+function assertSupportedImageInput(input, fieldName) {
+    if (!isSupportedImageInput(input)) {
+        throw new Error(`${fieldName} must be an HTTP(S) image URL or data:image/... string`);
+    }
+}
+/**
+ * Compare two images visually and return analysis results.
+ *
+ * This function performs a complete image-native comparison workflow:
+ * - Creates a temporary directory for images
+ * - Normalizes both inputs into PNG images
+ * - Trims margins and generates a diff image
+ * - Matches sections deterministically
+ * - Produces structured analysis output
+ *
+ * @param input - Comparison input parameters
+ * @returns Complete analysis results with image paths
+ */
+export async function compareImages(input) {
+    const { baseImage, previewImage } = input;
+    assertSupportedImageInput(baseImage, "baseImage");
+    assertSupportedImageInput(previewImage, "previewImage");
+    const { performImageToImageComparison } = await loadImageToImageComparisonModule();
+    const imagesDir = join(tmpdir(), `bruniai-${Date.now()}`);
+    if (!existsSync(imagesDir)) {
+        mkdirSync(imagesDir, { recursive: true });
+    }
+    const result = await performImageToImageComparison({
+        baseImageUrl: baseImage,
+        previewImageUrl: previewImage,
+        imagesDir,
+    });
+    const status = result.visual_analysis.status === "none"
+        ? "pass"
+        : result.visual_analysis.status;
+    return {
+        status,
+        visual_analysis: result.visual_analysis,
+        sections_analysis: result.sections_analysis,
+        images: {
+            base_screenshot: result.base_screenshot,
+            preview_screenshot: result.preview_screenshot,
+            diff_image: result.diff_image,
+            section_screenshots: Object.keys(result.section_screenshots).length > 0
+                ? Object.fromEntries(Object.entries(result.section_screenshots).map(([key, value]) => [
+                    key,
+                    { base: value.base, preview: value.preview },
+                ]))
+                : undefined,
+        },
+    };
+}
+//# sourceMappingURL=compare-images.js.map

package/dist/compare-images.js.map

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

package/dist/compare-urls.d.ts

@@ -21,7 +21,7 @@ import type { CompareUrlsInput, CompareUrlsOutput } from "./types.js";
  *   previewUrl: "https://preview.example.com",
  *   page: "/contact"
  * });
- * console.log(result.status); // "pass" | "fail" | "warning" | "none"
+ * console.log(result.status); // "pass" | "fail" | "warning"
  * ```
  */
 export declare function compareUrls(input: CompareUrlsInput): Promise<CompareUrlsOutput>;

package/dist/compare-urls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compare-urls.d.ts","sourceRoot":"","sources":["../src/compare-urls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA4D5B"}
+{"version":3,"file":"compare-urls.d.ts","sourceRoot":"","sources":["../src/compare-urls.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA+BtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAiE5B"}

package/dist/compare-urls.js

@@ -1,8 +1,25 @@
 import { Stagehand } from "@browserbasehq/stagehand";
-import { performComparison } from "../../../dist/comparison/core.js";
 import { join } from "path";
+import { fileURLToPath } from "url";
 import { mkdirSync, existsSync } from "fs";
 import { tmpdir } from "os";
+async function importRuntimeModule(relativePath) {
+    const modulePath = fileURLToPath(new URL(relativePath, import.meta.url));
+    return (await import(modulePath));
+}
+async function loadComparisonCoreModule() {
+    try {
+        return await importRuntimeModule("./runtime/comparison/core.js");
+    }
+    catch {
+        try {
+            return await importRuntimeModule("../../../dist/comparison/core.js");
+        }
+        catch {
+            return await importRuntimeModule("../../../src/comparison/core.js");
+        }
+    }
+}
 /**
  * Compare two URLs visually and return analysis results.
  *
@@ -25,11 +42,12 @@ import { tmpdir } from "os";
  *   previewUrl: "https://preview.example.com",
  *   page: "/contact"
  * });
- * console.log(result.status); // "pass" | "fail" | "warning" | "none"
+ * console.log(result.status); // "pass" | "fail" | "warning"
  * ```
  */
 export async function compareUrls(input) {
     const { baseUrl, previewUrl, page = "/" } = input;
+    const { performComparison } = await loadComparisonCoreModule();
     // Create temporary directory for images.
     const imagesDir = join(tmpdir(), `bruniai-${Date.now()}`);
     if (!existsSync(imagesDir)) {
@@ -53,12 +71,14 @@ export async function compareUrls(input) {
             imagesDir,
             prNumber: input.prNumber,
             repository: input.repository,
-            prTitle: input.prTitle,
-            prDescription: input.prDescription,
         });
         // Build output structure.
+        // Convert status from VisualAnalysisResult (which can be "none") to ReportStatus.
+        const status = result.visual_analysis.status === "none"
+            ? "pass"
+            : result.visual_analysis.status;
         const output = {
-            status: result.visual_analysis.status,
+            status,
             visual_analysis: result.visual_analysis,
             sections_analysis: result.sections_analysis,
             images: {

package/dist/compare-urls.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare-urls.js","sourceRoot":"","sources":["../src/compare-urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAuB;IAEvB,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,GAAG,GAAG,EAAE,GAAG,KAAK,CAAC;IAElD,yCAAyC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,wBAAwB;IACxB,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;QAC9B,GAAG,EAAE,OAAO;QACZ,yBAAyB,EAAE;YACzB,QAAQ,EAAE,IAAI;SACf;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;QAEvB,+BAA+B;QAC/B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;YACrC,SAAS;YACT,OAAO;YACP,UAAU;YACV,IAAI;YACJ,SAAS;YACT,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC,CAAC;QAEH,0BAA0B;QAC1B,MAAM,MAAM,GAAsB;YAChC,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,MAAM;YACrC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,MAAM,EAAE;gBACN,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;gBAC7C,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,mBAAmB,EACjB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,MAAM,GAAG,CAAC;oBAChD,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAC5C,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;wBAChB,GAAG;wBACH,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;qBAC7C,CACF,CACF;oBACH,CAAC,CAAC,SAAS;aAChB;SACF,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC"}
+{"version":3,"file":"compare-urls.js","sourceRoot":"","sources":["../src/compare-urls.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -5,5 +5,6 @@
  * Provides a simple API to compare two URLs and analyze visual differences.
  */
 export { compareUrls } from "./compare-urls.js";
-export type { CompareUrlsInput, CompareUrlsOutput, ComparisonImages, } from "./types.js";
+export { compareImages } from "./compare-images.js";
+export type { CompareImagesInput, CompareImagesOutput, CompareUrlsInput, CompareUrlsOutput, ComparisonImages, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -5,4 +5,5 @@
  * Provides a simple API to compare two URLs and analyze visual differences.
  */
 export { compareUrls } from "./compare-urls.js";
+export { compareImages } from "./compare-images.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime/comparison/core.d.ts

@@ -0,0 +1,59 @@
+import type { Stagehand } from "@browserbasehq/stagehand";
+import type { VisualAnalysisResult } from "../vision/types.js";
+import type { SectionVisualResult } from "../reporter/types.js";
+/**
+ * Options for performing a visual comparison.
+ */
+export interface ComparisonOptions {
+    /** Stagehand instance to use for browser automation. */
+    stagehand: Stagehand;
+    /** Base/reference URL. */
+    baseUrl: string;
+    /** Preview/changed URL. */
+    previewUrl: string;
+    /** Page path to compare (e.g., "/" or "/about"). */
+    page: string;
+    /** Directory where images should be saved. */
+    imagesDir: string;
+    /** Optional PR number for metadata. */
+    prNumber?: string;
+    /** Optional repository name for metadata. */
+    repository?: string;
+}
+/**
+ * Result of a visual comparison.
+ */
+export interface ComparisonResult {
+    /** Visual analysis result from AI. */
+    visual_analysis: VisualAnalysisResult;
+    /** Formatted sections analysis text. */
+    sections_analysis: string;
+    /** Path to base screenshot. */
+    base_screenshot: string;
+    /** Path to preview screenshot. */
+    preview_screenshot: string;
+    /** Path to diff image. */
+    diff_image: string;
+    /** Section screenshots keyed by section ID. */
+    section_screenshots: Record<string, {
+        base: string;
+        preview: string;
+    }>;
+    /** Optional deterministic section-level diff data. */
+    section_results?: SectionVisualResult[];
+}
+/**
+ * Perform visual comparison between two URLs.
+ *
+ * This function performs the core comparison workflow:
+ * 1. Takes screenshots of base and preview URLs
+ * 2. Generates diff image
+ * 3. Analyzes sections structure
+ * 4. Performs visual analysis with AI
+ * 5. Captures section screenshots
+ *
+ * @param options - Comparison options
+ * @returns Complete comparison results with image paths
+ */
+export declare function performComparison(options: ComparisonOptions): Promise<ComparisonResult>;
+//# sourceMappingURL=core.d.ts.map

package/dist/runtime/comparison/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/comparison/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAS1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,SAAS,EAAE,SAAS,CAAC;IACrB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,eAAe,EAAE,oBAAoB,CAAC;IACtC,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,sDAAsD;IACtD,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAqI3B"}

package/dist/runtime/comparison/core.js

@@ -0,0 +1,83 @@
+import { generateDiffImage } from "../diff/diff.js";
+import { analyzeSectionsSideBySide } from "../sections/sections.js";
+import { extractSectionBoundingBoxes, takeSectionScreenshot, } from "../sections/sectionExtraction.js";
+import { analyzeImagesWithVision } from "../vision/index.js";
+import { ensureViewportSize, ensurePageFullyRendered } from "../utils/window.js";
+import { join } from "path";
+import { writeFileSync } from "fs";
+/**
+ * Perform visual comparison between two URLs.
+ *
+ * This function performs the core comparison workflow:
+ * 1. Takes screenshots of base and preview URLs
+ * 2. Generates diff image
+ * 3. Analyzes sections structure
+ * 4. Performs visual analysis with AI
+ * 5. Captures section screenshots
+ *
+ * @param options - Comparison options
+ * @returns Complete comparison results with image paths
+ */
+export async function performComparison(options) {
+    const { stagehand, baseUrl, previewUrl, page, imagesDir, prNumber = "", repository = "", } = options;
+    // Construct full URLs for this page.
+    const fullBaseUrl = baseUrl.replace(/\/$/, "") + page;
+    const fullPreviewUrl = previewUrl.replace(/\/$/, "") + page;
+    // Generate page suffix for file naming.
+    let pageSuffix = page.replace(/\//g, "_");
+    pageSuffix = pageSuffix === "_" ? "home" : pageSuffix;
+    // Get the page and navigate to blank page first to ensure it's ready.
+    const initialPage = stagehand.context.pages()[0];
+    await ensureViewportSize(initialPage, "about:blank");
+    // Ensure viewport is set correctly before navigating and taking screenshot.
+    await ensureViewportSize(initialPage, fullBaseUrl);
+    // Scroll through the page to trigger lazy loading and wait for images.
+    await ensurePageFullyRendered(initialPage);
+    const baseScreenshot = await initialPage.screenshot({
+        fullPage: true,
+    });
+    const baseScreenshotPath = join(imagesDir, `base_screenshot_${pageSuffix}.png`);
+    writeFileSync(baseScreenshotPath, baseScreenshot);
+    // Ensure viewport is set correctly before navigating to preview URL and taking screenshot.
+    await ensureViewportSize(initialPage, fullPreviewUrl);
+    await ensurePageFullyRendered(initialPage);
+    const previewScreenshot = await initialPage.screenshot({
+        fullPage: true,
+    });
+    const previewScreenshotPath = join(imagesDir, `preview_screenshot_${pageSuffix}.png`);
+    writeFileSync(previewScreenshotPath, previewScreenshot);
+    const diffImagePath = join(imagesDir, `diff_${pageSuffix}.png`);
+    await generateDiffImage(baseScreenshotPath, previewScreenshotPath, diffImagePath);
+    // Analyze sections and get formatted analysis output.
+    const sectionsAnalysis = await analyzeSectionsSideBySide(stagehand, fullBaseUrl, fullPreviewUrl);
+    // Extract section bounding boxes with IDs from analysis.
+    const sectionsWithIds = await extractSectionBoundingBoxes(stagehand, fullBaseUrl, sectionsAnalysis);
+    // Capture section screenshots for both base and preview URLs.
+    const sectionScreenshots = {};
+    for (const section of sectionsWithIds) {
+        const sectionId = section.sectionId;
+        // Define section screenshot paths.
+        const baseSectionScreenshot = join(imagesDir, `base_screenshot_${pageSuffix}_section_${sectionId}.png`);
+        const previewSectionScreenshot = join(imagesDir, `preview_screenshot_${pageSuffix}_section_${sectionId}.png`);
+        // Take section screenshots using section IDs and analysis data.
+        const baseSectionSuccess = await takeSectionScreenshot(stagehand, fullBaseUrl, baseSectionScreenshot, sectionId, sectionsAnalysis);
+        const previewSectionSuccess = await takeSectionScreenshot(stagehand, fullPreviewUrl, previewSectionScreenshot, sectionId, sectionsAnalysis);
+        if (baseSectionSuccess && previewSectionSuccess) {
+            sectionScreenshots[sectionId] = {
+                base: baseSectionScreenshot,
+                preview: previewSectionScreenshot,
+            };
+        }
+    }
+    // Perform visual analysis with the sections information.
+    const visualAnalysis = await analyzeImagesWithVision(baseScreenshotPath, previewScreenshotPath, diffImagePath, fullBaseUrl, fullPreviewUrl, prNumber, repository, sectionsAnalysis);
+    return {
+        visual_analysis: visualAnalysis,
+        sections_analysis: sectionsAnalysis,
+        base_screenshot: baseScreenshotPath,
+        preview_screenshot: previewScreenshotPath,
+        diff_image: diffImagePath,
+        section_screenshots: sectionScreenshots,
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/runtime/comparison/core.js.map

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

package/dist/runtime/comparison/figma-core.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Figma-to-URL comparison core functionality.
+ *
+ * This module provides the workflow for comparing Figma prototype
+ * screenshots against live website URLs using visual AI-based section
+ * detection.
+ */
+import type { Stagehand } from "@browserbasehq/stagehand";
+import type { VisualAnalysisResult } from "../vision/types.js";
+/**
+ * Options for performing a Figma-to-URL comparison.
+ */
+export interface FigmaComparisonOptions {
+    /** Stagehand instance to use for browser automation. */
+    stagehand: Stagehand;
+    /** Figma prototype URL (base/reference). */
+    figmaUrl: string;
+    /** Preview/live URL to compare against. */
+    previewUrl: string;
+    /** Page path for the comparison (used for file naming). */
+    page: string;
+    /** Directory where images should be saved. */
+    imagesDir: string;
+    /** Optional PR number for metadata. */
+    prNumber?: string;
+    /** Optional repository name for metadata. */
+    repository?: string;
+}
+/**
+ * Result of a Figma-to-URL comparison.
+ */
+export interface FigmaComparisonResult {
+    /** Visual analysis result from AI. */
+    visual_analysis: VisualAnalysisResult;
+    /** Formatted sections analysis text (AI-detected). */
+    sections_analysis: string;
+    /** Path to Figma screenshot (base). */
+    base_screenshot: string;
+    /** Path to preview URL screenshot. */
+    preview_screenshot: string;
+    /** Path to diff image. */
+    diff_image: string;
+    /** Section screenshots keyed by section ID. */
+    section_screenshots: Record<string, {
+        base: string;
+        preview: string;
+    }>;
+    /** Comparison mode indicator. */
+    mode: "figma-to-url";
+}
+/**
+ * Perform visual comparison between a Figma prototype and a live URL.
+ *
+ * This function performs the Figma-to-URL comparison workflow:
+ * 1. Takes screenshot of Figma prototype (canvas only)
+ * 2. Takes screenshot of preview URL
+ * 3. Generates diff image
+ * 4. Extracts visual sections using AI
+ * 5. Captures section screenshots
+ * 6. Performs visual analysis with AI
+ *
+ * @param options - Figma comparison options.
+ * @returns Complete comparison results with image paths.
+ */
+export declare function performFigmaComparison(options: FigmaComparisonOptions): Promise<FigmaComparisonResult>;
+//# sourceMappingURL=figma-core.d.ts.map

package/dist/runtime/comparison/figma-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-core.d.ts","sourceRoot":"","sources":["../../src/comparison/figma-core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAU1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAK/D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,SAAS,EAAE,SAAS,CAAC;IACrB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,eAAe,EAAE,oBAAoB,CAAC;IACtC,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,iCAAiC;IACjC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAiKhC"}

package/dist/runtime/comparison/figma-core.js

@@ -0,0 +1,116 @@
+/**
+ * Figma-to-URL comparison core functionality.
+ *
+ * This module provides the workflow for comparing Figma prototype
+ * screenshots against live website URLs using visual AI-based section
+ * detection.
+ */
+import { generateDiffImage } from "../diff/diff.js";
+import { screenshotFigmaPrototype, extractVisualSections, formatVisualSectionsAsAnalysis, takeSectionScreenshotsFromVisualBounds, } from "../figma/index.js";
+import { analyzeImagesWithVisionFigmaMode } from "../vision/index.js";
+import { ensureViewportSize } from "../utils/window.js";
+import { join } from "path";
+import { writeFileSync } from "fs";
+import sharp from "sharp";
+/**
+ * Perform visual comparison between a Figma prototype and a live URL.
+ *
+ * This function performs the Figma-to-URL comparison workflow:
+ * 1. Takes screenshot of Figma prototype (canvas only)
+ * 2. Takes screenshot of preview URL
+ * 3. Generates diff image
+ * 4. Extracts visual sections using AI
+ * 5. Captures section screenshots
+ * 6. Performs visual analysis with AI
+ *
+ * @param options - Figma comparison options.
+ * @returns Complete comparison results with image paths.
+ */
+export async function performFigmaComparison(options) {
+    const { stagehand, figmaUrl, previewUrl, page, imagesDir, prNumber = "", repository = "", } = options;
+    console.log(`\n${"=".repeat(50)}\n🎨 Starting Figma-to-URL Comparison\n${"=".repeat(50)}`);
+    console.log(`Figma URL: ${figmaUrl}`);
+    console.log(`Preview URL: ${previewUrl}`);
+    // Generate page suffix for file naming.
+    let pageSuffix = page.replace(/\//g, "_");
+    pageSuffix = pageSuffix === "_" ? "home" : pageSuffix;
+    // Step 1: Take screenshot of Figma prototype.
+    console.log("\n📸 Step 1: Capturing Figma prototype screenshot...");
+    const baseScreenshotPath = join(imagesDir, `base_screenshot_${pageSuffix}.png`);
+    const figmaResult = await screenshotFigmaPrototype(stagehand, figmaUrl, baseScreenshotPath);
+    if (!figmaResult.success) {
+        throw new Error(`Failed to capture Figma screenshot: ${figmaResult.error || "Unknown error"}`);
+    }
+    console.log(`Figma screenshot saved: ${baseScreenshotPath}`);
+    console.log(`Canvas bounds: ${JSON.stringify(figmaResult.canvasBounds)}`);
+    // Step 2: Take screenshot of preview URL.
+    console.log("\n📸 Step 2: Capturing preview URL screenshot...");
+    const initialPage = stagehand.context.pages()[0];
+    await ensureViewportSize(initialPage, previewUrl);
+    const previewScreenshot = await initialPage.screenshot({
+        fullPage: true,
+    });
+    const previewScreenshotPath = join(imagesDir, `preview_screenshot_${pageSuffix}.png`);
+    writeFileSync(previewScreenshotPath, previewScreenshot);
+    console.log(`Preview screenshot saved: ${previewScreenshotPath}`);
+    // Step 3: Generate diff image.
+    console.log("\n🔍 Step 3: Generating diff image...");
+    const diffImagePath = join(imagesDir, `diff_${pageSuffix}.png`);
+    await generateDiffImage(baseScreenshotPath, previewScreenshotPath, diffImagePath);
+    console.log(`Diff image saved: ${diffImagePath}`);
+    // Step 4: Extract visual sections from Figma screenshot using AI.
+    console.log("\n🤖 Step 4: Extracting visual sections using AI...");
+    const visualSectionsResult = await extractVisualSections(stagehand, baseScreenshotPath);
+    // Format sections analysis for compatibility with existing workflow.
+    const sectionsAnalysis = formatVisualSectionsAsAnalysis(visualSectionsResult);
+    console.log(`\n${"=".repeat(50)}\n🗺️ Visual Sections Analysis:\n${sectionsAnalysis}\n${"=".repeat(50)}`);
+    // Step 5: Capture section screenshots.
+    console.log("\n📷 Step 5: Capturing section screenshots...");
+    const sectionScreenshots = {};
+    // Take section screenshots from preview URL using visual bounds.
+    const previewSectionScreenshots = await takeSectionScreenshotsFromVisualBounds(stagehand, previewUrl, visualSectionsResult.sections, imagesDir, pageSuffix);
+    // For Figma sections, we use the visual bounds to clip from the base screenshot.
+    for (const section of visualSectionsResult.sections) {
+        const sectionId = section.sectionId;
+        const baseSectionPath = join(imagesDir, `base_screenshot_${pageSuffix}_section_${sectionId}.png`);
+        try {
+            // Crop directly from the stitched base screenshot.
+            // This works even when the section is below the first viewport.
+            const baseSectionScreenshot = await sharp(baseScreenshotPath)
+                .extract({
+                left: Math.max(0, Math.round(section.boundingBox.x)),
+                top: Math.max(0, Math.round(section.boundingBox.y)),
+                width: Math.max(1, Math.round(section.boundingBox.width)),
+                height: Math.max(1, Math.round(section.boundingBox.height)),
+            })
+                .png()
+                .toBuffer();
+            writeFileSync(baseSectionPath, baseSectionScreenshot);
+            // Only add to result if both screenshots exist.
+            if (previewSectionScreenshots[sectionId]) {
+                sectionScreenshots[sectionId] = {
+                    base: baseSectionPath,
+                    preview: previewSectionScreenshots[sectionId],
+                };
+            }
+        }
+        catch (error) {
+            console.warn(`Failed to capture Figma section ${sectionId}: ${error}`);
+        }
+    }
+    console.log(`Captured ${Object.keys(sectionScreenshots).length} section screenshot pairs`);
+    // Step 6: Perform visual analysis with AI (Figma mode - skips URL navigation).
+    console.log("\n🧠 Step 6: Performing visual analysis (Figma mode)...");
+    const visualAnalysis = await analyzeImagesWithVisionFigmaMode(baseScreenshotPath, previewScreenshotPath, diffImagePath, figmaUrl, previewUrl, prNumber, repository, sectionsAnalysis);
+    console.log(`Visual analysis completed: ${visualAnalysis.status}`);
+    return {
+        visual_analysis: visualAnalysis,
+        sections_analysis: sectionsAnalysis,
+        base_screenshot: baseScreenshotPath,
+        preview_screenshot: previewScreenshotPath,
+        diff_image: diffImagePath,
+        section_screenshots: sectionScreenshots,
+        mode: "figma-to-url",
+    };
+}
+//# sourceMappingURL=figma-core.js.map

package/dist/runtime/comparison/figma-core.js.map

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