bruniai 0.1.4 → 0.1.7

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;AAmDpB;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA4C9B"}

package/dist/compare-images.js

@@ -0,0 +1,84 @@
+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("../../../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;AAyBtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAiE5B"}

package/dist/compare-urls.js

@@ -1,8 +1,20 @@
 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("../../../dist/comparison/core.js");
+    }
+    catch {
+        return await importRuntimeModule("../../../src/comparison/core.js");
+    }
+}
 /**
  * Compare two URLs visually and return analysis results.
  *
@@ -25,11 +37,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 +66,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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAI5B,KAAK,UAAU,mBAAmB,CAAI,YAAoB;IACxD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAM,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,wBAAwB;IACrC,IAAI,CAAC;QACH,OAAO,MAAM,mBAAmB,CAC9B,kCAAkC,CACnC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,mBAAmB,CAC9B,iCAAiC,CAClC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAuB;IAEvB,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,GAAG,GAAG,EAAE,GAAG,KAAK,CAAC;IAClD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAE/D,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;SAC7B,CAAC,CAAC;QAEH,0BAA0B;QAC1B,kFAAkF;QAClF,MAAM,MAAM,GACV,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,MAAM;YACtC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC;QAEpC,MAAM,MAAM,GAAsB;YAChC,MAAM;YACN,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"}

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/types.d.ts

@@ -1,4 +1,5 @@
 import type { VisualAnalysisResult } from "../../../dist/vision/types.js";
+import type { ReportStatus } from "../../../dist/reporter/types.js";
 /**
  * Input parameters for compareUrls function.
  */
@@ -13,10 +14,15 @@ export interface CompareUrlsInput {
     prNumber?: string;
     /** Optional repository name for metadata. */
     repository?: string;
-    /** Optional PR title for context. */
-    prTitle?: string;
-    /** Optional PR description for context. */
-    prDescription?: string;
+}
+/**
+ * Input parameters for compareImages function.
+ */
+export interface CompareImagesInput {
+    /** Base/reference image to compare against. Accepts HTTP(S) URLs or data URLs. */
+    baseImage: string;
+    /** Preview/changed image to analyze. Accepts HTTP(S) URLs or data URLs. */
+    previewImage: string;
 }
 /**
  * Image paths returned from comparison.
@@ -39,7 +45,7 @@ export interface ComparisonImages {
  */
 export interface CompareUrlsOutput {
     /** Overall comparison status. */
-    status: "pass" | "fail" | "warning" | "none";
+    status: ReportStatus;
     /** Visual analysis result from AI. */
     visual_analysis: VisualAnalysisResult;
     /** Formatted sections analysis text. */
@@ -47,4 +53,8 @@ export interface CompareUrlsOutput {
     /** Generated images from comparison. */
     images: ComparisonImages;
 }
+/**
+ * Output structure for compareImages function.
+ */
+export type CompareImagesOutput = CompareUrlsOutput;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+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,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7C,sCAAsC;IACtC,eAAe,EAAE,oBAAoB,CAAC;IACtC,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+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,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,sCAAsC;IACtC,eAAe,EAAE,oBAAoB,CAAC;IACtC,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bruniai",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "type": "module",
   "description": "AI-powered visual regression testing tool - core comparison library",
   "author": "Joao Garin",